Welcome
Upgrading and migrating
Learn how to upgrade HCL Launch elements, including the server, and agents, and how to migrate data.
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.

Welcome
Welcome to the HCL Launch 7.1.0 documentation, where you can find information about how to install, maintain, and use HCL Launch.
Release information
Overview
This section provides overview and getting started information.
Tutorials
Tutorials are available for every experience level.
Installing
An HCL Launch installation consists of the HCL Launch server, a database, and at least one agent.
Upgrading and migrating
Learn how to upgrade HCL Launch elements, including the server, and 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, and the blueprint design server in addition to upgrading the server. Upgrading the server, agents, agent relays, and blueprint design server 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 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.
- Upgrading encryption key strength
  When you upgrade the server from version 6.0.1.1 or earlier to a version later than version 6.0.1.1, you can upgrade the SSL encryption.
- 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 Codestation from filesystem repositories to S3 repositories
  You can migrate your Codestation artifacts from filesystem to S3 using the S3 migrator tool.
- 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
Uninstalling
Learn how to uninstall an HCL Launch server, agent, or blueprint design server.
Integrating
HCL Launch supports integrations with other products, products from others, and certain cloud systems.
Administering
Learn how to configure settings in HCL Launch elements and communication between the elements.
Managing security
HCL Launch uses a flexible team-based and role-based security model that maps to your organizational structure.
Modeling software deployment
Modeling software deployment in HCL Launch includes configuring components and component processes and adding those components to applications. Then, you use processes to deploy the components to environments.
Deploying
Learn how to deploy applications in HCL Launch.
Reporting
provides several different deployment and security reports.
Extending product function
Learn how to extend the function of HCL Launch.
Troubleshooting and support
Learn how to troubleshoot some common issues with HCL Launch.

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.

Before you begin

Install the database that you want to migrate to and create an account for the server to use.

Procedure

Download and extract the installation files for HCL Launch.
These files are available for download from the HCL FlexNet Operations portal.
Place the JAR file for the new database in the lib/ext folder of the installation files.
Stop the server.
Back up the current database.
From the command line, run the database migration script.
- On Windows™, run the migrate-database.bat file.
- On Linux™, run the migrate-database.sh file.
Depending on your system settings, you might need to run this file as an administrator.
Follow the instructions in the migration script, specifying the current location of the server and the connection information for the new database.
When the migration script is finished, restart the server and verify that the data has been migrated.
If the migration fails due to memory issues, increase the memory that is available to the script. To increase the memory, open the migration script and find the line of code that says 'ANT_OPTS="-Xmx1024m". The 1024m in this code represents 1024 megabytes of memory. Increase this number and run the migration script again.