Home
Upgrading and migrating
Learn how to upgrade HCL Launch elements, including the server, agents, and how to migrate data.
Upgrading agents as services on Windows using command-line
You can upgrade the currently running Deploy agent as a Windows service even though you initially didn’t install HCL Launch agent as a service during the installation process.

Upgrading and migrating
Learn how to upgrade HCL Launch elements, including the server, agents, and how to migrate data.
- Testing an upgrade
  Before you upgrade your production HCL Launch server, for best results, perform a test upgrade, verify the challenges you are facing, and resolve them before performing an actual upgrade.
- Upgrading the server
  You can upgrade the HCL Launch server to incorporate to a later version. Always upgrade agents, agent relays in addition to upgrading the server. Upgrading the server, agents, agent relays are each completed independently. Unless specified, upgrade the server before you upgrade the agents.
- Upgrading high-availability installations
  All servers that are configured for the HA feature must be on the same version. Thus, all servers must be upgraded at the same time.
- Upgrading agents
  In most cases, you upgrade agents from the server interface, but you can also upgrade the agents from the command line. Always upgrade agents and agent relays in addition to upgrading the server.
- Upgrading agents as services on Windows using command-line
  You can upgrade the currently running Deploy agent as a Windows service even though you initially didn’t install HCL Launch agent as a service during the installation process.
- Upgrading agent relays
  In most cases, you upgrade agents relays from the command line, but starting from 7.0.4.2 version, you can upgrade the server from the interface. Always upgrade agents and agent relays in addition to upgrading the server.
- Migrating the server database
  The server installation files include a script that migrates the server database from Derby to another database system. You can not migrate from any database other than Derby.
- Migrating the server to Kubernetes/Openshift
  You can migrate your HCL Launch server from an on-premises production installation to a containerized instance that runs in a Kubernetes or Openshift cluster.
- Migrating an existing IBM® installation to HCL Launch

Upgrading agents as services on Windows using command-line

You can upgrade the currently running Deploy agent as a Windows service even though you initially didn’t install HCL Launch agent as a service during the installation process.

Upgrading the agents to Windows service by using the command-line interference

Before you begin, stop the running agent. You can stop the agent from the command-line or the server. To stop the agent from the command line, run the following command:

agent.cmd stop

Follow these steps to upgrade the agent to a Windows services by using the command-line interface:

Open the command prompt as an administrator.
Change the directory to the agent's bin/init/service folder.
Locate the agent.cmd script.
Run the agent.cmd script with the following argument:
```
ibm-ucdagent.cmd_agent.cmd install <service name>
```

The HCL Launch agent now runs as a Windows service.

Upgrading the compact agents to Windows service by using the command-line interference

Perform the following steps to upgrade the compact agents to Windows service:

Go to <agent_installation_directory>/bin.
Run the following command:
```
run agent install-service
```

The compact agent is now upgraded to Windows service and appears as hcl-launch-agent.