RedHat/CentOS 7 Alpaca Upgrade
This is an upgrade guide for an existing Alpaca installation.
Assumptions
- An existing installation of Alpaca.
- Credentials to access the Alpaca server as root.
- Working knowledge of
ssh
and file transfer tool such asscp
.
Guide
The guide is split into sections based on the server or machine that the operations should be performed. It is also in chronological order. Performing the steps from top to bottom is the desired procedure.
Local Work Station
- Step: O-1
- Download the Alpaca Server installation RPM. This requires an ECG Portal Account.
- Transfer the downloaded installation package to the Alpaca Server's "/tmp" directory.
- Step: O-2
- Download the Alpaca Remote installation RPM. This requires an ECG Portal Account.
- Transfer the downloaded installation package to the each BroadWorks Application Server's "/tmp" directory.
Alpaca Server
General Upgrade Process
These are the general steps for upgrading Alpaca Server. Please check caveats for specific instructions for the version that you are upgrading to.
- Step: A-1
- Commands:
- Turn off the existing Alpaca service.
- # service alpaca-server stop
- Perform RPM upgrade
- rpm -U alpaca-server-ALPACA_VERSION_1.x86_64.rpm
- Restart Alpaca service.
- # service alpaca-server start
- Turn off the existing Alpaca service.
Caveats
Upgrading to 8.1.0 from any previous version.- In 8.1.0 the configuration that was previously
uc-one
is nowcisco-soft-client
. Property files that contain the olduc-one
tag will need to be updated.
If running Alpaca 7.2.0 or earlier, an incremental upgrade to Alpaca 7.2.1 is required before upgrading to 8.0.0 or higher. After the update to 7.2.1, shut off Alpaca, and then upgrade to Java11 before upgrading to Alpaca 8.0.0 or higher.
If using an existing /plugins
directory for Alpaca. This directory will need to be backed up manually and the plugins
re-added to the Alpaca plugins directory.
- Back up all configuration files in
/opt/alpaca/config/
. - After upgrade, configuration files will be located in
/etc/alpaca/<ALPACA_PACKAGE>/config/
.- The backed up configurations files will need to be copied here.
- After upgrade, log files will be located in
/var/log/alpaca/
.
If running Alpaca 6.6.6 or earlier, an incremental upgrade to Alpaca 6.6.7 is required before upgrading to 7.0.0 or higher.
Upgrading from version 6.6.0 or later.- Step: A-1
- Commands:
- # cd /tmp
- # rpm -U alpaca-server-21sp1-8.0.3-SNAPSHOT_1.x86_64.rpm
- Step: A-1
- Commands:
- Turn off the existing Alpaca service.
- # service alpaca stop
- Remove the Alpaca service script.
- # rm /etc/init.d/alpaca
- Remove the Alpaca symlink in the "/opt" directory if it exists.
- # rm /opt/alpaca
- Install the Alpaca Server RPM
- # yum install -y alpaca-server-ALPACA_VERSION.x86_64.rpm
- Turn off the existing Alpaca service.
Alpaca Remote
General Upgrade Process
These are the general steps for upgrading Alpaca Remote. Please check caveats for specific instructions for the version that you are upgrading to.
- Step: A-1
- Commands:
- Turn off the existing Alpaca service.
- # service alpaca-remote stop
- Perform RPM upgrade
- rpm -U alpaca-remote-ALPACA_VERSION_1.x86_64.rpm
- Restart Alpaca service.
- # service alpaca-remote start
- # service alpaca-remote start
- Turn off the existing Alpaca service.
Caveats
Upgrading from 7.2.0 or earlier to 8.0.0 or higher- The configuration for Alpaca Remote has been updated.
- Back up all configurations files before upgrade.
- Once upgraded, follow the Alpaca Remote Configuration Guide to convert your configuration to the new format.