Home
Administering
Learn how to administer settings in HCL Launch elements and communication between the elements.
Setting up high-availability clusters
To configure a high-availability cluster, you store shared files on network storage. Then, you configure multiple servers, set each server to access the same files and database, and configure a load balancer to distribute the traffic between the servers.
Converting a stand-alone server to high availability
You can convert an HCL Launch server into the first node of a high-availability cluster.

Administering
Learn how to administer settings in HCL Launch elements and communication between the elements.
- High availability and failover
  You can configure clustered HCL Launch servers, and agents for high availability. You can also configure agents and agent relays for failover.
- Setting up high-availability clusters
  To configure a high-availability cluster, you store shared files on network storage. Then, you configure multiple servers, set each server to access the same files and database, and configure a load balancer to distribute the traffic between the servers.
  - Setting up clusters of servers
    To configure a cluster of servers, set up a shared database and file system for the servers to use.
  - Adding servers to clusters
    You can add new servers to a cluster at installation time, or you can move existing servers to be part of a cluster.
  - Converting a stand-alone server to high availability
    You can convert an HCL Launch server into the first node of a high-availability cluster.
- Adding cold standby servers
  You can add cold standby servers to serve as a backup server or for disaster recovery. You must start the secondary server or servers when the active server fails, and network traffic is routed to the secondary servers.
- Backup and recover
  You can back up and recover the contents of your HCL Launch installation.
- Server settings and configuration
  After you install HCL Launch, you can modify the server configuration and configure more options.
- Setting user preferences
  Each user can specify display options for the server, including the language for the server and how the server shows times and dates.
- Agents and agent relay configuration
  After you install an agent for HCL Launch, you can modify its configuration or create an agent relay to facilitate communication to remote relays.
- License management
  HCL Launch provides a 60-day license-free evaluation period. To use all product features after the evaluation period, you must have a license.
- Setting up the wizard for new users
  HCL Launch includes a wizard to help users become familiar with the procedures and steps in creating a deployment. Some configuration is required before the wizard can be used.
- Customizing the table views
  Customize a table view in the HCL Launch application by hiding or showing, and reordering of the table columns.
- Managing data

Converting a stand-alone server to high availability

You can convert an HCL Launch server into the first node of a high-availability cluster.

Before you begin

Each server in the cluster must run the same version of HCL Launch.

About this task

To convert a stand-alone server to the first node in a clustered configuration, you first move CodeStation to shared network storage, and then modify the server settings for multi-server operation.

Procedure

Move CodeStation to a shared storage location with a fast network connection.
Because each cluster server must access the same configuration files, each server must have access to this network storage. See Relocating CodeStation.
Install a load balancer to send requests to the servers.
The load balancer must be able to forward requests to the HTTP and HTTPS ports for the servers. For more information, see the documentation for your load balancer.
Important: You must configure the load balancer for session persistence, also known as session affinity.
Stop of the server.
Add the following line of code to the install_folder/conf/server/installed.properties file:
```
com.urbancode.ds.UDeployServer.multiserver=true
```
Start the server.
On the new cluster server, click Settings > System Settings, and set the External Agent URL and the External User URL to the URL for the load balancer.

Results

After you configure the server and the load balancer, you can add nodes to the cluster.

What to do next

Add new servers to the cluster. See Adding servers to clusters.