PortaBilling: User Manual
Contents
1. Terminal sessions console screens system file names are displayed in fixed width font Caution means reader be careful You are capable of doing something that might result in program malfunction or loss of data NOTE Means reader take note Notes contain helpful suggestions or references to materials not contained in this manual Timesaver means the described action saves time You can save time by performing the action described in the paragraph Tips Means the following information might help you solve a problem c 2001 2006 PortaOne Inc All rights Reserved www portaone com 3 PORTA Billing 100 Introduction Introduction c 2001 2006 PortaOne Inc All rights Reserved www portaone com 4 PORTA Billing100 Introduction PortaBilline runs on most of the modern UNIX operating systems FreeBSD Linux Sun Solaris etc assuming they are equipped with basic things such as an ANSI C compiler However it might be difficult for the inexperienced system administrator to install and configure operation system in a way to suit all of the requirements and provide the best performance Installing all pre requisite software libraries Perl modules MySQL server also might be time consuming task The PortaBilling JumpStart installation CD provides a quick and seamless way to perform the complete server installation from scratch in less than 15 minutes It contains installation media for FreeBSD 4 9 with all2. 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 now Choose the first item in the menu and press Enter to go on c 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing1 OO Step 4 Welcome screen After that the installation process starts First you will see PortaBilling welcome screen Welcome to the Porta Billing installation program This wizard will guide you through the rest of installation process 1HH4 Press Enter to continue to disk partitioning Step 5 Choose the installation type DANI DAAC 200 L 2000 PortaOne Inc All rights Reserved www portaone com Next you will have to choose installation type This will determine which packages will be installed on this host If you are installing dual server configuration it is recommended to install master server first Please select installation type from the list below wWo host system this host is a master radius Two host system this host is a slave Heb Single host system this host will serve radius and web 2 3 com E Cancel PORTA Billing100 Installation Process Step 6 Disk partitioning overview Now you will have to allocate the hard drive partitions where FreeBSD and PortaBilling will be installed If you have only one h
3. the necessary packages and PortaBilling itself Installation wizard uses a text mode GUI Use arrow keys to change your selection Tab to move between the fields and Enter to make a choice Hardware and software requirements Recommended configuration e Pentium 4 CPU 2 8 GHz e Motherboard with 533MHz 800MHz system bus support e 1GBofRAM Make sure that you have your servers installed and equipped with all the required hardware notably o Network card e CD ROM in case of the IDE CD ROM it is recommended to have it connected as a slave on the secondary IDE channel e Video adapter monitor keyboard required only during the installation process e At least one disk drive e USB slot on the master server Please check that other hardware installed in your server such as network adapter RAID controller etc is support by the FreeBSD You can check this at the FreeBSD web site http www freebsd org During the installation you will be prompted for parameters of the network configuration Please make a decision on this matter before the installation consult your network administrator if necessary It is possible c 2001 2006 PortaOne Inc All rights Reserved www portaone com 5 PORTA Billing100 Introduction that you will have to perform the installation while network is not yet available for example in your office while servers will be placed in the server hosting center but you need to enter
4. the correct data anyway Please have prepared e Planned hostnames and IP addresses of the master and slave servers e Subnet mask and the address of the default gateway e Address of your DNS server If you have hardware RAID controller available in your system configure the RAID array Recommended configurations depending on the amount of hard drives in the system e 2 disks RAID mirroring o 3 disks RAID 1 mirroring on the first two disks third one left as a hot spare e 4disks RAID 1 0 mirroring striping e More than 4 disks RAID 1 0 mirroring striping on the first four disks others left as a hot spare c 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing 100 Installation Process 2 Installation Process c 2001 2006 PortaOne Inc All rights Reserved www portaone com 7 PORTA Billing100 Installation Process Pre install Place the USB dongle key you have received with your PortaBilling installation CD into the USB slot on your master server Step 1 Power Up boot order set up Powet up the computer which you plan to use as a server Enter the BIOS setup and make sure that CD ROM is first in the list of boot devices If you install dual server configuration start your installation with a master server ATAPI CD ROM Drive Note this image is only an example The BIOS on your system might look different Save your changes and exit Ste
5. the new partition using cursor movement keys and press S Press Q to exit this configuration screen Step 9 Disk partitioning boot manager The FreeBSD boot manager will let you to boot one of the multiple operating systems installed on your server If you are not planning to run anything else than FreeBSD and PortaBilling on your server choose Standard Install Boot Manager for drive ad 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 t ootMgr Install the FreeBSD Boot Manager Standard Install a standard MBR no boot manager one Leave the Master Boot Record untouched K l Cancel Press Fi to read about drive setup PORTA Billing100 Installation Proce Step 10 Disk partitioning slice layout Within the FreeBSD partition you must create areas used to hold different file systems These are called slices FreeBSD Disklabel Editor Size Meuf Part Mount following comma
6. you want continue the installation If you 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 contentst During the installation you will see screens similar to the following Extracting bin into directory 24757504 bytes read from bin dist chunk 8 of 146 798 4 KBytes sec Step 12 Network configuration choose the network interface Choose the primary network interface for you server the interface through which server will communicate with the rest of the Internet including your VoIP gateways or web clients Your Ethernet network adapter should be on the top of the list If it is not there perhaps the adapter you have in your server is not supported by FreeBSD PORTA Billing 100 Installation Process If asked if you wish to use DHCP configuration on the interface answer no Lancer PCnet CIsolan Novell HEZ1BH NHESZ UL ethernet c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 6 PORTA Billing100 Step 13 Network configuration parameters You will need to enter network parameters for your server press Enter when done Master server install For the master server this dialog will appear as follows Network Configuration Host Domain portal smartcall com smMartcall com IPv4d Gateway Name server 1 1
7. 1 1 1 1 2 1 IPv4 Address of the slave host 1 1 1 141 Configuration for Interface Inc IPvd Address Netmask 1 1 1 168 259 299 295 CANCEL Select this if you are happy with these settings Slave server install The dialogs are the same but you will have to enter IP address of the master server Hetuork Configuration Host Domain porta smartcall com smMartcall com IPv4d Gateway Name server 1 1 1 1 1 1 1 2 IPv4 Address of the master host 1 1 1 168 Configuration for Interface lnc IPv4d Address Netmask 1 1 1 141 259 299 295 CANCEL Select this if you are happy with these settings PORTA K Billing100 Installation Process Step 14 Single host install The dialog for the single host install is similar to the ones above but you do not need enter information about master slave server addresses Add user accounts into the system After the required packages have been installed you can begin performing the configuration tasks First you will be required 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 take you to the Cancel button and then press Enter User and grou
8. PORTA ONE Porta Billing 100 MR 9 Installation Guide www portaone com PORTA Billing100 PortaBilling Installation Guide Copyright notice amp disclaimers Copyright c 2000 2006 PortaOne Inc All rights reserved PortaBilling100 Install Guide V 1 9 1 July 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 this 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 of the license agreement It is against the law to copy the software on any other medium except as specifically allowed 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 photocopy recording or 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 that supplied with the product and are incorporated herein by this reference If you can t locate the software license contact your PortaOne Representative for a copy All product nam
9. a country Anguilla Antigua and Barbuda Argentina Aruba Bahamas Barbados Belize Bolivia Brazil 1 2 3 4 5 6 7 8 g it Cayman Islands Chile Colombia Costa Rica Cuba Dominica Co ph ft ff fo com Cancel If there is more than one time zone in the given country you will have to specify the region select a zone which observes the same time az your locality lS 7 Eastern Time Thunder Bay Ontario g Eastern Standard Time Pangnirtung Nunavut 9 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 nidwnest 1 Mountain Time Alberta east British Columbia amp west Saskatchewan 1 Mountain Time central Northwest Territories 1 Mountain Time west Northwest Territories 1 Mountain Standard Time Dawson Creek amp Fort Saint John British Col ARePacific Time west British Columbia 2 Pacific Time south Yukon 2 Pacific Time north Yukon com Cancel Please check the suggested time zone and confirm PORTA Billing100 Installation Process L pes Pacific Time west British Columbia NOTE Always choose the same time zone when installing master and slave server The server time zone set up during the in
10. ard drive in your system or you have configured your available disks into a single volume array then please the next step and go directly to 0 Step 7 Disk partitioning choose disk If you have more than one disk in your system you will have to choose the disk on which you would like to create the FreeBSD partitions If in doubt choose the first disk in the list Step 8 Disk partitioning create partition Now you have to create the partition the continuous area on disk used to store all of the operating system data With the unused entry highlighted press C to create a new partition c 2001 2006 PortaOne Inc All rights Reserved www portaone com 11 PORTA Billing100 Installation Proce isk name 5 FDISK Partition Editor ISK Geometry 6322 cyls 16 heads 63 sectors 8388576 sectors 4H95MB size ST End Name PType Desc Subtype Flags 8388576 8388575 6 unused following commands are supported Cin upper or lower case yn set Drive Geometry C Create Slice Toggle Size Units 3 set Bootable Undo All Changes Finish Use Entire Disk Delete Slice Change Type Fi or to get more help arrow keys to select When prompted for the partition size just press Enter this will allocate all available space on the disk for the FreeBSD Press Q to exit this configuration screen isk name FDISK Partition Editor ISK Geometry 6322 cyls 16 heads 63 sectors 63886576 sec
11. es mentioned in this manual are for identification only and are either trademarks or registered trademarks of their respective owners c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 PORTA Billing100 PortaBilling Installation Guide Table of contents PSS e cece teense acesies asses a a l a 1 ENE OCUIC COIN eoe ee ees HA HINDI TRAA KODU S RA HO AAR AND I SERA HAND VAI O H HS Hardware and software requirements aainaisassassassassassassasnaa 2 ITnstallati n Process n s aan FIN O a l u g N Step 1 Power Up boot order Set Up aiaaiaaiaassassassasssssassassassassaann Step 2 Insert the CD ROM i aiiaaaaaiaaiaasaassassassassassassassassassassaassanaanaanaanaanna Step 3 Start of installation ee ne aren nn Step 4 Welcome screen aiaaiaaiaainainai asnaiasassassassassassaasasnaannanaanaanaai Step 5 Choose the installation type aiaaiaaisasssssassssssssasssssaassanaa Step 6 Disk partitioning 0VerVieW aaiaiaziaaiaassassssassssssssssassassasassaeaas Step 7 Disk partitioning choose disk aiaaiaaiaasssssasssss ssssssssaassanaa Step 8 Disk partitioning Create partition wu cesses Step 9 Disk partitioning boot MANAGE aiaainaiassssssasssssasssanaa Step 10 Disk partitioning slice layout aiaaiaa
12. iassssssssssssssssssasssanaa Step 11 Start of install aaiaiaaiaaasaasasssavsassassassassassassassassasnaasaanaanaanaa Step 12 Network configuration choose the network interface Step 13 Network configuration parameters Step 14 Add user accounts into the system Step 15 Time Zone configuration a aainaisaiaassassassassassassaasnanaannanaa Step 16 Setting UP root password aiaaiaaiaassassasssssassassassssnaasnanaa Step 17 Prepare to reboot aaaiaataacsasassassassasassassasnasnasnannsnannasnanannns Step 18 Check that system is able to reboot to the normal state Step 19 Prepare system for transportation optional c 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing100 PortaBilling Installation Guide Preface This document provides a general overview of the PortaBilling100 Customer Care Staff web interface 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 for enhancements occurring between minor releases The online copy of this guide is always up to date and integrates the latest changes to the product You can access the latest copy of this guide at www portaone com solutions billing docs Conventions This publication uses the following conventions Commands and keywords are in boldface
13. ll com itty Press Ctrl Alt Del if you need to reboot Step 19 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 e Wait until system finishes to boot e Log in as root e Type shutdown p now e Wait until either the system powers down on its own or until the The operating system has halted message appears and then power off the server c 2001 2006 PortaOne Inc All rights Reserved www portaone com 9 4
14. n recycling the server c 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing100 Installation Process Step 18 Check that system is able to reboot to the normal state It is good idea to ensure that the system is in a stable state and that on reboot it returns to normal operation without intervention especially if there will be no keyboard or other peripherals attached The screen after a normal reboot should look like the following 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 private 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 be 76 9d 61 27 37 06 842 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 usbd Initial re i366 initialization onfiguring syscons blankt ime Additional ABI support Local package initialization radiusd mysqld radcheck pl Additional TCP options ed Nov 13 41 83 11 PST 2002 FreeBs0 i366 Cportal smartca
15. nds are valid here upper or lower case Create 0 Delete H Hount pt Neufs Opts Finish 3 Toggle SoftUpdates Toggle Newfs U Undo A Auto Defaults R Delete Merge yn Fi or to get more help arrow keys to select W nn Press A to use install wizard default layout If you wish to have custom slice layout PortaBilling recommended slice set up is e root filesystem 256 MB o swap equal to the amount of RAM e ust filesystem 2GB e var filesystem rest of the available space When finished you should see something similar to the following screen FreeBSD Disklabel Editor Mount i Nenfs Part Mount Size Meuf UFS 5 Y UFS 5 Y following commands are valid here upper or lower case Delete H Hount pt Finish 3 Toggle SoftUpdates Undo A Auto Defaults R Delete Merge Create II Newfs Opts Toggle Newfs U W yn Fi or to get more help arrow keys to select Press Q to proceed with the installation ra WN nA Darana lne All ankhta Dacanmd uAnaAanar AgArHaAARA FANA C 2C 01 2006 PortaOr 1e INC All rigi its Reserved WWW poOl taone com 1 j PORTA Billing100 Installation Process Step 11 Start of install You confirmation is required before disk layout will be changed and 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
16. p 2 Insert the CD ROM While rebooting the system insert the PortaBilling installation CD in the CD ROM drive If you did not insert it soon enough and get a no operation system error or a previously installed operating system starts c 2001 2006 PortaOne Inc All rights Reserved www portaone com 8 PORTA 4 Billing 100 Installation its boot up process then press the Reset button and ensure that you are booting from the CD Step 3 Start of installation You will know that JumpStart installation has started if you see screen similar to the following one ncompressing done BT loader 1 64 BT version is 1 81 onsole internal video keyboard BIOS drive A is disk BIOS drive B is diski IOS drive C is disk BIOS 636kKB 31744kB available memory FreeBs0 i366 bootstrap loader Revision 8 6 murray builder freebsdmall com Tue Oct E 84 52 38 POT 20H kernel text 4x2633b1 After the installation kernel is loaded you will see 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
17. p management The submenus here allow to manipulate user groups and login accounts User Add a new user to the system G Add a new user group to the systenm Com Cancel Configure your user groups and users The dialog for creating a new user is shown below User and Group Management Add a new user Login ID UID Group Password john 1683 B HIHIH HH Full name Member groups John Doe Smart Call admin Login shell binesh Home directory hone john PORTA Billing100 Step 15 Time zone configuration Having you clock adjusted properly and time zone set up correctly is essential to achieve accurate billing Normally people choose the time zone where the server physically located or time zone which is local to majority of the system administrators At first choose if you have your server clock set up to the UTC or local time We recommend using local time so please choose No here Is this machine s CMOS clock set to UTC If it is set to local time or you don t know please choose NO heret Next choose the region you are in select a region Africa America Worth and South Antarctica Arctic Ocean Asia Atlantic Ocean Australia Europe Indian Ocean Pacific Ocean u g m unt Wee C E Cancel And then choose your country 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing100 select
18. stallation should not be changed later since it will affect CDR data stored in the database This is actually never required since every user of the web interface will see data in his preferred time zone anyway so it does not matter at all for your users which time zone is on the server c 2001 2006 PortaOne Inc All rights Reserved www portaone com 24 PORTA K Billing 100 Installation Proce Step 16 Setting up root password Choosing the super user password is very important You will need it to perform system administration or system recovery Choose a password which is difficult to guess or crack Now you must set the system Manager password This is the password you ll use to log in as root 188 o 1 hanging local password for root eH password lease enter a password at least 6 characters in length eH password etype new password a DAAT DAAC Daskafasa Ine All wsmaktka Dac Irme AMANA Raa ARnA PANRA c 2001 2006 PortaOne I nc All rights Reserved www portaone com IN B R A PORTA Billing100 Installation Process Step 17 Prepare to reboot Installation is finished now Press Enter when you reach the following screen After the system begins its reboot process remove installation CD from the CD ROM Do not forget to enter the BIOS again and change priority of boot devices so that the hard drive will be first attempted boot device This ensures a quicker reboot whe
19. tors 4H95MB size sT End Hame PType Desc Subtype Flags 6366576 6366575 6 unused B A Value Required Please specify the size for new FreeBSD slice in blocks or append a trailing M for megabytes e g 24M 83885761 L OK 1 Cancel nn Use Enti Delete Slice Toggle Size Units set Bootable Change Type Undo All Changes Finish ze Fl or to get more help arrow keys to select Slice is already unused When asked about partition type press Enter so partition will be created with the default FreeBSD type Inc All ric A 2001 7246 EC SEDED Zl Q GV U ae Gn PORTA Billing100 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 for 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 1165 L OK 1 Cancel y yn or 7 to get more help arrow keys to select lice is already unused A After the partition has been created make sure it is marked as a bootable partition In order to do this select
Download Pdf Manuals
Related Search