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 as scp.

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

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:
    1. Turn off the existing Alpaca service.
      • # service alpaca-server stop
    2. Perform RPM upgrade
      • rpm -U alpaca-server-ALPACA_VERSION_1.x86_64.rpm
    3. Restart Alpaca service.
      • # service alpaca-server start

Caveats

Upgrading to 8.1.0 from any previous version.
  • In 8.1.0 the configuration that was previously uc-one is now cisco-soft-client. Property files that contain the old uc-one tag will need to be updated.
Upgrading from 7.2.X or earlier to 8.0.0 or higher

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.

Upgrading from 7.0.4 or earlier to 7.1.0 or higher
  • 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/.
Upgrading from 6.6.6 or earlier to 7.0.0 or higher

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:
    1. # cd /tmp
    2. # rpm -U alpaca-server-21sp1-8.0.3-SNAPSHOT_1.x86_64.rpm
Upgrading from version 6.5.3 or earlier.
  • Step: A-1
  • Commands:
    1. Turn off the existing Alpaca service.
      • # service alpaca stop
    2. Remove the Alpaca service script.
      • # rm /etc/init.d/alpaca
    3. Remove the Alpaca symlink in the "/opt" directory if it exists.
      • # rm /opt/alpaca
    4. Install the Alpaca Server RPM
      • # yum install -y alpaca-server-ALPACA_VERSION.x86_64.rpm

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:
    1. Turn off the existing Alpaca service.
      • # service alpaca-remote stop
    2. Perform RPM upgrade
      • rpm -U alpaca-remote-ALPACA_VERSION_1.x86_64.rpm
    3. Restart Alpaca service.
      • # service alpaca-remote start

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.