Software Install - FTP/DHCP

The procedure below describes how to configure a separate FTP/DHCP Server to download the system software to the IMG 2020. The procedure first sets up a user profile and then creates the directories required. Once the user profile and directories are created, the system software is then downloaded from Dialogic BBS (Bulletin Board System) and transferred into the directory created. A dhcpd.conf file on the FTP/DHCP server tells the IMG 2020 where to go to retrieve the system software and license file.

Once configured, the IMG 2020 boots from the FTP/DHCP Server and retrieves both the IP address of the CTRL 0 interface on the IMG 2020 and the location of the system software and license files. This information is all acquired from the dhcpd.conf file.

When choosing an FTP/DHCP Server, any server that has the required services can be used as the FTP/DHCP Server. If the user already has an FTP/DHCP Server in their network, that server can be used. If the Server with the EMS software was purchased through Sangoma, that server has all the services required so that server could be used as well. It is up to the user to decide which server will be used to download the software.

Open

Create User Profile on FTP/DHCP Server

The FTP/DHCP Server must have a Sangoma profile configured on it. If the server being used for FTP/DHCP was purchased from Sangoma, the Sangoma user profile and associated directories have already been created. Skip to the Download Software from Sangoma BBS (Bulletin Board System) section below if server had been purchased from Dialogic. Follow the next few steps to create the profile.

• Login to the Linux machine as a root user.

• As a root user, create a group labeled dialogic. The example will create a group profile labeled dialogic in /home. Refer to example below.

• Create a user labeled dialogic under the group dialogic.

• Add a password of Dial0gic (Capital D, Zero for o) to the dialogic user just created.

• Verify the group and user got created by entering the following command.

• Using SSH, log into the profile created by entering the appropriate credentials.

Create ftpBuilds Directory

The ftpBuilds directory will store the system software file and license file. Follow procedure below to create the ftpBuilds directory. The server sold through Sangoma will already have the ftpBuilds directory created on it. If the ftpBuilds directory is not already created, it will have to be manually created. Follow the example below to create the ftpBuilds directory.

• Within the /home/dialogic directory created earlier, create a new directory labeled ftpBuilds. Open a terminal window and go to /home/dialogic. Create the ftpBuilds directory as a dialogic user.

Download Software from Sangoma BBS (Bulletin Board System)

The IMG 2020 is shipped without software loaded on it. The latest version of system software can be obtained from the Sangoma BBS (Bulletin Board System) http://excelbbs.sangoma.com.

Transfer System Software to ftpBuilds Directory

To load the system software to the IMG 2020, the bdn2020_ver230xxx_id0201.bin file must first be transferred and then installed. Follow steps below.

• Using SFTP, login to the server using the login credentials created above.

• Transfer the bdn2020_ver230xxx_id0201.bin file acquired from Sangoma BBS (Bulletin Board System) to the /home/dialogic/ftpBuilds directory. When transferring the file, verify it is being transferred using the binary format.

Create Link to System Software File Using ln -sf Command

To simplify the loading process, a common name will be used when loading the system software. This will simplify the process of loading newer builds in the future if required. The common name will be labeled bdn2020_id0201.bin and a link will be created linking the system software file downloaded from Sangoma BBS (Bulletin Board System) to the common name created. Enter the commands below to create the link.

• As a superuser, go to /home/dialogic/ftpBuilds directory. This is the directory that the system software file is loaded. Enter the following command:

• Confirm the link has been created, enter the command:

• Verify the link created, points to the correct binary file for loading.

Load License File

The license file for the IMG 2020 was sent separately by e-mail and should be transferred into the directory that the system software file was loaded. In this example, the license file was loaded into /home/dialogic/ftpBuilds. If loading from a different directory or loading off an SD Card, verify the license file is loaded in correct directory. For more information, refer to Licensing. Below is a screen capture of the license listing in the ftpBuilds directory.

Configure FTP/DHCP Services

Once the user profile and associated directories have been created, the server will now be configured to function as a FTP/DHCP Server for loading the system software and license files. The procedure below will describe setting up to load software.

Create dhcpd.conf File

The Create user profile on FTP/DHCP Server section above configures a user profile and password. The next step is to configure and start the DHCP and FTP Services.

• Create a dhcpd.conf file and load it into the /etc/dhcp directory.

• Once the dhcpd.conf file has been completed, FTP it into the /etc/dhcp directory as a root user. Below is an example of the listing of the dhcpd.conf file after being copied to the FTP/DHCP server.

Start the FTP and DHCP Services

Once the dhcpd.conf file has been created and loaded into its proper location, the FTP and DHCP services will need to be either started or restarted. Follow the procedure below to either start or restart the service.

• Enter the following commands as a root or superuser to start the dhcpd service:

Start the FTP Service

• Enter the following commands to start vsftpd service

Optional Services

The services below are optional depending on the functionality being utilized. Follow procedure below to create/configure any of the services below.

Create the ntp.conf File

The IMG 2020 will need to get its time from a server. To aid in the creation of the ntp.conf file, Dialogic has created a sample ntp.conf file which can be copied, modified for the new network, and loaded into the /etc directory. Refer to the topic Sample ntp.conf file. The sample file can be copied and used as a template when creating this file. Once the ntp.conf file has been created and modified for your network, it can be transferred to the /etc directory as a root user. Below is an example of the listing of the ntp.conf file after being copied to the BootP/FTP server.

Open

• Enter the following commands to start ntpd service.

Refer to the Sample ntp.conf and Configure SNTP topics for more information.

Configure NFS Share (Separate Server)

The IMG 2020 runs an NFS client that can be configured to retrieve files such as call tracing files and log files from an NFS server. The procedures below describes how to configure the server so that the files can be shared between the NFS server and the NFS client (IMG 2020). Follow the instructions below to create each of the shares needed.

• As a superuser, create a directory labeled calltracing under the /opt/dialogic/common directory. This will be the mount point for all the NFS shares that will need to be configured.

• Verify the NFS got loaded into the kernel by entering the following command. If NFS is not returned as displayed in example below, refer to step 3 and then repeat verification.

Below is the response that should be returned

• To load the NFS into the kernel, enter the following command.

• Using vi, edit the /etc/exports file and add the share directory created above. To find the dialogic user id and dialogic group id enter the following command:

• As a superuser, start or restart the NFS service and configure it to restart when server is rebooted. Enter the following commands to start the nfs server

Power On System to Load Software

• Once software is downloaded and links etc have been configured, Power-Up the IMG 2020. The cooling fans within the unit will initially run at full speed and slow down after software is loaded. The LED's on front panel will blink at a set pattern during the software loading process. The table below displays the sequence the LEDs will go through during the loading process.

The loading of software and configuring of network information is now complete. To connect to the IMG 2020, open a web browser and connect. Refer to the Web GUI - Functionality topic for information on how to connect to IMG 2020 through the supported browsers.

Troubleshooting

Below is a list of bulleted items describing what the issues might be if software is not loading. Check each bulleted item in the list below and verify they are not the problem.

• Verify that the firewall is disabled. In some instances, the firewall setting on the server will not allow files to be transferred in or out of the server.

• Verify that DHCP and FTP services are running. Use the commands below to verify.

• Verify that the dhcpd.conf file is correct. A colon or semi-colon in the wrong place could be the issue.

• Verify that the switch bin file is in the correct location (/home/dialogic/ftpBuilds).

• Verify that the link to the switch bin created in /home/dialogic/ftpBuilds is correct.

Diagram

The following illustration shows the transfer of the IMG 2020 system software using FTP from an FTP server to each IMG 2020 with a local BootP Server.