This is documentation for the current major version Apprenda 7.
Documentation for older versions are also available.

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.

Prerequisites

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 7.0.0 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/repository/sys/7.0.0/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 "/repository/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.

  1. 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
  1. After all RPMs are installed, run the following configuration script with the information for your server.
$ /apprenda/apprenda-updater/bin/configure-node.sh -a [app repo] -s [sys repo] -h [host name]

Parameter

Expected Input

-a

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

-s

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

-h

(Required) The host name of the node

-c

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

-o

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

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.

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-6.6.1.18
  • jre7-1.0.0.4
  • jre8-1.0.0.4
  • tomcat7-6.6.0.14
  • tomcat6-6.6.0.29
  • 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