Home
Installing
An HCL Launch installation consists of the HCL Launch server, a database, and at least one agent.
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.
Starting agents
To start an agent, run the shell script or batch file.

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 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.
  - Starting and stopping the server
    To run the server, run the batch file or shell script for the server.
  - Starting agents
    To start an agent, run the shell script or batch file.
  - Starting z/OS agents from the z/OS UNIX command line
    The UCD z/OS agent can be started from ISPF as a started task or from the z/OS UNIX command line. To start an agent from ISPF as a started task refer to install/topics/run_agent.html. To start the z/OS agent from the z/OS UNIX command line, follow this procedure.
  - Starting agent relays
    To start an agent relay, run its batch file or shell script.
  - Accessing HCL Launch
    You can access the server and the blueprint designer with a web browser.
- 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.

Starting agents

To start an agent, run the shell script or batch file.

Before you begin

Make sure that the server is running. Also, if the agent runs through an agent relay, make sure that the relay is started.

Procedure

Go to the agent_installation\bin directory.
Run the appropriate script:
- On Windows™, run this command:
```
agent.cmd start
```
- On Linux™ or UNIX™, run this command:
```
./agent start
```
- On z/OS®, to run the agent as a started task, customize the sample hlq.SBUZSAMP(BUZAGNT) started task member, and then copy the task member to the SYS1.PROCLIB library. Provide the installation directory of the agent. The default installation directory of the agent is /opt/ucd/agent/bin. The following lines show sample code:
```
//* 
//*  HCL Launch Agent - Start 
//*
//BUZAGNT  PROC AGENT='/opt/ucd/agent/bin'
//*
//BUZAGNT  EXEC PGM=BPXBATCH,REGION=0M,TIME=NOLIMIT,
//            PARM='PGM &AGENT./agent run'
//STDOUT   DD SYSOUT=*
//STDERR   DD SYSOUT=*
//*
//        PEND
//*
```
- On IBM® i, you must start the agent through the IBM® Portable Application Solutions Environment for i (PASE for i) shell.
After the agent starts, go to the HCL Launch web application, and under Resources, open the Agents page.
Associate the agent user ID to the started task by setting up the STARTED class profile. To set up the STARTED class, enter these commands:

Results

When the installation is complete, the agent is listed with a status of Online.