Home
Administering
Learn how to administer settings in HCL Launch elements and communication between the elements.
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.
Changing or updating the JRE of agents
You can change the JRE of active agents by editing their configuration files.

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.
- 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.
  - Agent security and communication
    Agents use SSL-secured WebSocket, and HTTPS protocols to communicate with the server.
  - Managing agents remotely
    After an agent is installed, you can manage (with the monitor process) many of its features from the HCL Launch web application.
  - Changing or updating the JRE of agents
    You can change the JRE of active agents by editing their configuration files.
  - Managing Java packages on an agent
    You can upload, install, and manage Java packages on compact agent using the web UI.
  - Managing Java packages on agents in bulk
    You can manage the Java distribution on your numerous agents by using Bulk Actions.
  - Creating and managing agent pools
    Similar to resource groups, agent pools help you organize and manage agents that are installed in different environments.
  - Migrating agents to Web
    Agent Configuration Templates allow you to migrate JMS agents on a server to Web agents with the ability to revert back to the original JMS configuration. This allows you to specify connection details for groups of agents.
  - Removing and reinstalling agents as Windows™ services
    If you installed an agent as a Windows™ service, you can remove and reinstall the service.
  - Setting agent properties
    Agent properties store information that is relevant to a specific agent.
  - Updating the JRE for agent relays
    If you upgrade the JRE and change the JRE location, you must also update the agent relays. If you do not change the location of the JRE, you do not have to update these files.
  - Changing passwords for the agent relay keystores
    You can change the Java™ keystore passwords for the agent relay.
  - Managing agent relays remotely
    After an agent relay is installed, you can manage many of its features from the HCL Launch web application.
  - Migrating agents relays to Web
    JMS agent relays on a server can be migrated to Web with the ability to revert back to the original JMS configuration. This allows you to specify connection details for groups of agent 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

Changing or updating the JRE of agents

You can change the JRE of active agents by editing their configuration files.

About this task

Procedure

Install the new JRE.
On the agent system, stop the agent.

Important: Do not use the server UI to stop the agent.
If the agent is installed on Linux™, update the location of the JRE in the following places.

Note: As a shortcut, you can delete the old JRE and move the new JRE into the location of the old JRE. In this case, you do not need to update the properties in the following files because they now point to the new JRE.
1. In the file installation_directory/bin/configure-agent, set the value of the JAVA_HOME property to the location of the JRE.
2. In the file installation_directory/bin/agent, set the value of the JAVA_HOME property to the location of the JRE.
If the agent is installed on Windows™, update the location of the JRE in the following places.

Note: As a shortcut, you can move the new JRE into the location of the old JRE. In this case, you do not need to update the properties in the following files because they now point to the new JRE.
1. In the file installation_directory\bin\configure-agent.cmd, set the value of the JAVA_HOME property to the location of the JRE.
2. In the file installation_directory\bin\agent.cmd, set the value of the JAVA_HOME property to the location of the JRE.
3. In the file installation_directory\bin\service\_agent.cmd, set the value of the JAVA_HOME property to the location of the JRE.
If the agent is running as a service on Windows™, remove and reinstall the service.
See Removing and reinstalling agents as Windows services.

For the Windows service of agents, you must update the JAVA_HOME property in $agent_install\bin\service\_agent.cmd file with the new location of Java, and then recreate the Windows service.
On the agent system, start the agent.

Important: Do not use the server UI to restart the agent because in this case the JRE is not updated.