Welcome to our docs site. Docs on this site are for ACP version 9.
See these links for previous versions: Version 8, Version 7

Installing the Platform on Linux Servers

This page explains how to add Linux nodes to an existing Platform. Linux nodes are added by installing Platform RPMs on each node you want to add.

This process is similar to how to upgrade the Platform on Linux nodes.

Prerequisites

Add Linux Servers

Perform the following steps on each Linux server that you are adding.

  1. Change into the directory containing the Platform RPMs. The following example is for Platform version 9.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.

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

    Platform RPMs are located in the Apprenda System Platform Repository mount point you configured during Platform installation (see the Pre-Installation Checklist for more information). The default location for this is “/apprenda/repo/sys”, but can be configured to a custom location. RPMS are in the “System/Nodes/RPM” folder for the Platform version you are installing.

  2. Install all RPMs in that folder. Depending on the server you are installing, 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. Run the configuration script with the information for your server after all the RPMs are installed.

    $ /apprenda/apprenda-updater/bin/configure-node.sh -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 adding any Linux node, you must update the certificate with a new password by using the Platform Operations Rest API endpoint /api/v1/services/encryption/export.

    Parameter

    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

    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

  • When a Linux server is added to the Platform it is in the Maintenance state. In this state, the server can not host application workloads and the Platform will not deploy any workloads to it as part of the normal application deployment process. While the server is 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, transition the server into the Online state to begin hosting workloads

Platform RPMs

The following is a list of all Platform RPMs. When installing a Linux server, install all of the following RPMs, 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.0.53
  • 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
  • apprenda-rhel6 or apprenda-rhel7, depending on the CentOS/RHEL version install the corresponding RPM