PortaBilling: User Manual
Contents
1. 18 c 2001 2006 PortaOne Inc All rights Reserved www portaone com 9 PORTA Billing 100 Preface This document provides a general overview of the PortaBilling100 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 occutring 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 resources documentation 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 malfunction or data loss NOTE Notes contain helpful suggestions about or references to materials not contained in this manual Timesaver means that you can save time by performing the action described in the paragraph Tips provide information that 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 Billing 100 Introduction PortaBilling runs on most2. Starting cron Local package initialization radiusd can t open perlAAA so can t open dev uge ng apache mysqld mysqld slave radcheck pl Additional TCP options starting background file system checks in 68 seconds Tue Jul 5 87 51 17 PDT 2005 FreeBSD i386 Cportabox local com ttyv login Press Ctrl Alt Del if you need to reboot Step 17 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 e Wait until the system finishes booting e Log in as root o Type shutdown p now e Wait until either the system powers down on its own or until the message The operating system has halted appears and then power off the server c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 8
3. 6 you will be asked for the slave IP as shown below If you select Master Slave in step 6 you do not see this screen and direct to step 11 Step 11 Network configuration Fill in the desired fields for network configuration in this menu c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 3 PORTA Billing 100 Step 12 06 PortaOne Inc All rights Reserved www portaone com PortaBilling1i 6 MR11 Installation Network Configuration Host name apat 0115 oem Kalot 0 gt 11 O Doma inname I B Interface x Inc lt Cancel gt lt Back gt To set the check boxes for interface and DHCP use the space bar Use the Tab key to move to the other fields If you have multiple interfaces Installation Process set at least one in which the machine is connected to the internet You can leave Alias fields and ifconfig 8 flags empty Time zone configuration Proper adjustment of your clock and time zone s essential to achieving accurate billing Usually people choose the time zone where the server is physically located or the one which s local to a majority of the system administrators PortaBilling1 MR11 Installation Timezone selection Amer ica Tegucigalpa America Thule Amer ica Thunder Bav Amer ica Ti juana Amer ica Toronto America Tortola America Vancouver Amer ica Hhitehorse Amer ica Hinnipeg Amer ica Yakutat lt Cancel gt lt Back gt
4. NOTE Always choose the same time zone when installing the master and slave servers server s time zone as set up during installation should not be changed later as this will affect the CDR data stored in the database In fact this is never necessary since every user of the web interface will see the data in his preferred time 14 PORTA Billing 100 Installation Process Step 13 account Step 14 zone anyway Thus it does not matter at all to your users which time zone is on the server Setting up root password and user Choosing the super user password is very important You will need this to perform system administration or system recovery Choose a password which is difficult to guess or crack Add another user account especially for remote administration lt Next gt Start installation Your confirmation is required before the disk layout is changed and the partitions are reformatted Press Enter to proceed c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 5 PORTA Billing 100 Installation Process PortaBillingi 6 MR11 Installation User confirmation requested To install this software your hard drive will be re partitioned as result some or all data on it may be lost Last Chancet Are you SURE you want continue the installation If you re running this on s disk with data you wish to save then select Cancel to abort the installation Select Next to proceed wi
5. modern UNIX operating systems FreeBSD Linux Sun Solaris etc assuming these are equipped with basic things such as an ANSI C compiler However it might be difficult for an inexperienced system administrator to install and configure the operating system in such a way as to meet all of the requirements and provide the best performance Installing all the prerequisite software libraries Perl modules MySQL server could also be a time consuming task The PortaBilling JumpStart installation CD provides a quick and seamless way to perform a complete server installation from scratch in less than 15 minutes It contains the installation media for FreeBSD 5 4 with all the necessary packages plus PortaBilling itself The installation wizard uses a text mode GUI Use arrow keys to change yout selection Tab to move between fields and Enter to confirm your 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 your servers have been installed and equipped with all the required hardware especially o Network card e CD ROM in the case of an IDE CD ROM it is recommended that it be 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
6. 4VP MX you have to disable the APIC In this case at the above screen select 2 Then it will show you the disabled features and asks to press 1 or enter to proceed Welcome to PortaOne installation program Proceed with PortaBillingi Installation Enable APIC Disable ACPI Escape to the command line prompt for advanced users Reboot Press 1 or Enter to proceed with installation APIC disabled Step 5 Welcome screen After this the installation process begins First you will see the PortaBilling welcome screen c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 0 PORTA Billing 100 Installation Process PortaBillingi MR11 Installation PortaBilling1 MR11 Installation Welcome to the PortaOne installation program This wizard will guide you through the installation process Press Enter to continue Step 6 Choose the installation type Next you will have to choose the installation type This will determine which packages are to be installed on this host If you are installing a dual server configuration it is recommended that you install the master server first PortaBilling1 MR11 Installation PortaBilling1 MR11 Installation Please select installation type Master Slave lt Cancel gt lt Back gt lt Next gt Step 7 Disk partitioning overview Now you will have to allocate the hard drive partitions where FreeBSD and PortaBilling are to be installed If
7. PORTA ONE Porta K Billing 100 MR 1 1 installation Guide www portaone com PORTA Billing 100 Copyright notice amp disclaimers Copyright c 2000 2006 PortaOne Inc All rights reserved PortaBilling100 Installation Guide V 1 11 1 July 2005 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 or otherwise without the prior written permission of PortaOne 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 PortaOne representative for a copy All product names mentioned in this manual are for id
8. entification purposes 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 Billing 100 Table of contents FT ACE A EE A AAA AA A EE A AA EE ANT 3 IE MU OCCT g ARISTON 4 Hardware and software requirements 5 2 Installation Process aaaaavsassssssssssssssnnnnnnaa 7 Step Le Insert Me USB dOnglE aasien oie Tata 8 Step 2 Power up boot order S t UP eeen 8 Step 3 Insert the CD ROM erensernecssie nt ener AA 8 Step 4 Launch the installation process 9 Step 5 Welcome Sl Cff arsucnsnnronnnnimnin nannini 10 Step 6 Choose the installation type 11 Step 8 Disk partitioning choose ISK wc cseeeseeseesesesescseseseseeeee 12 Step 9 Disk partitioning slice layout a aaiaaaaaiaassassssssssssssssasssssaassanaanna 12 Step 10 Enter IP address of Slave Master for stand alone installations a i E E E E E E EE T aa 13 Step 11 Network configuration 13 Step 12 Time zone configuration sni s lasagna enni 14 Step 13 Setting up root password and user account u u u u 15 Step 1 2 Start installationen Hn R TA 15 Step 15 Prepare to reboot aiaiiiaisassassassassassassassassassassassassaasaaaaanaanaa 16 Step 16 Check that the system is able to reboot to a normal state 17 Step 17 Prepare system for transportation optional
9. hardware installed in your server such as network adapter RAID controller etc is supported by FreeBSD You can check this on the FreeBSD website http www freebsd org During installation you will be prompted for network configuration parameters Please determine these before installation consulting your network administrator if necessary It is possible that you will have to c 2001 2006 PortaOne Inc All rights Reserved www portaone com 5 PORTA Billing 100 Introduction perform the installation before the network is available in your office for example while the servers will be located in a server hosting center but you will need to enter the correct data anyway Please have the following ready e Planned hostnames and IP addresses of the master and slave servers e Subnet mask and address of the default gateway e Address of your DNS server If you have a hardware RAID controller available in your system configure the RAID array The recommended configurations depending on the amount of hard drives in the system are as follows 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 6 PORTA Billing 100 Instal
10. lation Process Installation Process c 2001 2006 PortaOne Inc All rights Reserved www portaone com 7 PORTA Billing 100 Installation Process Step 1 Insert the USB dongle Before you start the installation insert the provided USB dongle into one of the available USB ports on your master server It must stay in place the entire time in order to ensure normal system operation Step 2 Power up boot order set up Power up the computer which you plan to use as a server Enter the BIOS set up and make sure that the CD ROM drive s first on the list of boot devices lf you are installing a dual server configuration start your installation with the master server ATAPI CD ROM Drive ER Enter Note This image is only an example The BIOS on your system might look different Save your changes and exit Step 3 Insert the CD ROM While rebooting the system insert the PortaBilling installation CD into the CD ROM drive If you do 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 K Billing 100 Installation Process its boot up process press the Reset button and make sure that you are now booting from the CD Step 4 Launch the installation process First it asks for your clarification to boot from the CD Press any key to boot from CD _ You will know
11. ost rsa kew Your public key has been saved in etc ssh ssh host rsa key pub The key fingerprint is 92 de 74 f8 70 0e eB c4 e9 af 66 65 87 2a 9e 1e root portabox local com creating ssh DSA host key Generating public private dsa key pair Your identification has been saved in etc ssh ssh_host_dsa_key Your public key has been saved in etc ssh ssh host dsa key pub The key fingerprint is df 20 fa 94 e3 16 7f gt be 76 90 6f a7 37 66 02 9d root portal smartcall com ELF ldconfig path usr lib usr lib compat usr local lib a out ldconfig path usr lib aout usr lib compat aout Starting standard daemons inetd cron sshd usbd Initial rc 1386 initialization Configuring syscons blankt ime Additional ABI support Local package initialization radiusd mysqld radcheck pl Additional TCP options Tue Jul 5 7 51 17 POT 2885 FreeBS0 i366 Cportabox local com ttyv login Jj If you have not properly inserted the USB key your authentication will fail and the screen below will be shown PORTA Billing 100 Installation Process ELF ldconfig path lib usr lib usr lib compat _ usr X11R6 1ib usr local lib a out ldconfig path Zusr lib aout usr lib compat aout _7 usr X11Rb6 1ib aout starting usbd starting local daemons Jpdating motd starting ntpd sonfiguring syscons blanktime starting sshd Initial i386 initialization Additional ABI support
12. th installation We can take no responsibility for lost disk contents lt Cancel gt lt Back gt During installation you will see screens similar to the following PortaBillingi MR11 Installation Unpacking base system 32 Installing file x minsys usr share games fortune Step 15 Prepare to reboot Installation is now finished Press Enter when you reach the following screen After the system begins its reboot process remove 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 is the first attempted boot device This ensures a faster reboot when recycling the server PORTA Billing 100 Installation Process PortaBilling1 MR11 Installation Congratulationst The installation has been completed successfully The system will reboot now be sure to remove any floppies CDs DVDs from the drives Please make sure to remove floppies CDs DVDs before rebooting If it hangs up when it starts to reboot please eject the CD and restart the machine Step 16 Check that the system is able to reboot to a normal state It is good to ensure that the system is in a stable state and that it returns to normal operations on reboot without intervention especially if there is no keyboard or other peripherals attached Following a normal reboot the screen should look like this Your identification has been saved in etc ssh ssh h
13. that JumpStart installation has begun if you see a screen similar to the following one CD Loader 1 2 Building the boot loader arguments Looking up BOOT LOADER Found Relocating the loader and the BTE Starting the ET loader BT loader 1 668 BTA version is 1 61 Console internal video keyboard BIOS CO is cd BIOS drive A is disk BIOS drive C is diski BIOS drive D is disk BIOS 636KB 1269648kB available memory FreeBs0D i366 bootstrap loader Revision 1 1 Croot pre release portaone com Fri Aug 12 12 39 81 UTC 2885 Loading boot defaultsloader conf Now before proceeding any further you will see the following screen c 2001 2006 PortaOne Inc All rights Reserved www portaone com q PORTA K Billing 100 Installation Process Welcome to PortaUne installation program Proceed with PortaBillingi Installation Disable APIC Disable ACPI Escape to the command line prompt for advanced users Reboot Press 1 or Enter to proceed with installation or Space to pause timer 9 _ If you select first choice it will start the installation for many hardware configurations But in some cases with the choice 1 it will gtve you a device mounting error due to some different hardware systems In this case start the installation again and when you see this screen select the option 2 3 or both to enable disable the APIC ACPI features For example if you are installing in a computer with a motherboard ASUS P
14. you only have 6 PortaOne Inc All rights Reserved www portaone com PORTA Billing 100 Installation Process one hard drive in your system or you have configured your available disks as a single volume array go to step 9 directly if not choose the desired disk in step 8 Step 8 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 on the list Note Installation is always performed on a single disk If you want to utilize multiple drives e g install the DB on a separate disk this can be done after installation PortaBillingi 6 MR11 Installation Please select destination drive Please select destination drive d 4696M ATA IDE disk device adi 4896M ATA IDE disk device lt Cancel gt lt Back gt lt Next gt Step 9 Disk partitioning slice layout PortaBillingi MR11 Installation Partitions manager ad 4696M disk Mount point Size MB swap lt Cancel gt lt Back gt PORTA Billing 100 Installation Process You will be prompted to enter slice sizes to hold different file systems or choose the default ones Step 10 Enter IP address of Slave Master for stand alone installations If you are installing a stand alone master or slave you must enter the IP of the other machine For example If you select master in step
Download Pdf Manuals
Related Search