Home
HCL Sametime® Administration Guide 12.0.1
Migrating and Upgrading
This section provides information on migrating data from an earlier release to Sametime 12.
Upgrading to a new version or applying a fixpack
Newer versions and fix packs contain new features and fixes. You do not need to remove your current Sametime 12 installation when upgrading to a new version.
Upgrading on Docker

HCL Sametime® Administration Guide 12.0.1
- Accessibility features for Sametime
  Accessibility features help users who have a disability, such as restricted mobility or limited vision, use information technology products successfully. HCL® strives to provide products with usable access for everyone.
- What's new
  HCL Sametime and HCL Sametime Premium 12.0.1 provide many new features, enhancements and fixes to servers and clients. Additional releases to version 12.0.1 also provides updates to the product.
- Planning
  This section describes the system requirements and server configurations needed for HCL Sametime and HCL Sametime Premium.
- Installing
  This section provides information on installing the servers for Sametime and Sametime Premium.
- Configuring
  This section provides information on configuring the HCL Sametime server. Configuration tasks are dependent on the deployment environment.
- Securing
  This section provides information on securing your HCL Sametime environments.
- Administering
  This section provides information on administering on Sametime environments.
- Troubleshooting
  This section provides information on troubleshooting and supporting Sametime environments.
- Uninstalling Sametime
  In the event that Sametime must be removed, follow the procedure for the platform that Sametime is installed on.
- Migrating and Upgrading
  This section provides information on migrating data from an earlier release to Sametime 12.
  - Planning for migration to Sametime 12
    Sametime 12 requires a new product install and migration of data from your previous version. Do not uninstall the previous version until the V12 installation is finalized and working as expected.
  - Upgrading to a new version or applying a fixpack
    Newer versions and fix packs contain new features and fixes. You do not need to remove your current Sametime 12 installation when upgrading to a new version.
    - Upgrading on Docker
    - Upgrading on Kubernetes
      The Sametime upgrade packages contain full helm charts.
    - Reverting to a previous version on Kubernetes
- Notices

Upgrading on Docker

Before you begin

To install a new version or fix pack, the following conditions must be satisfied:

HCL Sametime 12 version is installed and configured
Sametime server has access to a MongoDB server

About this task

Creating a backup of the installation directory, allows you to return to your previous version if a problem occurs related to installing the fix pack.

Note:

Make a backup of your key files, such as docker-compose.yml and any customized files on the system so that you can validate any custom settings from the previous installation. If you have placed files in the sametime-config folder like custom branding or TLS certificates, those files need to be restored after the fix pack is installed. For the docker-compose.yml file, after the upgrade reference the backup version and add the modifications to the new docker-compose.yml provided during the upgrade. Changes to the custom.env and .env files are retained when upgrading to version 12.0.1 and later.
The docker-compose.yml file is replaced during the upgrade with a newer version. Do not restore this file from a previous version after the upgrade. Any needed modifications need to be implemented again in the new file version.

Procedure

In the directory where Sametime is installed, issue the following command to stop the Sametime server.
```
 docker-compose down 
```
Make a copy of the Sametime installation directory as a backup before installing the fix pack.
Copy the contents of the installation directory into another directory. For example, /sametime_install_backup where sametime_install is the Sametime installation directory.
Download and decompress the Sametime fix pack archive to the Sametime installation directory.
```
unzip sametime_fixpack_zip -d /sametime_install_path 
```
In the sametime_install directory, run the following script to initiate the installation process.
```
 ./install.sh
```
Follow the prompts to provide the required information. The install process detects if the install is an upgrade or full install.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.