Adding and Removing Nodes to/from a Platform

You can use the Apprenda Install Wizard executable to add new Windows nodes to your Apprenda environment or to remove Windows existing nodes from that environment. Note that any node may be removed through its Server Details page in the SOC.

Linux nodes cannot be added or removed through the Apprenda Install Wizard the modify workflow. If you wish to add a new Linux server to the Platform, see the instructions for adding a Linux server. If you wish to remove a Linux server, remove the node through the SOC.

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. You can also use the modify workflow to change or assign a Platform role for a server.


Before you begin, you should understand the available Platform server and data storage roles, and make sure the change you plan to make on your Platform align with the Platform best practices in the Apprenda Reference Architecture.

Any Windows node you plan to add to a Platform should meet the requirements outlined in the pre-installation checklist.

Adding and Removing a Windows Server to/from an Apprenda Environment

Start by opening the Apprenda.Wizard.exe from the Installer folder of the Apprenda Cloud Platform package. In the first screen select Modify and click Next.

On the Modify Exisiting screen,

  1. fill in the Existing Environment URL with the root URL of one of the Clouds on your Platform
  2. enter your Platform Operator credentials for your environment
  3. click Login to initiate a connection with the Platform

Once a connection is successful, click Next.

On the Manage Clouds in an Existing Environment screen, you can see an overview of the Clouds that comprise your environment. Click Next to manage specific servers or DB nodes on your environment.

The Apprenda Will Run as the Following Windows Accounts shows the accounts the Platform has been configured to use.

Note: On a Platform environment with more than one Cloud, the Apprenda Wizard will group the following node specific screens by Cloud. 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 What Servers Should We Have? screen shows the Cloud’s Server Overview, with all existing Windows servers and if they are assigned as Web Servers or Application Servers. Note that Linux Servers are not listed.

Add a Server

To add a server to a Web or Application role, enter the server name into corresponding box and click the Plus (+) icon:

You will then see that server added to under the appropriate role categorization. 

Remove a Server

To remove a server, right-click on the server’s name, and select Remove server:

That server will now show a red “X” icon and will be removed by the Apprenda Wizard’s “Modify” process in a later screen. You can also right-click on the icon again and select Reinstate server to cancel the removal of the selected server. If you remove a server that you just added, it will be removed from the page.

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

Click Next to continue.

The next page is What Database Servers Should We Have? which shows an overview of Database Servers for the Cloud Name.

Add Database

To add a new database,

  1. choose the Database Type of either SQL Server or Oracle from the dropdown menu
  2. fill in the server’s Instance Name and the database management credentials for that machine in the Username and Password boxes
  3. set the CPU, Memory, and Storage capacities for the nodes
  4. if you’ve selected Oracle as the database type to add, also include the Oracle database’s Service Name and Port

When you are finished configuring the new database instance, click the Plus (+) icon.

Remove Database

Right-click on a specific node and select Remove to designate it for removal.  Next, , and .  After that, enter the to be added, and then click the green .  Finally, ; enter the values that were configured for the database during the Oracle install.

Note: It is not possible to remove the Database Server that houses the Core Database of the Platform because it stores information essential to Platform operations.

Click Next to continue.

You use the Load Manager Overview screen to change the nodes on which the Cloud’s Load Manager Service is hosted.

If Shared IIS Configuration is set up for the 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 as you needs.

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 or add nodes as Load manager nodes, but one original host must remain a Load Manager host. This limitation exists to safeguard the initial shared configuration data.

To set an node as a Load manager, click on that node’s name. Nodes that are highlighted by a white rectangle are selected as Load Manager nodes.

To add a node that is not part of the Platform, click the box labeled Use a server that you’ve prepared and enter that server’s name in the box that appears. 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. 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. Additionally, it is not possible to remove an existing Load Manager host from a Cloud with only one host. 

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.

Click Neck to continue.

On the Configure Platfrom Auditing screen you have the option to enable/disable Platform wide auditing of Developer and Platform Operator actions.

To enable auditing,

  1. select Enable Platform Auditing
  2. fill in the Instance Name, User Name, and Password for the SQL database you wish to use for Auditing. You may use a database that is not part of the Platform if you chose.

Next you will see the Validation Tasks screen, where the Apprenda Installation Wizard validates the environment’s configuration before carrying out Platform modification tasks.  Click Validate My Configuration and wait until the process completes successfully.

When all validation steps are complete, then click Next to get to the Modify Apprenda screen. Click Modify to begin making your configured changes to your Platform.

When the process has completed, click Finish.