Installing and Upgrading the Platform on Linux Servers

This document explains how to perform an RPM-based installation or upgrade of the Platform on Linux servers. This method does not use SSH and does not require that Linux credentials with elevated privileges be provided to the Apprenda Installer. Linux servers can only be added to an existing Platform.

Use the following steps to install or upgrade Linux servers.


Installing or Upgrading Linux Servers

Perform the following steps on each Linux server that will be added or upgraded.

  1.  On the Linux server, change into the directory containing the Platform RPMs. The following example is for Platform version 8.2 using the default Apprenda System Platform Repository mount. Update the command to the correct mount point for your Platform and the version you are installing or upgrading to.

    $ cd /apprenda/repo/sys/8.2/System/Nodes/RPM

    Platform RPMs are located in the Apprenda System Platform Repository mount point you configured during Platform installation (see the Preparing for the Apprenda Platform checklist for more information). The default location for this is “/apprenda/repo/sys”, but can be configured to a custom location. RPMS will be in the “System/Nodes/RPM” folder for the Platform version you are installing or upgrading to. Note that there are some additional considerations when upgrading with non-default repository locations.

  2. Install all RPMs in the folder. Depending on the server you are installing (or upgrading), set the version of “rhel” in the command below to the version you do not want to install. See the full list of Platform RPMs to install.

    $ ls | grep -v rhel6 | xargs rpm -Uvh --force
  3. After all RPMs are installed, run the following configuration script with the information for your server.

    For Installation:

    $ /apprenda/apprenda-updater/bin/ -a [app repo] -s [sys repo] -h [host name] -p [certificate password]

    You must include the password for the encryption certificate when configuring new Linux nodes. Before added any Linux node, you should update the certificate with a new password by using the Platform Operations Rest API endpoint /api/v1/services/encryption/export.

    For Upgrade:

    $ /apprenda/apprenda-updater/bin/ -a [app repo] -s [sys repo] -h [host name]


    Expected Input

    -a, --apps-repo

    (Required) Path to the apps repo mount point (configured at installation)

    -s, --sys-repo

    (Required) Path to the sys repo mount point (configured at installation)

    -h, --hostname

    (Required) The host name of the node

    -c, -cloud-url

    (Optional) The Cloud URL of the Platform that this node is joining

    -o, --output

    (Optional) Output file. Default output location: /tmp/configure-node.out

    -p, --password

    (Required for installs) Password for the certificate used for Platform encryption and needed to properly configure the Linux node to run the Platform. This is not needed for upgrades

Important Installation Notes

  • A Linux server manually added to the Platform will be in the Maintenance state. This means that the server can’t host application workloads and will not have Platform workloads deployed to it when its first added to the Platform. While in maintenance, Platform Operators can make additional configuration changes and perform any testing on the newly added server without disrupting the rest of the Platform. When all additional set up is complete, the server should be moved into the Online state

Important Upgrade Notes

  • When upgrading, the Platform expects the Apprenda System Platform Repository and Apprenda Application Platform Repository locations to be the same as those defined at install. If you have changed the location of the repository on some nodes, the locations must be symlinked to the corresponding repository locations configured at installation
  • If you experience any problems with your Linux nodes after an upgrade to Platform version 7.2.0 or later, it may be because they were not properly reconfigured during the upgrade to use encryption features added in Platform version 7.2.0. To reconfigure all your Linux nodes, make a request to the /services/encryption/reconfigurelinux Platform Operations REST API endpoint. If the problem persists after reconfiguration, please contact your support representative

Platform RPMs

The following is a list of all Platform RPMs. When installing and upgrading a Linux server, all of the following should be installed, except the RPM for the version of CentOS/RHEL the server is not running.

  • jre6-
  • jre7-
  • jre8-
  • tomcat7-
  • tomcat6-
  • apprenda-upgrade-bootstrap
  • apprenda-updater
  • apprenda-configuration-templates
  • apprenda-core
  • apprenda-logstash-server
  • apprenda-logstash-forwarder
  • apprenda-java-web-bootstrapper
  • apprenda-tomcat-bootstrappers
  • apprenda-jboss-bootstrapper
  • Depending on the CentOS/RHEL version install the corresponding RPM: apprenda-rhel6 or apprenda-rhel7