Mod05 GL Maint
Mod05 GL Maint
20
7-
-0
20
o_
ol
ic
en
Content
_G
do
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
an
rn
1 Services Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Fe
._
2 Alarm Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
_L
EN
3 Log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
00
5 Configuration Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
88
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 1
FN9850FN10FN_TBAZZZAIMHY
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
2 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Preface
Preface
Content of Module • Following sections are dedicated to Maintenance tasks - e.g Backup/Res-
tore, easy troubleshooting and software update.
20
Time • appr. 2,5 hours
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 3
FN9850FN10FN_TBAZZZAIMHY
Preface
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
4 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Services Status
1 Services Status
The services status provides a overview about the SBC‘s main processes and is located on the
„Dashboard“ with the „Services status“ button:
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 5
FN9850FN10FN_TBAZZZAIMHY
Services Status
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
6 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Services Status
20
7-
• Continuous Tracing: Trace application that collects the system logs and traces
-0
and send to an external application.
20
o_
• Cron: Linux open source application that provides time-based job scheduling.
ol
• DBMS: Database Management System application. ic
en
_G
work.
Fe
._
• DNS: Linux open source application that handles Domain Name System, dis-
_L
names to IP addresses.
00
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 7
FN9850FN10FN_TBAZZZAIMHY
Services Status
• RTP Proxy: Open source application that proxies payload from outside to in-
side address and vice-versa (WAN to LAN and LAN to WAN). It runs in Branch
SBC, SBC-Proxy and Centralized SBC modes.
• SIP Server: Application that controls SIP Requests. It can operate as SBC or
Proxy. It's based on openssource Kamailio (former openSER).
• SNMP: Linux open source application that uses Simple Network Management
Protocol to monitor network-attached devices for conditions that warrant ad-
ministrative attention.
• SNORT: Open source Network Intrusion Prevention and Detection System
(NIPS/NIDS).
• SSDP: SSDP is a service tool that provides external connectivity to enterprise
server, for SSDP plug-in configuration and usage please refer to Configura-
20
tion Guide for Service Plug-In.
7-
-0
• SSH: Linux open source application that allows data to be exchanged using a
20
secure channel between two networked devices.
o_
ol
• SSM: SIP Services Module, this application controls some services used in sur-
vivable mode for instance MOH. ic
en
_G
• Syslog: Open source application responsible for system and application logs.
rn
Fe
It provides a rotation mechanism to store logs according to the log level set.
._
• VPN: Open source Virtual Private Network (VPN) application which provides
_L
EN
• Web server: Application used to host and provide access to SBC Homepages
EN
by Web Browsers.
40
88
EN
8 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Alarm Management
2 Alarm Management
The alarm management can be found on the „Maintenance & Diagnostics“ tab under „Alarms.
The overview shows the ammount of alarms for critical, major and minor severity. Click on
„Show alarm details“ for the alarm list:
20
7-
-0
20
o_
ol
ic
en
_G
do
an
The alarm details view shows the current alarms including detailed information:
rn
Fe
._
_L
EN
00
EN
40
88
EN
To delete an alarm, mark it with the „Clear“ column and click on „Clear“. To delete all alarms
click „Clear all“. Previous alarms (when deleted) can be still viewed in the alarm log as de-
scribed in the next chapter.
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 9
FN9850FN10FN_TBAZZZAIMHY
Alarm Management
To clear a single alarm, mark the alarm in the first column and click „Clear“. All alarms can be
clear with „Clear all“. The previous alarms can be shown via the log management (next sec-
tion). The configured alarms are shown on the „Alarms“ menu under „Alarm Settings“:
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
10 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Alarm Management
20
7-
• Trigger shows the condition where the alarm will be generated. Trigger is a
-0
comparison with alarm value.
20
o_
• Severity is the alarm severity assigned to that particular alarm (warning, mi-
ol
nor, major, critical). The Severity is fixed per Fault-Id. ic
en
• Flow Timer indicates the minimal time to wait before to generate a next oc-
_G
are reported to the same trap destination. 0 means that the event is not re-
Fe
• Faulty Object is a character string that defines the object that is at fault. This
EN
value may be different from branch to branch, but it is fixed for a particular
00
branch.
EN
• communications
EN
• environmental
• equipment
• processingError
• qualityOfService
Please note: A full description of all alarms can be found for Unify employees in the intranet
under: http://wiki.dev.global-intra.net/publicwiki/index.php/OSB-Alarms
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 11
FN9850FN10FN_TBAZZZAIMHY
Alarm Management
e.g.:
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
12 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Alarm Management
Alarms can also be sent via SNMP traps to external alarm management systems. The required
MIB file to connect the SBC to a management system is provided together with the OpenScape
SBC software in a file called misc_oss-xx.xx.xx.x.tar.gz.
To add a receiver click on „SNMP Configuration“ under „SNMP“ at the „Alarms“ tab. Click on
„Add“ to add a alarm receiver. Enter the receivers IP, port and the SNMP reporting class 1-7
(as defined in the alarm settings). Multiple classes can be entered comma delimited:
20
7-
-0
20
o_
ol
ic
en
_G
do
The „Blocked“ checkbox can be used to temporarily disable the trap destination.
._
_L
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 13
FN9850FN10FN_TBAZZZAIMHY
Alarm Management
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
14 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Log files
3 Log files
The SBC writes log files containing information on several application or component of the
OpenScape SBC, for example the SIP (Session Initiation Protocol) server log. The log files can
be viewed directly via the SBC‘s local GUI, the CMP as well they can be exported. The log file
management is located in the „Diagnostics & Logs“ menu under „Debugging“ in the „Log View-
er“ section:
20
(see table on
7-
the next page
-0
20
Delete all log files
o_
Open the selected log
ol
ic Delete the log
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 15
FN9850FN10FN_TBAZZZAIMHY
Log files
20
7-
• RTP Proxy: Log of RTP Proxy application.
-0
• SIP Server: SIP stateful proxy or SBC (Session Border Controller) application.
20
o_
• Snort: Log from SNORT (intrusion detection) application.
ol
ic
• SSM: Log of SIP Services Module application.
en
_G
16 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Restart the System
20
7-
-0
20
o_
ol
ic
en
Only available when booted from USB stick
_G
do
interrupted !
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 17
FN9850FN10FN_TBAZZZAIMHY
Restart the System
The installed software loads can be determinated in the „System info“ section:
20
7-
-0
20
o_
ol
ic
en
SW load and partition information for backup (standby)
_G
do
Installed SW release
88
EN
18 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Configuration Management
5 Configuration Management
The entire SBC configuration (DB) is stored in a XML file. Every time when a configuration
change will be saved (by clicking „Apply Changes“), a new configuration file is created and the
old configuration is saved. The configuration files can be managed in the „Maintenance“
menu under „Import/Export“:
20
7-
Currently used file
-0
20
o_
ol
ic This section allows to import
en
or restore a previous
_G
configuration
do
an
rn
Fe
._
Export (Backup)
_L
configuration
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 19
FN9850FN10FN_TBAZZZAIMHY
Export (Backup)
20
7-
-0
20
o_
Please note: The „config_default.xml“ is the con-
ol
figuration provided during installation and in-
ic
en
cludes typically only the main IP configuration /
_G
hostname
do
an
rn
Fe
Or click on „Export all“ to export all configurations files (tar archive). This archive includes all
._
The configuration file can later be imported either manual in a fresh installed SBC to restore
00
this configuration or be used together with the usbstick setup tool to reinstall the device with
EN
the same configuration e.g. for a hardware swap or migration to a virtual system as described
40
20 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Import (Restore)
20
7-
-0
20
o_
ol
ic
en
_G
Or if the configuration was previously exported, it can be re imported from the local PC by
00
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 21
FN9850FN10FN_TBAZZZAIMHY
Backup via CMP
20
7-
-0
20
o_
ol
Archives: ic
manages the „locations“ that can be used to store backup(s).
en
_G
Backup Sets: lists all available restore files for all archives.
do
an
Latest Job Status: used to review the current or previous jobs status.
rn
Fe
._
_L
Restore: opens dialog box that allows user to do DB restore from a previously created ar-
00
chive
EN
40
22 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Backup via CMP
5.3.1 Archives
Archives are locations on which the backups will be stored. This can be a „local“ directory on
the CMP server, a FTP or SFTP server:
20
The „Default“ archive uses the directory /var/siemens/backup on the CMP to store backups.
7-
-0
To add a new location click on „Add...“:
20
o_
ol
ic
en
_G
Server IP or hostname
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 23
FN9850FN10FN_TBAZZZAIMHY
Backup via CMP
20
7-
-0
20
o_
ol
On the following screen make sure that the backup type is set to „Data“ (only possible selec-
ic
en
tion for SBC), mark the SBC(s) in the Backup unit list and click on „Start“ to execute the back-
_G
up:
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
24 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Backup via CMP
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 25
FN9850FN10FN_TBAZZZAIMHY
Backup via CMP
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
On the following screen make sure that the backup type is set to „Data“ (only possible selec-
40
tion for SBC), mark the SBC(s) in the Backup unit list and click on „Next“:
88
EN
26 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Backup via CMP
Enter a name for the backup job, select the Reoccurs (Daily, Weekly, 30 min, 1 h, ...), the back-
up time and the Occurences which allows to schedule a backup job once or multiple times:
20
7-
-0
20
o_
ol
ic
en
_G
If an error occurs during the backup, an alarm is created. The status of the last executed back-
do
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 27
FN9850FN10FN_TBAZZZAIMHY
Backup via CMP
20
7-
2. A list of backups which are stored on this archive will be shows. Select the backup and
-0
click on „Next“ to show the objects included in this backup:
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
3. Mark the SBC which should be restored in the list and click on „Start restore“ to restore
40
88
the backup:
EN
The configuration is restored and the SBC may reboot depending on the changes included in
the configuration file.
28 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Software update
6 Software update
An OpenScape SBC can be upgraded via the following ways:
• Thru the Common Management Portal via the Software Repository
• Via the local GUI using a USB stick, SFTP or HTTPS server
• By exporting the configuration and reinstalling the OpenScape SBC via a USB
stick
20
7-
The currently installed SW version can be obtained in the CMP under Maintenance Inven-
-0
20
tory Applications:
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 29
FN9850FN10FN_TBAZZZAIMHY
Retrieving SW information
In addition, the two buttons „Software Information - Current“ and „Software Information -
Backup“ can be used to determinate which SW load is installed in the currently used as well
in the backup partition:
20
7-
-0
20
o_
ol
ic
en
_G
do
an
Installed SW release
30 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
The upload will be started soon the file has been selected. Click on „Save“ soon all uploads has
been finished.
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 31
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
20
7-
-0
20
o_
ol
ic
en
4. Select the location of the files(s) to be activated in the Location selection list.
_G
• USB stick
._
_L
EN
00
EN
40
88
EN
32 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
5. Select the file version to be activated from the Version selection list. The Image type dis-
played in the Image type column can be Full (Complete file for activation) or Delta (up-
date from the version before).
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
6. Click the Activate... button to activate the software as displayed in the list. The activation
may take some time.
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 33
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
20
7-
Please note: The Software activation - Current sta-
-0
tus window may not be closed until the status
20
"COMPLETED" is displayed in the window.
o_
ol
ic
en
_G
The software is activated at the OpenScape SBC appliance and the Software activation window
rn
is closed.
Fe
._
_L
EN
00
EN
40
88
EN
34 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 35
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
3. Click again on „Add...“ to create a 2nd job. In this job, select the action „Activate“ and the
same target version as used for the upload (transfer) in the previous step. Also here the
activation process can be executed immediately or at a specific time. Last, select on or
multiple SBC‘s on which the SW load should be activated.
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
Click on „OK“ to create the job. The SW activation will be executed at the selected time.
36 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
4. The status indicates when a job has been executed and if any errors have been occurred.
Select the job and click on „View Detailed Status“. The list of selected nodes (SBCs) is
shown with the status of each node:
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
Maintenance 37
FN9850FN10FN_TBAZZZAIMHY
Update via CMP
20
7-
-0
20
o_
ol
ic
en
_G
do
an
rn
Fe
._
_L
EN
00
EN
40
88
EN
38 Maintenance 01.2018
© Unify Software and Solutions GmbH & Co. KG 2018 All rights reserved
FN9850FN10FN_TBAZZZAIMHY