PortaBilling: User Manual
Contents
1. PORTA Billing100 Installation Proce 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 Meuf s Part Mount following commands are valid here upper or lower case Create 0 Delete M Mount pt Neufs Opts 0 Finish 3 Toggle SoftUpdates Toggle Newfs U Undo A Auto Defaults R Delete Merge e mM Fi or to get more help arrow keys to select isi mM Press A to use the install wizard default layout If you want a custom slice layout the recommended PortaBilling slice set up is e root filesystem 256MB e swap equal to the amount of RAM e usr filesystem 2GB e var filesystem the rest of the available space When finished you should see something similar to the following screen FreeBSD Disklabel Editor Mount i HeHfs Part Mount Size Newfs 2343MB UFS45 Y following commands are valid here upper or lower case Create D Delete M Mount pt Heuf Opts 0 Finish 5 Toggle SoftUpdates Toggle Newfs U Undo A Auto Defaults R Delete Merge mM Fi or to get more help arrow keys to select LA mM eN 32001 DAAC Darma ins All ahte Dacamnsaci G REN AA AO A A em c 2001 2006 PortaOne I nc All rights Reserved www portaone com 14 PORTA Billing100 installation Process Press Q to proceed with the installation Step2. c 2001 2006 PortaOne Inc All rights Reserved www portaone com 18 PORTA Billing 100 Installation Process User and Group Management Add a nen user Login ID UID Group Password john 1443 H ERE Full name Member groups John Doe Smart Call admin Home directory home john Login shell binesh CANCEL Step 15 Time Zone Configuration Having your clock adjusted properly and setting up a time zone correctly are essential for accurate billing Normally people choose the time zone where their server is physically located or which is local to the majority of the system administrators First of all choose whether you want your server clock to be set according to UTC or local time We recommend using local time in which case you should 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 which region you are in PORTA Billing100 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 a And then choose your country select a country Anguilla Antigua and Barbuda Argentina Aruba Bahamas Barbados Belize Bolivia Brazil ple A E e EE Cayman Islands Chile Colombia Costa Rica Cuba Do
3. 10 Choose the Installation Type Next you need to choose the installation type This will determine which packages will be installed on this host If you are installing a dual server configuration it is recommended that you install the master server first Please select installation type from the list below WHo host system this host is a master radius Two host system this host is a slave peb 3 Single host system this host will serve radius and web com Cancel Step 11 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 Chancet Are you SURE 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 installation you will see screens similar to the following nc All FHANTS Reserved WWW DOrtaone com E l LN PORTA Billing100 installation Process Extracting bin into directory 24757504 bytes read from bin dist chunk 87 of 146 a 798 4 KBytes sec Step 12 Network Configuration Choose the Network Interface Choose the primary network interface for your server that is the interface t
4. 001 2006 PortaOne Inc All rights Reserved www portaone com 3 PORTA Billing100 Introduction m Introduction c 2001 2006 PortaOne Inc All rights Reserved www portaone com 4 PORTA Billing100 Introduction PortaBilling runs on most modern UNIX operating systems FreeBSD Linux Sun Solaris etc assuming they are equipped with such basic features as an ANSI C compiler However it might be difficult for an inexperienced system administrator to install and configure the operation system in a way that suits all the requirements and provides the best performance Installing all the pre requisite software libraries Perl modules MySQL server might also be a time consuming task The PortaBilling JumpStart installation CD provides a quick and foolproof way to perform the complete server installation from scratch in less than 15 minutes It contains installation media for FreeBSD 4 9 with all the necessary packages as well as PortaBilling itself The 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 your servers are installed and equipped with all the required hardware namely e Network card e CD ROM in the case of the IDE CD ROM we recomme
5. PORTA ONE PORTA Billing 100 Installation Guide www portaone com PORTA Billing100 PortaBilling Installation Guide Copyright notice amp disclaimers Copyright c 2000 2006 PortaOne Inc All rights reserved PortaBilling100 Installation Guide V 1 7 2 November 2003 Please address your comments and suggestions to Sales D epartment 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 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 PortaOne Representative for a copy All product names mentioned in this ma
6. PreparingtoReboot n Step 18 Check that the System Reboots to a Normal State Step 19 Preparing the 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 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 billing docs Conventions This publication uses the following conventions Commands and keywords are in boldface Terminal sessions console screens or system file names are displayed in fixed width font Caution means reader beware 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 2
7. 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 c 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing100 Installation Process Step 18 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 n2 de 74 f8 756 Be e c4 e9 af G66 565 87 12Za de le 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 24 fa 94 183 16 7f bhe 76 9d Bf a7 37 A6 42 59d root portal smartcall com ELF ldconfig path usr lib usr lib compat usr local lib Dut ldconfig path usr lib aout usr lib compat aout Starting standard daemons inetd cron sshd usbd Initial re i366 initialization onfiguring syscons blanktime Additional ABI support Local package initial
8. create a new partition isk name 5 FDISK Partition Editor ISK Geometry 6322 cyls 16 heads 63 sectors 838868576 sectors 4H95MB size sT End Name PType Desc Subtype Flags 8388576 8388575 6 unused H mM following commands are supported Cin upper or lower case set Drive Geometry C Create Slice DD mode Toggle Size Units 5 set Bootable Wizard mM Undo All Changes 0 Finish Use Entire Disk Delete Slice Change Type Fi or to get more help arrow keys to select c 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing100 installation Process 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 FDISK Partition Editor ISK Geometry 6322 cyls 16 heads 63 sectors 8388576 sectors 4H95MB size ST End Name PType Desc Subtype Flags 6366576 63868575 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 83885761 L OK 1 Cancel eg M Use Enti Delete Slice Toggle Size Units set Bootable Change Type Undo All Changes Finish se Flor 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 isk name 5 FDISK Partitio
9. hrough which the server will communicate with the rest of the Internet including your VoIP gateways or RADIUS servers Your Ethernet network adapter should be on top of the list If not this could mean the adapter you have in your server is not supported by FreeBSD 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 we provide for that purpose If you 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 BRor later version of FreeBsD Lance PCnet CIsolan Novell ME218 NE32 VUL ethernet SLIP interface on device zdev cuaa COM1 PPP interface on device dev cuaal COM1 SLIP interface on device dev cuaal1 COM PPP interface on device dev cuaal COM com Cancel All rigqnts Reserved PORTA Billing100 Step 13 Network Configuration Parameters Now you need to enter the network parameters for your server Press Enter when done Master server installation For the master server the following dialog will appear Network Configuration Host Domain portal smartcall com smMartcall com IPv4d Gateway Name server 1 1 1 1 1 1 2 1 IPv4 Address of the slave host 1 1 1 1681 Configuration fo
10. ization radiusd mysqld radcheck pl Additional TCP options ed Nov 13 41 83 11 PST 2442 FreeBs0 i366 portal smartcall com itty Press Ctrl Alt Del if you need to reboot Step 19 Preparing the 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 e Type shutdown p now e 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 2001 2006 PortaOne Inc All rights Reserved www portaone com 9 4
11. minica Co ph jek e pk e e If there is more than one time zone in the given country you will have to specify the correct one La yine INC Al rignts Reserved WWW DOrtaone COm mm J l J PORTA Billing100 Installation Process Lanada Time Zones Pacific Time west British Columbia Canada Time Zones Confirmation Pacific Time west British Columbia NOTE Always choose the same time zone when installing the master and slave servers c 2001 2006 PortaOne Inc All rights Reserved www portaone com 91 PORTA 4 Billing 100 Step 16 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 1093 L SR 1 hanging local password for root EH password lease enter a password at least 6 characters in length EH password etype new password eN Dni mam inm All mekke Dacam rne AMARA mm pmanma ram c PortaOne I nc All rights Reserved www portaone com a 2 p PORTA Billing100 Installation Process Step 17 Preparing to Reboot Installation is now finished Press Enter when you reach the following screen Once the system begins its reboot process remove the installation CD from the CD ROM Do not forget to enter BIOS again and
12. mpStart installation has started if you see a screen similar to the one below ncompressing done TA loader 1 04 BTs 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 H G murray builder freebsdmall com Tue Oct 84 52 38 POT 20H kernel text 4x2633b1 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 c 2001 2006 PortaOne Inc All rights Reserved www portaone com PORTA Billing100 Installation Process Step 4 Welcome Screen Next the installation process starts First you will see the PortaBilling welcome screen Pre
13. n Editor ISK Geometry 6322 cyls 16 heads 63 sectors 6386576 sectors 4H95MB S1ze 5T End Name PType Desc Subtype Flags Ualue 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 FreeBsSD 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 1650 L OR 1 Cancel mM or to get more help arrow keys to select Slice is already unusedt 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 1 ANA SAC nnn a ma y gt ela DACA ne LAMAMAT mn FAR C ZUUL ZUU0 PortaUne I Nc All rignts Reserved WwWw portaone com PORTA Billing100 Installation Process 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 PortaBilling on your server install a standard MBR no boot manager c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 3
14. nd that you connect it 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 on your server such as network adapter RAID controller etc is supported by the FreeBSD You can check this at the FreeBSD website 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 c 2001 2006 PortaOne Inc All rights Reserved www portaone com 5 PORTA Billing100 Introduction 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 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 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 e 3 disks RAID 1 mirroring on the first two disks with the third one left as a hot spare e 4disk
15. nual are for identification 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 Billing100 PortaBilling Installation Guide Table of contents 1 BUNT ro e e e ME e ee TTT T Hardware and Software Reguiremenis ne 2 Installation Process TRFRrRRTRRFTRTFRRRTRp p pppPFRRTTTTI Stepi Power Up BootOrderSetup Step 2 Insert the CDROM RM RAN Da Step 3 Startofinstallation enne Step 4 Welcome eg lt A A KE MR Step 5 Disk Partitioning OvervieM Step 6 Disk Partitioning Choose D SK Step 7 Disk Partitioning Create Partition ou eee Step 8 Disk Partitioning Boot Manager Step 9 Disk Partitioning Slice Layout Step 10 ChoosethelnstallationType Stepiil Startofinstallation Step 12 Network Configuration Choose the Network Interface Step 13 Network Configuration Parameters Step 14 Add User Accounts into the System Step 15 TimeZoneConfiguration Step 16 Setting upRootPassword Step 17
16. r Interface Inc IPyd Address Netmask 1 1 1 144 235 255 455 H CANCEL Select this if you are happy with these settings Slave server installation Here the dialogs are the same but you need to enter the IP address of the master setver Network Configuration Host Domain porta smartcall com sMartcall com IPv4d Gateway Name server 1 1 1 1 1 1 1 2 IPv4 Address of the master host 1 1 1 144 Configuration for Interface lncH IPu4 Address Netmask 1 1 1 161 235 255 455 H CANCEL Select this if you are happy with these settings PORTA Billing100 Installation Process Single host installation The dialog for a single host installation is similar to the ones above except that you do not need to enter information for master slave server addresses Step 14 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 move to the Cancel button and then press Enter Add a new user to the sustem The dialog for creating a new user is shown below
17. s RAID 1 0 mirroring striping e More than 4 disks RAID 1 0 mirroring striping on the first four disks with the others left as a hot spare c 2001 2006 PortaOne Inc All rights Reserved www portaone com 6 PORTA Billing100 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 received with your PortaBilling installation CD into the USB slot on your master server 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 is first in the list of boot devices If you are installing a dual server configuration start your installation with the 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 Step 2 Insert the CD ROM While rebooting the system insert the PortaBilling 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 c 2001 2006 PortaOne Inc All rights Reserved www portaone com 9 PORTA 4 Billing 100 its boot up process press the Reset button and make sure that you are booting from the CD Step 3 Start of Installation You will know that Ju
18. ss Enter to continue to disk partitioning Step 5 Disk Partitioning Overview Now you must allocate the hard drive partitions where FreeBSD and PortaBilling will be installed If you only have one hard drive in your system or your available disks are configured as a single volume array then skip the next step and go directly to 0 c 2001 2006 PortaOne Inc All rights Reserved www portaone com 1 0 PORTA Billing100 nstallation Process 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 Select Drives 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 will 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 TAB to get to the buttons and leave this menu la adi Cancel I Press FI for important information regarding disk geometry 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
Download Pdf Manuals
Related Search