This is documentation for Apprenda 7 and 8.
Documentation for older versions are also available.

Adding and Removing Clouds to/from a Platform

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

The workflows for adding and removing Clouds 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:

To Remove an existing Cloud, select the Cloud you wish to remove by clicking on the appropriate icon and then clicking the Remove Cloud button.

**Please Note: It is not possible to remove the Cloud where the Database Server that houses the Core Apprenda Database (which stores information essential to Platform operations) is located.

To Add a New Cloud to an Existing Environment, from the Manage Clouds in an Existing Environment screen, click on the Add Another Cloud button.  This will allow you to input Cloud-specific information for your new Cloud, including the Cloud URL and, if desired, an SSL certificate.

Click on the Next button, which will take you through the configuration of any existing Clouds that you wish to remain on the Platform (at which point you may also add/remove infrastructure to those Clouds as described here),  and which will also allow you to configure any new Clouds that you are adding.

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.

After you have clicked through and/or modified information for any existing Clouds, you will be able to input information for any new Clouds.  The new Cloud's Server Overview page will allow you to add Web, Application, and Linux servers to the new Cloud:

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 see the Cloud's Database Servers Overview page, click Next again:

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.

Click Next to see the Platform Coordination Cluster screen, which will let you choose which servers will host the Platform Coordination Cluster services.  It is recommended that you use an odd number of servers for this step; you may choose to use external nodes by selecting the checkbox option.

Click Next to proceed to the Load Manager Overview screen:

You can designate a node that you added as an Application Server 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.  If you wish to set up the new Cloud to use multiple Load Managers, you will also be required to supply information for setting up Shared IIS configuration.

Clicking Next again will take you to the Cache Service configuration screen.  On this screen, you must choose which server or group of servers will host Apprenda's Cache Service for this Cloud; you again have the option of choosing servers that are not a part of the Platform for this task. Next, enter the Maximum memory usage that each instance is allowed to use for caching, and choose a password that the Platform will use to secure the cache.  Finally, enter a port number or port numbers that the Platform will use to communicate with cache instances.  Each port listed will correspond to a cache instance to be created on each machine that is designated to host the cache service; one cache instance per CPU core on a host machine is recommended.

Finally, click Next once again.  If the Cloud you are adding contains at least one Linux server, you will be taken to the Linux Server Configuration screen.  At this screen you will need to enter the administrator credentials (most likely the root account) 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 also must 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).

Once you've added and removed all desired  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 Cloud addition/removal:

When the process has completed, click Finish.