IMG 1010 - SD Card Remote Provisioning

Owned by Kelli Higdon
Last updated: Mar 04, 2024
4 min read

Overview:

This feature provides a means for installing new versions of system software to an IMG located at remote sites with no BOOTP server, by allowing remote access to the SD card on the IMG. The SD Card is a small memory card much like the memory cards used in digital cameras and other devices. The IMG has an SD card slot positioned on the right hand side of the front panel just below the USB port. Prior to software version 10.3.x the only way to access and edit information on the SD Card would have been to physically go to the remote IMG, pull the card out, insert it into an SD Reader, and edit the information on the SD Card. A new feature which has been implemented in software build 10.5.0 provisions the IMG as an FTP server instead of just an FTP client. This will give the user the ability to transfer files to and from the SD Card using the FTP utility. The FTP server functionality is disabled by default and would need to be enabled through ClientView in order for the remote provisioning to work. This procedure covers both the IMG 1010 and IMG 1004. The document is kept generic for that point. If more in depth details specific to IMG 1010 or IMG 1004 are needed, please refer to links below.

The IMG does not support high capacity (SDHC and SDXC) SD cards. 

Related Topics:

IMG 1010 - Downloading System Software Using Boot File on SD Card

IMG 1010 - Downloading System Software from SD Card

IMG 1010 - Distributing System Software Using SD Card

IMG 1010 - Default bootup.cfg

 

IMG 1004 - Downloading System Software Using Boot File on SD Card

IMG 1004 - Downloading System Software from SD Card

IMG 1004 - Distributing System Software Using SD Card

IMG 1004 - Default bootup.cfg

 

Configuring Remote provisioning on SD card:

To use the IMG as an FTP server the SD Card must be inserted into the SD Card socket. The IMG must have system software running on it which was originally loaded through use of the SD Card.

 

  • Within ClientView, under the IMG Physical node, right click and select New FTP Server. Commit This. Below is a screen capture of the FTP Server Pane

  • In order to enable the IMG as an FTP server, select enable in the drop down menu in the "FTP Server" field.

  • If an FTP session is connected to the IMG the "FTP Connection Status" field and the "Remote IP Address" field will update. See screen capture below. Notice the Remote IP address field. This is the IP address of the PC that the user is FTP'ing from.

  • At this point, files can be FTP'd to and from the IMG. Below is an example of using FTP to change the version of software loaded on the SD card
     

Procedure:

  • The following procedure will explain how to change the load on an SD Card and upgrade the IMG software. The procedure will assume that:

  •  

    • SD Card was previously used to load IMG software and the IMG is running with that software.

    • The FTP Server is configured and enabled in ClientView. See Steps 1-4 above
       

  • From a DOS or UNIX prompt

ftp <IP address of IMG>

User: excelsw

Password: excelsw

ftp>

 

FTP Applications such as WinSCP that use SFTP (Secure FTP) or SCP (Secure Copy) will not connect to the IMG. Only the FTP Protocol is supported for transferring the files to the IMG SD Card.

Once logged in you can transfer the new updated IMG software file. Transfer this file as binary.

ftp> dir (dir command will show what is loaded on SD Card)

ftp> bin (Set mode to transfer file as binary)

ftp> hash (enable hash printing)

ftp> put img1010_<software version>_id0101.bin (Transfer times could vary from 2 to 10 minutes depending on server speed, memory size, etc.)

 Verify the software file was successfully transferred by using the dir or ls command.

ftp> dir

Transfer the bootup.cfg file from the IMG with the SD Card to the PC.

ftp> dir (dir command will show what is loaded on SD Card)

ftp> ascii (Set mode to transfer file as ascii)

ftp> get bootup.cfg (Get copy of bootup.cfg from SD Card)

Modify the "file=" line on the bootup.cfg file just transferred. Verify the changes to this file are correct. Below is the line in the bootup.cfg file that will need to be edited.

# System Software Filename

file=img1010_ver1050137_id0101.bin (Change ver1050137 to new software build. Ex: ver1050140)

Before transferring the new bootup.cfg file to the SD rename the existing file on the SD card. This can be accomplished using the rename command in ftp. See Below

ftp> rename bootup.cfg bootup_old.cfg

Transfer the new bootup.cfg file to the IMG. Transfer this file as Ascii text.

ftp> ascii (Set to transfer an ascii text file)

ftp> put bootup.cfg (Transfer will take a few seconds)

  • Once the software is transferred, verify both files were transferred successfully to the SD Card.

  • In order to load latest software into the IMG it must be rebooted. Go to ClientView and under the IMG Physical Node right click and select Clear Software.

  • A box will pop up informing you that "This option could have significant effects on the system. Are you sure you want to clear software" Select YES button.

  • The loading of software through the SD Card will take approximately 4 minutes. Once the software is loaded then GCEMS will configure the IMG.

Return to Documentation Home I Return to Sangoma Support