DO NOT SHARE THESE DOCS WITH CUSTOMERS!
This is an LA release that will only be provided to a select number of PLM-sanctioned customers (PDFs only). Contact PLM for details.
In this section:
Use this section to upload application and license files to the SBC.
The File Upload tool allows you to upload application files to SBC. These files must be available in your local drive for easy access and faster upload. You can upload the following files:
File Types | File Extensions | Description |
---|---|---|
SBC Application Files |
| Use the SBC Application files to upgrade or perform a fresh SBC installation. Note: The SBC does not support EMA upload of .qcow2 files for an upgrade or installation. |
SBC Configuration Files |
| SBC configuration files |
SBC Back-up Files | .tar.gz | Backup files that are uploaded to the SBC from an external source |
License Files | .xml | List of SBC Licenses |
Announcement Files | .wav | Short audio files to use when the SBC sends the 183 Session Progress in a SIP call |
Certificate Files |
|
|
The SBC allows you to upload only the allowed filed types, and also places restrictions on the file names. Such measures are implemented to secure the SBC from malicious file uploads. To know more about the allowed file types and file name restrictions, see the Restrictions on File Properties section.
To know more about uploading announcement files, refer to System Administration - Manage Announcements.
On the SBC main screen, go to Administration > System Administration > File Upload. The File Upload screen is displayed.
File Upload Screen
The File Upload screen consists of the following panes:
By default, only ten entries are displayed in all the panes. You can choose the number of files to view under the Show entries drop-down box.
While uploading large files, EMA may timeout. To prevent EMA from timing out before the file is uploaded, use one of the following ways:
Force Session Timeout
. To disable Force Session Timeout
, refer Users and Application Management - Application Management.To add files to the SBC, perform the following:
Click Add Files to Queue.
Adding Files to Queue Selection
The File Upload window displays.
Browse and select the file for packaging from your local system or remote server.
Adding Files to Queue Screen
Click Open to upload the selected file.
The uploaded files are displayed in the Upload Queue list. The Upload Queue list displays the file name and size for each file that is queued for upload.
File Upload Queue
Click Upload All Files to upload the all files from the Upload Queue list to the SBC.
Do not close the screen or browser until the file upload is complete. Similarly, if you perform any other operations on the EMA, this will abort the file upload.
To abort the uploading process, click the Delete icon against the file which you want to remove. The file uploading process stops.
File Upload Progress
While uploading the file or package:
Once the upload progress reaches 100%, the files gets listed in the Files on SBC pane and the packages get listed in Software Packages on SBC pane. The size of each file and the package is also displayed.
File Upload Installed Package
Proceed to any of the following pages based on your requirement:
To Install SBC 5x10/5400/7000 Application: Installing SBC Application.
To Upgrade SBC 5x10/5400/7000 Application: Upgrading SBC Application using EMA Platform Mode.
To Install SBC 5400 Application: SBC 5400 - Installing Application.
The File Upload window in the EMA navigation path Administration > System Administration > File Upload is enhanced to accept files with very specific properties. This enhancement removes the vulnerability of the SBC and the associated network against uploading and executing malicious files. Upload files with the following properties:
Even if a malicious executable file is bundled in a tar.gz
file with an acceptable file name/properties and is uploaded, the SBC does not executes such files due to mismatch in the sha256 checksum of the uploaded file and the corresponding genuine version.
Do not use multiple dots (".") in the filenames that you upload. The only dots allowed are the ones used for filename extension.
For example, sbc-1.2.3-package.tar.gz
is not allowed, but sbc-1_2_3-package.tar.gz
is allowed.
This rule applies only for files that you customize and upload to the SBC. However, this rule does not apply to the following files provided by Ribbon (filenames provided are only for illustration, and the actual filenames will vary based on the release version):
sbc-V09.02.00-R000.x86_64.sha256
sbc-V09.02.00-R000.x86_64.signature
sbc-V09.02.00-R000.x86_64.tar.gz
sbc-V09.02.00R000-connexip-os_05.00.00-R000_1_amd64.qcow2
Given below are some examples of allowed and disallowed attempts of file uploads:
File with one of the several acceptable extensions:
Example - Allowed File Extension
File with an unacceptable extension:
Example - Disallowed File Extension
Length of filename exceeds 100 characters:
Example - Fiole Name Exceeding 100 Characters
Filename starts with ".":
Example - File Name starts with "."
Filename does not match accepted pattern:
Example: File Name does not Match Acceptable Regex Pattern
To add the Application Back-up files to SBC:
Select the back-up file and click Open to add the file to the queue. The selected file is visible in Upload Queue panel in the File Upload window.
All the back-up files should start with the naming convention:
config_<System_Name>_<File_Name>
, and should end with .tar.gz
or
auto_backup_config_<System_Name>_<File_Name>
, and should end with .tar.gz
For example, config_SBC001_BackupFile1.tar.gz
or auto_backup_config_SBC001_BackupFile1.tar.gz
.
Click Upload All Files to upload all the files listed in the Upload Queue panel to SBC.
The .tar.gz
files gets uploaded to /var/log/sonus/evlog/config
directory of the SBC.
To delete a file from the Upload Queue list, perform the following:
In the Upload Queue list, click
option against the respective file. A delete confirmation dialog appears.Deleting File from File Upload Screen
Click Delete to remove the entry from the Upload Queue pane.
You can delete any entry in the Upload Queue pane before you click Upload All Files.
To delete a file from Files on SBC pane, perform the following:
In the Files on SBC pane, click
option against the respective file. A delete confirmation dialog appears.Deleting File from File Upload Screen
To delete a file from Software Packages on SBC pane, perform the following:
In the Software Packages on SBC pane, click
option against the respective package. A delete confirmation dialog appears.Deleting File from File Upload Screen
Click Delete to remove the package from the Software Packages on SBC pane.
Once the SBC Software Package is removed, there is no way to retrieve the same. You have to re-upload the package.