IMG 1010 - Configure GCEMS and Start Linux Services
Related Topics:
IMG 1010 - Downloading System Software
IMG 1010 - Starting ClientView - Overview
Before You Begin:
The IMG 1010 should be unpacked, mounted, and connected power to the GCEMS server. See the manufacturer's instructions for installation procedures.
The GCEMS software must be installed. See IMG 1010 - Installing GCEMS Software.
Acquire IP Addresses for the IMG 1010.
Acquire the MAC address of the IMG from tag on bottom of unit.
Procedure:
Follow these steps to setup the GCEMS Server.
Configure /etc/hosts and /etc/sysconfig/network files on GCEMS server
After installing the IMG and GCEMS software, edit the /etc/hosts file (one time only).
There is an existing entry for localhost mapped to 127.0.0.1. Add an entry before the existing 127.0.0.1 entry with the specific IP address, hostname, and alias for the Linux server.
Example:135.119.36.142 <hostname> localhost
127.0.0.1 localhost.localdomain localhost
Edit the /etc/sysconfig/network file and enter the same hostname that was added in the /etc/hosts file.
Configure DNS on the GCEMS server
Connect to the GCEMS Server.
Login as:
user: excelsw
password: excelswIf a DNS server is needed in your network you will need to configure a DNS server. To configure DNS on GCEMS server follow next few steps.
In the RedHat GUI select System Settings > Network and the following screen below will appear.
Select the DNS tab and enter a hostname for the DNS server in the Hostname field.
Enter Primary and Secondary IP addresses for the primary and secondary DNS servers.
Close the network configuration screen.
Create link to load software from ftp server
The first step is to create a link that conveys what software version is to be loaded and where to get the software load from. This link which is loaded in the ftpBuilds folder works in conjunction with the dhcpd.conf file and aids in the loading of software. There are two ways to create this link. There is a script written that automatically creates the link or there is a manual way where a ln -sf command is entered manually and the link is created. The next few steps below explain both processes.
Scenario 1: Using lnimg (link img) script
Go to the osconfig directory.
/opt/dialogic/common/osconfig (Software 10.5.1+)
/opt/cantata/common/osconfig (Software 10.3.x to 10.5.0)Transfer the script lnimg to /home/excelsw/ftpBuilds.
If GCEMS server was purchased from Sangoma, the lnimg script will already be in the ftpBuilds directory.
From the /home/excelsw/ftpBuilds directory, run the lnimg script
$ ./lnimg
Follow the prompts and enter the version of software to be loaded.
Script will create a link between a common name img1010_id0101.bin (IMG 1010) and/or img1004_id0106.bin (IMG 1004) and the name of the software you would like to load.
Execute an ls -la command to verify the link has been created.
To confirm the link has been created, type:$ls -la
Example response:
lrwxrwxrwx 1 root root 27 Jun 21 09:27 img1010_id0101.bin -> img1010_ver1052123_id0101.bin
lrwxrwxrwx 1 root root 27 Jun 21 09:27 img1004_id0106.bin -> img1004_ver1052123_id0106.bin
Scenario 2: Using ln -sf command. (Manually)
From the /home/excelsw/ftpBuilds directory, enter the command below:
IMG 1010:
ln -sf img1010_ver10525_id0101.bin img1010_id0101.bin
IMG 1004:
ln -sf img1004_ver10525_id01016.bin img1004_id0106.bin
To confirm the link has been created, enter the command:
$ls -la
Example response:
lrwxrwxrwx 1 root root 27 Jun 21 09:27 img1010_id0101.bin -> img1010_ver1052123_id0101.bin
lrwxrwxrwx 1 root root 27 Jun 21 09:27 img1004_id0106.bin -> img1004_ver1052123_id0106.bin
Verify that the link created points to the correct bin file.
Create dhcpd.conf file
As Super User, create the dhcpd.conf file. Run the dhcpd file creation script located in the following directory:
/opt/dialogic/common/osconfig (Software 10.5.1+)
/opt/cantata/common/osconfig (Software 10.3.x to 10.5.0)
# ./xldhcp
To create the Linux default dhcpd.conf file manually, see IMG 1010 - Sample dhcpd.conf.
Enter values when prompted as appropriate for your configuration. You will be prompted for the following information: [factory defaults shown in bold]
Router/Default Gateway IP Address: [192.168.0.1]
Router/Default Gateway Subnet Mask: [255.255.255.0]
Subnet IP Address: (Router/Default Gateway IP Address - 1) [192.168.0.0]
FTP Server IP Address: (This PC IP Address) [192.168.0.100]
How many IMG systems are being configured? [1]
T1 or E1 IMG ( t/ e)? [ t]
CODEC Profile Selection
1 = LBR
2 = LBR + iLBC
3 = LBR + iLBC + wireless
You must have a license for wireless codecs. You must also set host flags accordingly (see IMG 1010 - Vocoder Information)
Enter CODEC profile? [2]
IMG(CTRL0)[1] IP Address: [192.168.0.102]
IMG(CTRL0)[1] MAC Address: (MAC shown on IMG Label) [00:20:1C:xx:xx:xx]
IMG(CTRL1)[1] MAC Address: (MAC shown on IMG Label +1) [00:20:1C:xx:xx:xx+1]
Assign an IP address to the IMG that is on the same subnet as the GCEMS server. Once this IP address is set, the GCEMS will be able to connect to and configure the IMG
The following is the response after all prompts are complete:
dhcpd.conf created with 1 IMG's configured...The file will be created in the /opt/dialogic/common/osconfig directory.
Move the file to the /etc directory
mv dhcpd.conf /etc
Create the ntp.conf file.
As a Super User Create the ntp.conf file. Go to:
/opt/dialogic/common/osconfig (Software 10.5.1+)
/opt/cantata/common/osconfig (Software 10.3.x to 10.5.0)Run the ntp configuration script:
# ./xlntp
Enter IP Address and Subnet mask when prompted as appropriate for your configuration.
Move the ntp file to the /etc directory.
# mv ntp.conf /etc
See IMG 1010 - Sample ntp.conf File
Start the services nfs, vsftpd, dhcpd, and ntp
As a Super User, start all the services and configure them to restart when GCEMS server is rebooted. Enter the following commands to start the nfs server
#/sbin/service nfs start (Start the nfs service) #/sbin/service nfs status (Verify whether nfs is running or not) #/sbin/chkconfig nfs on (Configure nfs service to restart after a reboot of GCEMS) #/sbin/chkconfig nfs --list (Verify that runlevels 3,4 and 5 are all on.) Example: nfs 0:off 1:off 2:on 3:on 4:on 5:on 6:off
Enter the following commands to start vsftpd service
#/sbin/service vsftpd start (Start the vsftpd service) #/sbin/service vsftpd status (Verify whether vsftpd is running or not) #/sbin/chkconfig vsftpd on (Configure vsftpd service to restart after a reboot of GCEMS) #/sbin/chkconfig vsftpd --list (Verify that runlevels 3,4, and 5 are all on.)
Enter the following commands to start dhcpd service
#/sbin/service dhcpd start (Start the dhcpd service) #/sbin/service dhcpd status (Verify whether dhcpd is running or not) #/sbin/chkconfig dhcpd on (Configure dhcpd service to restart after a reboot of GCEMS) #/sbin/chkconfig dhcpd --list (Verify that runlevels 3,4, and 5 are all on.)
Enter the following commands to start ntpd service
#/sbin/service ntpd start (Start the ntpd service) #/sbin/service ntpd status (Verify whether ntpd is running or not) #/sbin/chkconfig ntpd on (Configure ntpd service to restart after a reboot of GCEMS) #/sbin/chkconfig ntpd --list (Verify that runlevels 3,4, and 5 are all on.)
Once these services are running and the IMG software build is available the software can be downloaded. See IMG 1010 - Downloading System Software
CRON Jobs
The GCEMS includes a crontab that manages the GCEMS processes. This crontab runs automatically when the GCEMS is started (StartGCEMS), and stopped when the GCEMS is stopped (StopGCEMS). This file should not be edited.
There is a user crontab where you can add your own cron jobs for such tasks as file management or CDR management. The user cron file is located at:
/opt/dialogic/common/cron/usercron (Software 10.5.1+)
/opt/cantata/common/cron/usercron (Software 10.3.x to 10.5.0)
This crontab runs automatically when the GCEMS is started, and stopped when the GCEMS is stopped.
Verify exports file has been created for NFS functionality
Once the BDN_IMG_EMS_1.0.x.xxx.bin and BDN_IMG_GUI_1.0.x.xxx.bin files have been installed, the /etc/exports file should now appear like the following below. Verify that all the shares displayed below have been created.
[excelsw@jsmith\-linux etc] more exports # # # Added for IMG Switchkit Tue Jun 28 08:31:39 EDT 2011 /opt/dialogic/common/calltracing *(rw,sync,all_squash,anonuid=500,anongid=500) /opt/dialogic/common/treatment/datafiles *(rw,sync,all_squash,anonuid=500,anongid=500) /opt/dialogic/common/config/routing/sending *(rw,sync,all_squash,anonuid=500,anongid=500)