Page History
| Add_workflow_for_techpubs | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Panel | ||||
|---|---|---|---|---|
In this section:
|
This section provides the information on how to upload application and license files to SBC.
File Upload
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:
SBC Application Files (
.tar.gz, .md5, .qcow2and.signature files): Specifies the SBC Application files. These are used to upgrade or to perform a fresh SBC installation.Info title Note The SBC does not support
.qcow2.md5files for EMA upload, for an upgrade, or installation.- SBC Configuration Files (
.templateand.cli): Specifies the SBC configuration files. - SBC Back-up Files (
.tar.gz): Specifies the back-up files which can be uploaded to SBC from an external source. - License Files (
.pem, .xml,and.p12files): Specifies the list of SBC Licenses. Announcement Files (
.wavfiles): Specifies short audio files used when SBC sends the 183 Session Progress in SIP call.Certificate Files (
.derfiles): Files with .der extension are digital certificate files created in the Distinguished Encoding Rules (DER) format. It contains a binary representation of the certificate, and is commonly used for storing X.509v3 certificates in public key cryptography.Info title Note 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.
Info title Note To know more about uploading announcement files, refer to System Administration - Manage Announcements.
On SBC main screen, go to Administration > System Administration > File Upload. The File Upload screen is displayed.
| Caption | ||||
|---|---|---|---|---|
| ||||
The File Upload screen consists of the following panes:
- Upload Queue: This pane allows you to add files from your desired location and upload the same to SBC.
- Files on SBC: This pane lists all the recently uploaded files to SBC with the size of each file.
- Software Packages on SBC: This pane lists the currently installed/available SBC package along with the size of the package.
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.
To Add and Upload Files on the SBC
| Info | ||
|---|---|---|
| ||
While uploading large files, EMA may timeout. To prevent EMA from timing out before the file is uploaded, use one of the following ways:
|
To add files to the SBC, perform the following:
Click Add Files to Queue.
Caption 0 Figure 1 Adding Files to Queue Selection The File Upload window displays.
Browse and select the file for packaging from your local system or remote server.
Caption 0 Figure 1 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.Caption 0 Figure 1 File Upload Queue Click Upload All Files to upload the all files from the Upload Queue list to the SBC.
Warning title Warning 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.
Info title Note To abort the uploading process, click the Delete icon against the file which you want to remove. The file uploading process stops.
Caption 0 Figure 1 File Upload Progress Info title Note While uploading the file or package:
- The file upload status is shown on the Upload Queue list.
- If there are any errors during an upload, the error message is also displayed on the Upload Queue list.
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.Caption 0 Figure 1 File Upload Installed Package Info title Note Proceed to any of the following pages based on your requirement:
To Install
Application: Installing SBC Application.Spacevars 0 series5 To Upgrade
Application: Upgrading SBC Application using EMA Platform Mode or Upgrading SBC Application Using Platform Manager.Spacevars 0 series5 To Install
Application: SBC 5400 - Installing Application.Spacevars 0 model5
| Anchor | ||||
|---|---|---|---|---|
|
The File Upload window in the EMA navigation path Admistration > 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 the files with the following properties:
- Files with the following extensions, provided they simultaneously satisfy the other criteria mentioned in this bullet list:
xmlwavtemplateclipemp12md5signatureqcow2tar.gzder
- The length of the filename is less than or equal to 100 characters.
- The filename does not start with the "." (period) character.
- The filename matches with certain accepted patterns, as defined in a regular expression implemented internally.
| Info | ||
|---|---|---|
| ||
Even if a malicious executable file is bundled in a |
| Info | ||
|---|---|---|
| ||
Do not use multiple dots (".") in the filenames that you upload. The only dots allowed are the ones used for filename extension. For example, 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 Sonus (filenames provided are only for illustration, and the actual filenames may vary based on the release version):
|
Examples
Given below are some examples of allowed and disallowed attempts of file uploads:
File with one of the several acceptable extensions:
Caption 0 Figure 1 Example - Allowed File Extension File with an unacceptable extension:
Caption 0 Figure 1 Example - Disallowed File Extension Length of filename exceeds 100 characters:
Caption 0 Figure 1 Example - Fiole Name Exceeding 100 Characters Filename starts with ".":
Caption 0 Figure 1 Example - File Name starts with "." Filename does not match accepted pattern:
Caption 0 Figure 1 Example: File Name does not Match Acceptable Regex Pattern
To Add and Upload SBC Application Back-up Files on the SBC
To add the Application Back-up files to SBC:
- Click Add Files to Queue. The File Upload window is displayed providing you an option to choose the desired file the external location.
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.
Note title Caution 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.gzorauto_backup_config_SBC001_BackupFile1.tar.gz.Click Upload All Files to upload all the files listed in the Upload Queue panel to SBC.
Info title Note The
.tar.gzfiles gets uploaded to/var/log/sonus/evlog/configdirectory of the SBC.- Navigate to Administration > System Administration > Backup/Restore. The recently upload back-up file(s) is listed at the top of the list in Last Backup panel.
- Click Yes for the "Backup The Current System?" question. The SBC gets restored to match the back-up file content.
To Delete Files from Upload Queue
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.
Caption 0 Figure 1 Deleting File from File Upload Screen Click Delete to remove the entry from the Upload Queue pane.
Info title Note You can delete any entry in the Upload Queue pane before you click Upload All Files.
To Delete Files from Files on SBC Pane
To delete a file from Files on SBC pane, perform the following:
In the Files on SBC pane, click
Caption 0 Figure 1 Deleting File from File Upload Screen - Click Delete to remove the entry from the Files on SBC pane.
To Delete Software Packages on SBC Pane
To delete a file from Software Packages on SBC pane, perform the following:
In the Software Packages on SBC pane, click
Caption 0 Figure 1 Deleting File from File Upload Screen Click Delete to remove the package from the Software Packages on SBC pane.
Info Once the SBC Software Package is removed, there is no way to retrieve the same. You have to re-upload the package.
| Pagebreak |
|---|
Overview
Content Tools