RedHat/CentOS 7/8 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 9.0.0 from any previous version.
  • RabbitMQ is a required part of the Alpaca system for version 9.0.0 and following. Please follow the installation guide to complete the RabbitMQ installation.
  • If using a Highly Available Clustering setup (HA), Alpaca Eureka and Alpaca Gateway will need to be installed. Please follow the installation guide to complete the these installations.
  • There is additional configuration required for connection to Eureka, RabbitMQ, and the optional Amazon S3 bucket support. Please follow the configuration guide and update the /etc/alpaca/server/config/application-prod.yml file accordingly.
  • Note that upgrading to Alpaca 9.0.0 will remove any Recurring (scheduled) Tasks that are configured.
  • Please note that in the application-https.yml that the ECDHE_RSA_WITH_AES_256_CBC_SHA384 cipher has been renamed TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384. This means that if the https configuration is moved from the Server to the Gatway that the cipher needs to be renamed.
  • Note that if using a Highly Available Clustering setup (HA), the SSL configuration has been moved from the Alpaca Server configuration to the Alpaca Gateway configuration.
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 Eureka

General Upgrade Process

These are the general steps for upgrading Alpaca Eureka.

  • Step: A-1
  • Commands:
    1. Turn off the existing Alpaca Eureka service.
      • # service alpaca-eureka stop
    2. Perform RPM upgrade
      • rpm -U alpaca-eureka-ALPACA_VERSION_1.x86_64.rpm
    3. Restart Alpaca service.
      • # service alpaca-eureka start

Alpaca Gateway

General Upgrade Process

These are the general steps for upgrading Alpaca Gateway.

  • Step: A-1
  • Commands:
    1. Turn off the existing Alpaca Gateway service.
      • # service alpaca-gateway stop
    2. Perform RPM upgrade
      • rpm -U alpaca-gateway-ALPACA_VERSION_1.x86_64.rpm
    3. Restart Alpaca service.
      • # service alpaca-gateway start

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.