This is documentation for Apprenda 7 and 8.
Documentation for newer version is available at

Adding and Removing Nodes to/from a Platform

In addition to Platform installation tasks, the Apprenda Wizard executable can be used to add new nodes to your Apprenda environment or to remove existing nodes from that environment.


Adding and Removing a Server to/from an Apprenda Environment

The workflows for adding and removing nodes on an existing Apprenda environment are very similar, so a single initial process is described here for both scenarios.  To begin, run the Apprenda.Wizard executable and choose Modify from the initial menu.  Click Next, and you will be taken to the Modify an Existing Environment screen:

For more information on SSL certificates, as well as how they may affect the Platform modification process, please see this documentation.

In the Existing Environment URL box, enter the root URL of one of the existing Clouds on your environment.  Next, enter the Platform Operator credentials for your environment, and click Connect to initiate a connection with the environment.  Once a connection is established, click Next.  This will take you to the Manage Clouds in an Existing Environment screen, where you can see an overview of the Clouds that comprise your environment:

Click Next in order to manage specific servers or DB nodes on your environment. First, you will be shown a Windows Accounts Credential Overview screen with the credentials that the Apprenda Wizard will use to perform administrative tasks on the Platform. If the appropriate credentials are not already in place (although the installation process has usually saved the correct credentials), you will be asked to enter your environment's Administrator and System credentials in order to proceed. Clicking Next again will take you to the first of a series of screens where you can view different categories of existing nodes on your environment, and modify them as necessary.

Please Note: on a Platform environment with more than one Cloud, the Apprenda Wizard will group the subsequent node information screens by Cloud. When proceeding through the screens, you will first see all information relating to the first listed Cloud. For additional Clouds, you will then see the Windows Accounts Credential Overview screen again, followed by all node information relating to the second Cloud, and so on.

The Linux Server section of this page will not appear as you can not add or remove Linux nodes though the modify workflow (see the Notes section).

The first screen shows the Cloud's Server Overview, with all existing servers and the roles they are assigned:

This screen displays Web Servers in a box on the left, Application Servers in the middle, and Linux Servers in a box to the right. To add a server to a role, enter the server name into the appropriate box and click the green "Plus" icon:

You will then see that server added to under the appropriate role categorization.  To remove a server, right-click on that server, and select Remove server:

That server will now show a red "X" superimposed over its icon, meaning that it's designated for removal by the Apprenda Wizard's "Modify" process (you can also right-click on the icon again and select Reinstate server to cancel the removal of the selected server).

Note: Removing a server in this way will only remove the server’s role as a Web, Application, or Linux server on the Platform but will not remove a specialized Platform role of Load Manager, Platform Coordinator, or Cache. If a server with one of these roles is removed, the server will continue to function as the specialized role for the Platform but will not be available for hosting workloads.

To see the Cloud's Database Servers Overview page, click Next again:

Just as with the previous screen, you can right-click on a specific node and select Remove to designate it for removal.  To add a new database server, choose either SQL Server or Oracle from the "Database Type" dropdown menu.  Next, enter the server’s Instance Name in the appropriate box at the top of the screen, and then enter the database management credentials for that machine in the Username and Password boxes.  After that, enter the CPU, Memory and Storage capacities for the nodes to be added, and then click the green “Plus” icon.  Finally, if you've selected "Oracle" as the database type to add, you'll be prompted for the Oracle database's Service Name and Port; enter the values that were configured for the database during the Oracle install.

**Please Note: it is not possible to remove the Database Server that houses the Core Apprenda Database, which stores information essential to Platform operations.

Click Next to proceed to the Load Manager Overview screen:

You can use this page to change the nodes on which the Cloud's Load Manager Service is hosted. 

If Shared IIS Configuration is set up for the Cloud (which is necessary to host the Load Manager on more than one server per Cloud), the Load Manager Service Can be hosted on multiple nodes, and (in most cases) you can add or remove a node to/from this list of Load Manager hosts.  Please note: if the Cloud uses a Shared IIS Configuration, at least one of the original Load Manager hosts (one of the nodes initially configured to share IIS Configuration) must remain a Load Manager host.  You may remove all but one of these original hosts, and you can add others, but one original host must remain a Load Manager host.  This limitation exists to safeguard the initial shared configuration data.

You can designate an existing node as a Load Manager on this screen simply by clicking on that node's icon; hosts will be highlighted with a white border.  To add a new node, click the box labeled "Use a server that you've prepared," enter that server's name in the box that appears, and click Add Host.  To completely remove an existing Load Manager host, check the "Use a server that you've prepared" box, click on the icon of the server you'd like to remove to highlight it, and click the Remove Selected Host button.

If Shared IIS Configuration is not set up for the Cloud, you will be able to add a Load Manager host, but will be required to set up the Shared IIS Configuration in order to do so.  When a Cloud has multiple Load Manager hosts, the Load Manager hosts cannot also be designated as Web Servers (so it may be necessary to remove the Load Manager hosts from the Web Server role on the Cloud's Server Overview page earlier in the Installer modification workflow).  Please note that it is not possible to remove an existing Load Manager host from a Cloud with only one host.  In order to change Load Manager hosts in this situation, you must 1) run the Installer modify workflow and add a Load Manager host (which will require enabling the Shared IIS configuration) and complete the modify workflow 2) close the Installer 3) relaunch the Installer and run the modify workflow to remove the original Load Manager host.

Finally, click Next once again, and you will be taken to the Linux Server Configuration screen.  If Linux configuration has been previously completed, the input fields will be grayed out and non-editable.  If you are adding at least one Linux server to a Cloud that did not previously include one, however, at this screen you will need to enter the administrator credentials that the Platform will use when deploying components to the Cloud's Linux server(s).  The account credentials inputted on this screen will also be used to install Apprenda to any included Linux servers. If you enter credentials for an account other than the root account, you will also be prompted to choose the Elevation Type (either su or sudo) that applies to the user account.

Additionally, you will need to enter the paths to the Apprenda repository share mountpoints that were created on the Linux server(s) when setting up your infrastructure.  You must also enter a Default Workload Account for Java Web Application workloads hosted on Linux servers to run under, and then choose to enable or disable Automatic Workload Account Creation (if enabled, this will allow Java workload accounts that don't initially exist on Linux machines to be auto-created by the Platform on those machines).

This page will only include the the option to input a Application Mount Point, System Mount Point, Automatic Workload Account Creation default, and a Default Workload Account. Since Linux nodes are added or removed manually, the Installer does not need you to provide an install account.

Once you've added and removed all desired nodes for all Clouds in the previous screens, clicking Next will take you to the Validation Tasks screen, where, similar to the Platform installation process, the Apprenda Wizard validates the environment's configuration before carrying out Platform modification tasks.  Click Validate My Configuration and wait until the process completes successfully; then click Next.  Finally, you will arrive at the Modify Apprenda screen, where you can click the Modify button to complete node addition/removal:

When the process has completed, click Finish.