Welcome
Upgrading and Migrating
Stay updated with latest features and functionalities by upgrading HCL DevOps Deploy (Deploy) server, agents, and relays. This section also provides instruction on how to migrate your Deploy instance.
Upgrading the server
You can upgrade the HCL DevOps Deploy (Deploy) server to incorporate to a later version. Always upgrade agents, and agent relays in addition to upgrading the server. Upgrading the server, agents, and agent relays are each completed independently. Unless specified, upgrade the server before you upgrade the agents.

Release Notes
This section includes what's new, defect fixes, and deprecations and removals in all releases.
System Requirements
This document includes information about the hardware, containers, prerequisite software, supported operating system, and database requirements with component level detail for the HCL DevOps Deploy (Deploy).
Getting Started
Quickly become productive with HCL DevOps Deploy (Deploy).
Installing
A HCL DevOps Deploy (Deploy) installation consists of a Deploy server, a database server, and at least one agent.
Upgrading and Migrating
Stay updated with latest features and functionalities by upgrading HCL DevOps Deploy (Deploy) server, agents, and relays. This section also provides instruction on how to migrate your Deploy instance.
- Testing an upgrade
  Before you upgrade your production HCL DevOps Deploy (Deploy) 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 DevOps Deploy (Deploy) server to incorporate to a later version. Always upgrade agents, and agent relays in addition to upgrading the server. Upgrading the server, agents, and agent relays are each completed independently. Unless specified, upgrade the server before you upgrade the agents.
  - Upgrade notes and blockers
    While upgrading to a new version, beware of the changes specific to a build version and take appropriate action for any blockers.
  - Upgrading the server in interactive mode
    To upgrade the server, stop the server, and run the new installation program.
  - Upgrading the server in silent mode
    Use silent mode to upgrade without command-line prompts. To upgrade the server, stop the server, edit the properties file, and run the new installation program.
- 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.
- 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 DevOps Deploy (Deploy) 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
Integrating
HCL DevOps Deploy (Deploy) supports integrations with other IBM® and HCL products, products from others, and certain cloud systems.
Administering
Learn how to administer settings in HCL DevOps Deploy (Deploy) elements and communication between the elements.
Managing Security
HCL DevOps Deploy (Deploy) uses a flexible team-based and role-based security model that maps to your organizational structure.
Modeling Software Deployment
Modeling software deployment in HCL DevOps Deploy (Deploy) 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 DevOps Deploy (Deploy).
Reporting
Provides several different deployment and security reports.
Extending Product Function
Learn how to extend the function of HCL DevOps Deploy (Deploy).
Troubleshooting and Support
Learn how to troubleshoot some common issues with HCL DevOps Deploy (Deploy).
Security Considerations
You can act to ensure that your installation is secure and set up user access controls.

Upgrading the server

You can upgrade the HCL DevOps Deploy (Deploy) server to incorporate to a later version. Always upgrade agents, and agent relays in addition to upgrading the server. Upgrading the server, agents, and agent relays are each completed independently. Unless specified, upgrade the server before you upgrade the agents.

About this task

Upgrading the Deploy server can be performed using the same methods as an initial installation. However, there are a number of considerations that must be taken into account during an upgrade. Read the following sections before performing the upgrade. The upgrade process is a complete replacement of the server.

Note: When you upgrade the server, only plug-ins that are shipped with the product are upgraded to newer versions. The updated plug-ins are not necessarily compatible with an earlier version. When you upgrade, previous versions of the plug-ins are kept on the server. You cannot create processes with previous versions of plug-ins, but you can deploy snapshots that use the old versions of the plug-ins.