Home
Installing
An HCL Launch installation consists of the HCL Launch server, a database, and at least one agent.
Installing agent relays
An agent relay is a communication proxy for agents that are located behind a firewall or in another network location. You can install agent relays in interactive mode or in silent mode.
Installing an agent relay in a Kubernetes cluster
An HCL Launchagent relay automates application deployments through your environments. Relays are especially good for coordinating environments with numerous agents. You can connect several agents outside the firewall to the server with a single relay.

Installing
An HCL Launch installation consists of the HCL Launch server, a database, and at least one agent.
- System requirements and performance considerations
  The HCL Launch server runs on Windows™ and UNIX™ systems. Following some guidelines can improve the performance of the server and agents.
- Firewall and communication configuration
  Before you install the server, you must ensure that servers, agents, and other systems can connect to each other through your networks and firewalls.
- Installing the server database
  HCL Launch requires a database. You can use the following database types for an evaluation or production server.
- Installing the server
  The server provides services such as the user interface used to configure application deployments, the workflow engine, the security service, and the artifact repository, among others. Installing the server involves specifying configuration information for the server, such as the ports that the server uses.
- Installing with Kubernetes
  The HCL Launch server can be installed in a cloud-based environment, as a containerized server cluster, managed by Kubernetes. HCL Launch works with Kubernetes to simplify application deployment and manage versions in the containers.
- Installing agents
  You can install agents from the server or from the command line on the agent system. To configure a failover server for an agent, you must install the agent from the command line.
- Installing agent relays
  An agent relay is a communication proxy for agents that are located behind a firewall or in another network location. You can install agent relays in interactive mode or in silent mode.
  - Installing agent relays in interactive mode
    Installing an agent relay from the command line involves running a batch file or shell script and specifying information about the agent relay.
  - Installing agent relays in silent mode
    In silent mode, you specify the installation properties in a text file and then run the agent relay installation without command-line prompts.
  - Installing an agent relay in a Kubernetes cluster
    An HCL Launchagent relay automates application deployments through your environments. Relays are especially good for coordinating environments with numerous agents. You can connect several agents outside the firewall to the server with a single relay.
  - Agent Relay installation properties
    The agent relay properties in the installed.properties file control details about the agent relays, including how it connects to the server.
- Installing plug-ins
  Plug-ins can be installed at any time. You do not need to restart the server after you install a plug-in.
- Starting HCL Launch
  Both UNIX™ and Windows™ installations require the HCL Launch server and at least one agent. If you are using a database other than Derby, make sure that the appropriate driver is installed and configured.
- Backing up and recovering
  You can back up and recover the contents of your HCL Launch installation.
- Installing and uninstalling test fixes (patches) from the server
  Test fixes are provided by IBM® support to correct specific issues. They are applied to the server as patches.

Installing an agent relay in a Kubernetes cluster

An HCL Launchagent relay automates application deployments through your environments. Relays are especially good for coordinating environments with numerous agents. You can connect several agents outside the firewall to the server with a single relay.

Before you begin

Ensure that you complete the following prerequisite tasks:

Set up a working Kubernetes cluster.
Create a project/namespace where the HCL Launch agent relay will run.

For more information, refer to the README topic below.

About this task

You can install a containerized version of the HCL Launch agent relay in a Kubernetes cluster using a Helm chart.

To install an agent relay in Kubernetes cluster using Helm charts, see README.

What to do next

Set agent relay properties to control details about the installed agent relays. For more information, see, Agent Relay installation properties.