PortaBilling: User Manual
Contents
1. RADIUS auth port RADIUS number of seconds to wait for reply before retransmission retransmitting a RADIUS request interval RADIUS maximum number of retransmissions retransmission count Note Usually you can just retain the default values for the last 3 parameters RADIUS Configuration RADIUS server RADIUS key 1 1 1 106 topsecret RADIUS auth port RADIUS acct port 1612 1613 RADIUS retransmission interval RADIUS retransmission count CANCEL 1 cae Select this if you are happy with these settings Step 14 MX Domain Configuration You will need to enter the name of the mail exchange MX domain which you plan to use for PortaUM that is the name appearing after d in mail sent to from the PortaUM system You will also have to register this name in the DNS server for your domain c 2002 2006 PortaOne Inc All rights reserved www portaone com 16 Portal UM Installation Process Please enter name of e mail exchange Mx domain for PortaUM e g um supertel conm Jun sHarteall com com 1 Cancel Step 15 Add User Accounts to the System After the required packages have been installed you can begin performing the configuration tasks First you will be require2. a 18 Step 17 Setting up Root PasSsWoOrgd RN 20 Step 18 Prepare to Rebogt n nanas 21 Step 19 Check that the System Reboots to a Normal State 22 Step 20 Prepare System for Transportation Optional 23 3 Cisco AS5300 Gateway Seuup 24 Setting up a Back to Back T1 E1 Connection 25 Other Important Considerations a a a 27 c 2002 2006 PortaOne Inc All rights reserved www portaone com Portal UM PortaUM Installation Preface This document provides a general overview of the PortaUM installation process Where to Get the Latest Version of this Guide The hard copy of this guide is updated at major releases only and does not always contain the latest material on enhancements occurring in between minor releases The online copy of this guide is always up to date integrating the latest changes to the product You can access the latest copy of this guide at www portaone com solutions portaum Conventions This publication uses the following conventions Commands and keywords are given in boldface Terminal sessions console screens or system file names are displayed in fixed width font Caution indicates that the described action might result in program A malfunction or data loss NOTE Notes contain helpful suggestion
3. Porta 4 UM Installation Process Step 10 Start of Installation Your confirmation is required before the disk layout is changed and the partitions reformatted Press Enter to proceed To install this software your hard drive will be re partitioned as result some or all data on it may be lost Last Chance Are you SURE you want continue the installation If wou re running this on a disk with data you wish to save then select No to abort the installation Select Yes to proceed with installation He can take no responsibility for lost disk contents Yes Lo 1 During installation you will see screens similar to the following Extracting bin into directory 4757504 bytes read from bin dist chunk 67 of 146 798 4 KBytes sec Step 11 Network Configuration Choose the Network Interface Choose the primary network interface for your server that is the interface through which the server will communicate with the rest of the Internet including your VoIP gateways or RADIUS servers Your Ethernet ne Inc All rights reserved www portaone com Portal UM network adapter should be on top of the list If not this could mean the adapter you have in your setvet is not supported by FreeBSD Network interface information required If you are using PPP over a serial device as opposed to a direct ethernet connection then you may first need to dial your Internet service Provider using the ppp utility w
4. mode Toggle Size Units 5 set Bootable Wizard m Undo All Changes Finish Use Entire Disk G Delete Slice z Change Type u Fi or to get more help arrow keys to select When prompted for the partition size simply press Enter this will allocate all the available space on the disk for FreeBSD Press Q to exit this configuration screen isk name D FDISK Partition Editor ISK Geometry 6322 cyls 16 heads 63 sectors 8388578 sectors 4H95MB size sT End Hame PType Desc Subtype Flags 8388576 8388575 6 unused H A Value Required Please specify the size for new FreeBSD slice in blocks or append a trailing M for megabytes e g 24M 3885760 L ok 1 Cancel Use Enti DD mode Delete Slice Toggle Size Units set Bootable 1 Wizard m Change Type Undo All Changes Finish Fi or to get more help arrow keys to select Slice is already unused When asked about the partition type press Enter so that the partition is created with the default FreeBSD type a Inc All riqhtc rac e INC All 1 ignts res Portal UM isk name FDISK Partition Editor ISK Geometry 6322 cyls 16 heads 63 sectors 8388576 sectors 4H95MB size sT End Name PType Desc Subtype Flags Value Required Enter type of partition to create Pressing Enter will choose the default a native FreeBSD Slice type 165 You can choose other types 6 for a DOS partition or 131 for a Linux partition fo
5. a 37 86 62 9d root portal smartcall com ELF ldconfig path usr lib usr lib compat usr local lib out ldconfig path usr lib aout usr lib compat aout Starting standard daemons inetd cron sshd uzbd Initial re i366 initialization onfiguring syscons blanktine Additional ABI support Local package initialization radiusd mysqld radcheck pl Additional TCP options ed Nov 13 41 83 11 PST 2082 FreeBs0 1i366 Cportal smartcall com ttyv Press Ctrl Alt Del if you need to reboot Portal UM Installation Process Step 20 Prepare System for Transportation Optional If you need to transport the system to another location e g hosting center or otherwise power down the system safely proceed as follows Wait until the system finishes booting Log in as root Type shutdown p now Wait until either the system powers down on its own or a message reading The operating system has halted appears and then power off the server c 2002 2006 PortaOne I nc All rights reserved www portaone com 93 Porta UM Cisco AS5300 Gateway Setup 3 Cisco AS5300 Gateway Setup Porta UM Cisco AS5300 Gateway Setup Setting up a Back to Back T1 E1 Connection Hardware Setup In order to use the Cisco AS5300 gateway as a media server and VXML platform in the PortaUM system you need to physically loop one or more pairs of T1 or E1 voice ports on it so that these can be used for the PSTN PST
6. British Columbia 2 Pacific Time south Yukon 2 Pacific Time north Yukon com Cancel Please check the suggested time zone and confirm select a zone which observes the same time as your locality ae 7 Eastern Time Thunder Bay Ontario 8 Eastern Standard Time Pangnirtung Nunavut q Eastern Standard Time east Nunavut 1 Eastern Standard Time central Nunavut 1 Central Time Manitoba amp west Ontario 1 Central Time Rainy River amp Fort Frances Ontario Does the abbreviation PST look reasonable No 1 1 Mountain Time west Northwest Territories 1 Mountain Standard Time Dawson Creek amp Fort Saint John British Col AWPacific Time west British Columbia 2 2 Pacific Time south Yukon Pacific Time north Yukon L OK 1 Cancel Step 17 Setting up Root Password Choosing a super user password is very important as you will need it to perform system administration or system recovery Choose a password that is difficult to guess or crack Now you must set the system manager s password This is the password you ll use to log in as root 188 O LJ hanging local password for root PH password lease enter a password at least 6 characters in length eH password etype new password Step 18 Prepare to Reboot Installation is now finished Press Enter when you reach the following screen Once the system begins its reboot process remo
7. Porta UM Installation Process 2 Installation Process c 2002 2006 PortaOne Inc All rights reserved www portaone com 7 Porta UM Installation Process Step 1 Power Up Boot Order Setup Powet up the computer which you plan to use as a server Enter the BIOS setup making sure that the CD ROM 1s first in the list of boot devices If you are installing a dual server configuration start your installation with a master server ATAPI CD ROM Drive fi Enter Note This image is only an example The BIOS on your system might look different Save your changes and exit Step 2 Insert the CD ROM While rebooting the system insert the PortaUM installation CD in the CD ROM drive If you do not insert it quickly enough and get a no Operation system error or a previously installed operating system starts its boot up process press the Reset button and make sure that you are booting from the CD c 2002 2006 PortaOne Inc All rights reserved www portaone com 8 Step 3 Start of Installation You will know that JumpStart installation has started if you see a screen similar to the one below ncompressing done BTA loader 1 44 BTe version is 1 81 onsole internal video keyboard BIOS drive A is disk BIOS drive B is diski BIOS drive C is disk BIOS 636kKB 31744kB available memory FreeBs0 i366 bootstrap loader Revision 4 6 murray builder freebsdmall com Tue Oct 6 BB 52 3B PIT 7447
8. identification purposes only and are either trademarks or registered trademarks of their respective owners c 2002 2006 PortaOne Inc All rights reserved www portaone com 1 Portal UM Table of contents PortaU M Installation Pielace ss N 3 I INfrodguctloli esam 4 Hardware and Software Requirements cece 5 2 Installation Process 7 Step 1 Power Up Boot Order Setup l n n 8 Step 2 Insert the CD ROM nanan 8 Step 3 Start of Installation aa 9 step 4 Welcome Screen asas 9 Step 5 Disk Partitioning OVerview a a 10 Step 6 Disk Partitioning Choose DISK RN 10 Step 7 Disk Partitioning Create Partition 11 Step 8 Disk Partitioning Boot Manager 12 Step 9 Disk Partitioning Slice LayOUt 1 13 Step 10 Start of Installation 14 Step 11 Network Configuration Choose the Network Interface 14 Step 12 Network Configuration Parameters eeeeeerr 15 Step 13 RADIUS configuration Parameters 16 Step 14 MX Domain Configuration a 16 Step 15 Add User Accounts to the System 17 Step 16 Time Zone Configuration
9. set to local time or you don t know please choose NO heret Next choose which region you are in Porta Ba UM Installation Process select a region Africa America Worth and South Antarctica Arctic Ocean Asia Atlantic Ocean Australia Europe Indian Ocean Pacific Ocean 1 g 3 4 5 6 7 8 g B And then choose your country select a countru Anguilla Antigua and Barbuda Argentina Aruba Bahamas Barbados Belize Bolivia Brazil ma oa aa Cayman Islands Chile Colombia Costa Rica Cuba Dominica Co ph If there is more than one time zone in the given country you will have to specify the correct one Portal UM select a zone which observes the same time as your locality m 7 Eastern Time Thunder Bay Ontario 8 Eastern Standard Time Pangnirtung Nunavut g Eastern Standard Time east Nunavut 1 Eastern Standard Time central Nunavut 1 Central Time Manitoba amp west Ontario 1 Central Time Rainy River amp Fort Frances Ontario 1 Central Time west Nunavut 1 Central Standard Time Saskatchewan most locations 1 Central Standard Time Saskatchewan Midnest 1 Mountain Time Alberta east British Columbia amp west Saskatchewan 1 Mountain Time central Northwest Territories 1 Mountain Tine west Northwest Territories 1 Mountain Standard Time Dawson Creek amp Fort Saint John British Col APacific Time west
10. N connection To do this construct one or more RJ 48C cross over cables using the following table T1 E1 CSU DSU Cross Over Pinout From RJ 48C Pin To RJ 48C Pin j j 4 Make sure you count the RJ 48C pins as shown in the illustration below Pe Alternatively you can order ready made ones You can find a number of vendors producing such cables by searching for RJ 48C cross over cable on www google com Once the cable is ready plug it into the designated pair of T1 E1 ports in yout Cisco AS5300 gateway c 2002 2006 PortaOne Inc All rights reserved www portaone com 95 Portal UM Cisco AS5300 Gateway Setup Software Configuration You also have to configure the T1 E1 interfaces The sample configuration below is for T1 adjust the time slots for E1 isdn switch type primary 5ess controller T1 0 framing sf clock source line primary linecode ami pri group timeslots 1 24 Controller T1 1 framing sf clock source line secondary 1 linecode ami pri group tanes lots 1 24 controller Tl 2 framing sf linecode ami pri group timeslots 1 24 Controller IL 3 framing sf linecode ami pri group timeslots 1 24 interface Serial0 23 no ip address isdn switch type primary 5ess isdn protocol emulate network no cdp enable interface Seriall 23 no ip address isdn switch type primary 5ess no cdp enable I interface Serial2 23 no ip address isdn switch type primary 5ess isdn protocol emulate netwo
11. PORTA ONE Porta UM unified messaging Installation Guide www portaone com Portal UM PortaUM Installation Copyright Notice amp Disclaimers Copyright 2000 2006 PortaOne Inc All rights reserved PortaUM Unified Messaging System March 2004 Please address your comments and suggestions to Sales Department PortaOne Inc Suite 400 2963 Glen Drive Coquitlam BC V3B 2P7 Canada Changes may be made periodically to the information in this publication Such changes will be incorporated in new editions of the guide The software described in this document is furnished under a license agreement and may be used or copied only in accordance with the terms thereof It is against the law to copy the software on any other medium except as specifically provided in the license agreement The licensee may make one copy of the software for backup purposes No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopied recorded ot otherwise without the prior written permission of PortaO ne Inc The software license and limited warranty for the accompanying product are set forth in the information packet supplied with the product and are incorporated herein by this reference If you cannot locate the software license contact your PortaO ne representative for a copy All product names mentioned in this manual are for
12. ailable disks are configured as a single volume array then please skip the next step and go directly to 0 Step 6 Disk Partitioning Choose Disk If you have more than one disk in your system you will have to choose which one you would like to create the FreeBSD partitions on If in doubt choose the first disk on the list Please select the drive or drives on which you wish to perform this operation If you are attempting to install a boot partition on a drive other than the first one or have multiple operating systems on your machine you Hill have the option to install a boot Manager later To select a drive use the arrow keys to move to it and press SPACE or CENTER To de select it press it again Use CTAB to get to the buttons and leave this menu BHH mU TU a 1 adi L OR 1 Cancel taOne Inc All ignts reserved WWW portaone CcOo Porta UM Installation Proce Step 7 Disk Partitioning Create Partition Now you need to create the partition that is the continuous area on the disk used to store all the operating system data With the unused entry highlighted press C to create a new partition isk name FDISK Partition Editor ISK Geometry 6322 cyls 16 heads 63 sectors 8388578 sectors 4H95MB sizet 5T End Name PType Desc Subtype Flags 8388576 8388575 6 unused H CI following commands are supported Cin upper or lower case set Drive Geometry C Create Slice DD
13. an allocate 6 8 MB for each user which will be sufficient to store audio messages with a total length of 10 minutes or about 50 fax pages Please make sure that other hardware installed in your server such as network adapter RAID controller etc is supported by the FreeBSD You can check this on the FreeBSD web site http www freebsd org During installation you will be prompted for your network configuration parameters Please decide on this matter before beginning installation consulting your network administrator if necessary While it is possible that you will have to perform installation before the network is available in your office for example while the servers will be located in a server hosting center you will still need to enter the correct data Please have the following ready e IP addresses of master and slave PottaBilling100 servers e IP address of the PortaSIP server e Name of the MX domain designated for the hostname of the machine running PortaUM e Subnet mask and address of the default gateway e Address of your DNS server If a hardware RAID controller is available in your system configure the RAID array Recommended configurations depending on the number of hard drives in the system are as follows e 2 disks RAID mirroring 3 disks RAID 1 mirroring on the first two disks with the third one left as a hot spare c 2002 2006 PortaOne Inc All rights reserved www portaone com 5
14. d to add user accounts to the system Your staff may use these accounts to log in to the system It is not recommended to use the root account when logging in remotely If you plan to add users choose the first menu item and press Enter Once you have finished the user creation process press Tab once to move to the Cancel button and then press Enter The submenus here allow to manipulate user groups and login accounts ser Add a new user to the susten G Add a new user group to the systen Com 1 Cancel The dialog for creating a new user is shown below 2 2006 PortaOne Inc All riahts reserved www pnortaone com Z2 ZUVU0 Forcaune INC Ali rignts reserved Www porcacne com as 4 UVU90 F QI LcI7IIC I TIC All IOHA FeSserved VWVVWVV I UL CI IC COGITI Porta F4 UM Installation Process User and Group Management Add a nen user Login ID UID Group Password john 1BB3 B ERE Full name Member groups John Doe Smart Call admin Home directory home john Login shell binesh CANCEL Step 16 Time Zone Configuration Having your clock adjusted properly and setting up a time zone correctly are essential for accurate billing First of all choose whether you want your setvet clock to be set according to the UTC or local time We recommend using local time in which case you should choose No here Is this machines CMOS clock set to UTC If it is
15. e provide for that purpose If wou re using SLIP over a serial device then the expectation is that you have a HARDWIRED connection You can also install over a parallel port using a special laplink cable to another machine running a fairly recent 2 BR or later version of FreeBsD Lance PCnet CIsolan Novell HE21BB HE32 s Software discard network interface Kk 1 Cancel Press Fi to read network configuration manual 1 Step 12 Network Configuration Parameters Now you need to enter the network parameters for your server Press Enter when done Network Configuration Host Domain portaum smartcall com smartcall com IPv4 Gateway Name server 1 1 1 1 1 1 2 1 IPv4 Address of the slave host IPv4 Address of the PortaSIP 1 1 1 141 1 1 1 1H Configuration for Interface lnc IPvd Address Netmask 1 1 1 145 255 255 255 B CANCEL Select this if you are happy with these settings Porta UM Installation Process Step 13 RADIUS configuration Parameters Parameter RADIUS server RADIUS secret Description IP address of the PB100 master host authentication key for all radius interactions select a password and write it down as you will need to enter it later when adding the PortaSIP node to yout PB100 system number of UDP ports at which your PB100 accepts authorization requests
16. kernel text Bx2833D1 After the installation kernel is loaded you will see the following menu Kernel Configuration Menu Skip kernel configuration and continue with installation start kernel configuration in full screen visual mode start kernel configuration in CLI mode Here you have the chance to go into kernel configuration mode making any changes which may be necessary to properly adjust the kernel to Match your hardware configuration If you are installing FreeBSD for the first time select Visual Mode press Down Arrow then ENTER If you need to do more specialized kernel configuration and are an experienced FreeBSD user select CLI mode If you are that you do not need to configure your kernel then simply press ENTER or U now Choose the first item in the menu and press Enter to go on Step 4 Welcome Screen Next the installation process starts First you will see the PortaUM welcome screen c 2002 2006 PortaOne I nc All rights reserved www portaone com U Porta 4 UM Installation Process Welcome to the PortaUM installation program This program Hill help you to install PortaUM and Hill guide you through the rest of installation process 1BB2 Press Enter to proceed to disk partitioning Step 5 Disk Partitioning Overview Now you must allocate the hard drive partitions where FreeBSD and PortaUM will be installed If you have only one hard drive in your system ot your av
17. nager JELLEM Install a standard MBR no boot manager one Leave the Master Boot Record untouched Kk 1 Cancel Press Fi to read about drive setup 1 Step 9 Disk Partitioning Slice Layout You must create areas for holding different file systems within the FreeBSD partition These areas are called slices FreeBSD Disklabel Editor Size HMeufs Part Mount following commands are valid here upper or lower case Create l Delete H Mount pt Neufs Opts Finish 5 Toggle SoftUpdates Toggle Newfs U Undo Auto Defaults R Delete Merge mn Fi or to get more help arrow keys to select n Press A to use the install wizard default layout If you want a custom slice layout the recommended PortaUM slice set up is e root filesystem 256MB e swap equal to the amount of RAM e ust filesystem 2GB e vat filesystem the rest of the available space When finished you should see something similat to the following screen FreeBSD Disklabel Editor Mount i Henfs Part Mount Size Heufs 23B3MB UF5 5 T following commands are valid here upper or lower case Create 0 Delete H Mount pt Heufs Opts Fimish 5 Toggle SoftUpdates Toggle Newfs U Undo A Auto Defaults R Delete Merge n Fi or to get more help arrow keys to select tn n Press Q to proceed with the installation MC Darana lne A s L mom ser ARAFA mRAr AARnA cam g Ep Wwe
18. o requirements 128M RAM 64M flash E1 or T1 voice ports sufficient number of DSPs IOS 12 3 5a or other from the 12 3 branch AS5300 comes with 4 or 8 T1 El s You will not need more than 4 of them because of DSP resource limitation for AS5300 For T1 configuration maximum voice resource will be 96 and for E1 120 Recommended configuration Server HW e Pentium 4 CPU 3 GHz e Motherboard with 533 MHz system bus support e 512 MB of RAM Make sure that your servers have been properly installed and equipped with all the required hardware namely e Network card c 2002 2006 PortaOne Inc All rights reserved www portaone com 5 Porta M UM Introduction e CD ROM in the case of an IDE CD ROM we recommend that it be connected as a slave on a secondary IDE channel e Video adapter monitor keyboard required only during the installation process e At least one disk drive of sufficient size The size of the drive should be selected based on the anticipated amount of PortaUM users taking the following into consideration o The operating system and all software packages take up about 2GB of disk space o Approx 10 GB should be reserved for system use temporary files operating logs and such o One second of recorded audio takes about 10 kilobytes of disk space O One fax page takes about 120 kilobytes of disk space Therefore if your system is designed to serve for example 10 000 users and has an 80 GB disk you c
19. r example Note If you choose a non FreeBSD partition type it will not be formatted or otherwise prepared it will simply reserve space for you to use another tool such as DOS FORMAT to later format and use the partition EZE L OK 1 Cancel CI or to get more help arrow keys to select Slice is already unused A After the partition has been created make sure it is marked as a bootable partition To do this select the new partition using the cursor movement keys and then press S Press Q to exit this configuration screen Step 8 Disk Partitioning Boot Manager The FreeBSD boot manager will let you boot one of the multiple operating systems installed on your server Choose Standard if you are not planning to run anything other than FreeBSD and PortaUM on your server Install Boot Manager for drive add FreeBsD comes with a boot selector that allows you to easily select between FreeBSD and any other operating systems on your machine at boot time If you have more than one drive and want to boot from the second one the boot selector will also make it possible to do so Climitations in the PC BIOS usually prevent this otherwise If you do not want a boot selector or wish to replace an existing one select standard If you would prefer your Master Boot Record to remain untouched then select None NOTE PC DOS users will almost certainly require None DT MT Install the FreeBSD Boot Ma
20. rk no cdp enable interface Serial3 23 no ip address isdn switch type primary 5ess no cdp enable c 2002 2006 PortaOne Inc All rights reserved www portaone com 96 Porta UM Cisco AS5300 Gateway Setup Other Important Considerations Please ensure that the PortaUM machine and Cisco AS5300 gateway used as a media server and VXML platform have a good network connection between them Ideally they should be located on the same 100 Mbps or 1 000 Mbps LAN segment This is important because the media server needs to load sounds interactively from the PortaUM machine in real time Therefore lossy and or high delay connections between the media server and the PortaUM machine can significantly impair service quality Also it is likely that there will be a significant amount of TCP traffic between the media server and the PortaUM machine which can be quite expensive if they are not co located c 2002 2006 PortaOne I nc All rights reserved www portaone com 97
21. s about or references to materials not contained in this manual x Timesaver means that you can save time by performing the action described in the paraeraph OO Tips provide information that might help you solve a problem c 2002 2006 PortaOne Inc All rights reserved www portaone com 3 Portal UM Introduction Introduction c 2002 2006 PortaOne Inc All rights reserved www portaone com 4 Porta 4 UM Introduction PortaUM runs on most modern UNIX operating systems FreeBSD Linux Sun Solaris etc assuming that these are equipped with such basic components as an ANSI C compiler However it may be difficult for an inexperienced system administrator to install and configure the operating system in such a way that it meets all the requirements and provides the best performance Installing all the pre requisite software libraries Perl modules etc can also be a time consuming task The PortaUM JumpStart installation CD offers a quick and seamless way of performing a complete server installation from scratch in less than 15 minutes It contains the installation media for FreeBSD 4 8 including all the necessary packages plus PortaSIP itself The installation wizard employs a text mode GUI Use the arrow keys to change your selection Tab to move between the fields and Enter to make a choice Hardware and Software Requirements A PortaUM requires a dedicated Cisco AS 5300 5350 Cisc
22. ve the installation CD from the CD ROM Do not forget to enter BIOS again and change the priority of boot devices so that the hard drive will now be the first boot device attempted This ensures faster reboot when recycling the server VM DarkeaNfhnn lne A risks acis nek k rati ii A AANA 2006 PortaOne Inc All rights reserved www portaone com na v F gf I Porta 4 UM installation Process Message Congratulationst Installation completed successfullyt The system will reboot now be sure to remove any floppies COs DVDs from the drives 1BB2 IRK Press enter or space 1 Step 19 Check that the System Reboots to a Normal State It is good idea to make sure that the system is in a stable state and that it returns to normal operations on reboot without the need for any intervention especially if no keyboard or other peripherals are to be attached The screen should look like this after a normal reboot our identification has been saved in etc ssh ssh_host_rsa_key our public key has been saved in etc ssh ssh_host_rsa_key pub he key fingerprint is 92 de 74 f8 78 8e e c4 e9 af 66 65 87 2a 9e 1e root portal smartcall com creating ssh2 DSA host key enerating public priv te dsa key pair our identification has been saved in etc ssh ssh_host_dsa_ key our public key has been saved in etc ssh ssh_host_dsa_key pub he key fingerprint is f 20 fa 94 e3 16 7f gt be 76 90 6f
Download Pdf Manuals
Related Search