177
D14049.04
JULY 2008
Grey Headline
(continued)
TANDBERG
VIDEO COMMUNICATIONS SERVER
ADMINISTRATOR GUIDE
Introduction
Getting Started
Overview and
Status
System
Configuration
VCS
Configuration
Zones and
Neighbors
Call
Processing
Bandwidth
Control
Firewall
Traversal
Appendices
Applications
Maintenance
Upgrading Software
It is possible to install new releases of the VCS software on your
existing hardware. Software upgrade can be done via the VCS in
one of two ways:
using secure copy (SCP/PSC
•
P)
using the web interface (HTTP/HTTP
•
S)
.
This section describes how both of these methods are used to
perform upgrades.
You can also upgrade the VCS software via TMS. See
the TMS guide for more information.
To upgrade using SCP or PSCP (part of the PuTTY free Telnet/
SSH package) you will need to transfer two files to the VCS:
a text file containing just the 16-character Release Key
•
(not required for dot release upgrades). Ensure there is no
extraneous white space in this file.
the file containing the software image.
•
Once these files have been transferred:
Ensure the VCS is turned on and available over IP.
1.
Upload the release key file using SCP/PSCP to the
2.
/tmp
folder on the system. The target name must be
release-key
, e.g.
scp release-key root@10.0.0.1:/tmp/release-key
or
pscp release-key root@10.0.0.1:/tmp/release-key
Enter the admin password when prompted.
3.
Upload the software image using SCP/PSCP to the
4.
/tmp
folder on the system. The target name must be
/tmp/tandberg-image.tar.gz
, e.g.
scp s42100x30.tar.gz root@10.0.0.1:/tmp/
tandberg-image.tar.gz
or
pscp s42100x30.tar.gz root@10.0.0.1:/tmp/
tandberg-image.tar.gz
Enter the admin password when prompted.
5.
Wait until the software has installed completely. This should
6.
not take more than five minutes.
Log in again and reboot the system.
7.
After about five minutes the system will be ready to use.
Overview
Prerequisites
The upgrade requires you to have:
a valid Release key. This is required for upgrades to a major
•
release, e.g. X2.1 to X3.0; it is not required for dot releases,
e.g. X3.0 to X3.1)
a software image file.
•
Contact your TANDBERG representative for more information on
how to obtain these.
Backing up current configuration
The VCS’s existing configuration will be restored after performing
an upgrade. However, we recommend that you make a backup
of the configuration before upgrading. How you do this will
depend on the version of software currently running.
Versions prior to X3..0
Use the command line interface to log on to the VCS.
1.
Issue the command
2.
xConfiguration
.
Save the resulting output to a file, using cut-and-paste or
3.
some other means provided by your terminal emulator.
To restore your configuration:
Remove the
1.
*c
from in front of each command.
Paste this information back in to the command line interface.
2.
Version X3.0 and above
Backups can be made automatically. See the
Backup and
Restore
section for full details.
!
You must transfer the Release Key file before transferring
the software image.
!
You must name the files exactly as described above.
Upgrading Using SCP/PSCP
Installing and Restarting
Upgrading software is a two-stage process. Firstly, the new
software image is uploaded onto the VCS. At the same time,
the current configuration of the system is recorded, so that this
can be restored after the upgrade. During this initial stage the
system will continue running on its existing software version,
and all normal system processes will continue.
The second part of the upgrade involves restarting the system.
It is only during the restart that the VCS installs the new
software version and restores the previous configuration.
This means that you can upload the new software to your
system at any time, and then wait until a convenient moment
(for example, when no calls are taking place) to install the new
version by rebooting the system. However, this also means
that any configuration changes made between the upload and
the reboot will be lost once the system restarts using the new
software version.
Upgrading and Option Keys
All existing option keys will be retained through the upgrade from
one version of software to the next, including upgrades to the
next major release. However, we recommend that you take note
of your existing option keys before performing the upgrade.
New features may also become available with each major
release of VCS software, and you may need to install new
option keys if you wish to take advantage of these new features.
Contact your TANDBERG representative for more information on
all the options available for the latest release of VCS software.
For specific information about upgrading and
downgrading for Peers in a cluster, refer to the
Upgrades
and Downgrades
section of the clustering chapter.
!
For security reasons we recommend that you change the
admin password after upgrading to X3.0.
