Downgrade/Rollback

If you installed a service pack or hotfix and you later decide that you want to revert to the previous installation, you can do that.

Precautions

It is important to understand the requirements and limitations of downgrade/rollback procedures:

  • You can use this process to downgrade to an earlier release (for example, 8.7 to 8.5). But, you cannot use this process to downgrade to a version prior to the current version (for example, 8.x to 7.x).

• The rollback scripts are only for rolling back to a previous service pack. If a release has only one service pack or hotfix applied to it, rollback is not guaranteed to work, in an attempt to rollback to the base GA version. For example, 8.0.1 release refers to the hotfix release 1 of a 8.0.0 base GA release. You cannot rollback to 8.0.0 in this case. If you do, starting the TDV server may result in error messages such as these:
— In the cs_repository.log: “Could not receive data from client: No connection could be made because the target machine actively refused it.”
— In the cs_monitor.log: “MONITOR STOP. The metadata repository was created with a newer version of the server. The server cannot continue.”

Downgrade/rollback a service pack for TDV Server, Studio, or Business Directory

If downgrading on Windows, any open windows to the repository or jdk folder must be closed.

If your TDV products are running, stop them, including all processes and databases used as repositories or caches.

Downgrade from 8.8 to 8.7/8.6/8.5 Server

To downgrade TDV Server from version 8.8 to 8.7/8.6/8.5, follow these steps:

  1. Stop monitor daemon:

composite.<bat|sh> monitor stop

Note: To check if the Monitor daemon has stopped completely, check for the “Bye” message in cs_server.log.

  1. Start server process without monitor daemon:

composite_server.sh(bat) run

  1. Run the following command for TDV Server:

server_util.bat/sh -server <id> -port <port> -user <uid> -password <password> -rollbackRepository -toVersion 8.5.0

For BD, run the following:

bd_server_util.bat/sh

Example:

bin/server_util.bat -server localhost -port 9400 -user admin -password admin1 -rollbackRepository -toVersion 8.5.0

  1. Kill all java processes.

  2. Stop repo and cache.

  3. Run <install_dir>/install/rollback_patch.sh(bat) script (for Server).

  4. Run the command:

chmod 733 /bin/cis_dowgrade_patch.sh

  1. Run the command

cis_<product>_<version>_downgrade_patch.bat (CIS – windows) / cis_<product>_<version>_downgrade_patch.sh (CIS – UNIX)

  1. Apply 8.7/8.6/8.5 patch (downgraded version).

  2. Start the service(repo, monitor,cache). Note at this point none of them are up and running. you would need to start all of them.

  3. You have to manually un-deploy a few adapters and re-deploy them due to the Java version changes in earlier TDV versions. Follow these steps to do that:

    i. Undeploy the ComputeDB, ApacheDrill and TibcoStreaming adapter using the following commands

    bin/server_util.sh -server localhost -port 9400 -user admin -password admin1 -domain composite -undeploy -name ComputeDB -version 1  -verbose
    bin/server_util.sh -server localhost -port 9400 -user admin -password admin1 -domain composite -undeploy -name ApacheDrill -version 1  -verbose
    bin/server_util.sh -server localhost -port 9400 -user admin -password admin1 -domain composite -undeploy -name TibcoStreaming -version 1  -verbose

    ii. Redploy ComputeDB, ApacheDrill and TibcoStreaming adapter using following commands.

    bin/server_util.sh -server localhost -port 9400 -user admin -password admin1 -domain composite -deploy -package packages/archived_ds_adapters/dst-drill-8.7.0-080700001.jar  -verbose
    bin/server_util.sh -server localhost -port 9400 -user admin -password admin1 -domain composite -deploy -package packages/archived_ds_adapters/dst-computedb-8.7.0-080700001.jar  -verbose
    bin/server_util.sh -server localhost -port 9400 -user admin -password admin1 -domain composite -deploy -package packages/archived_ds_adapters/dst-streambase-8.7.0-080700001.jar  -verbose

  4. Restart the Monitor.

  5. Import backup CAR files as needed.

  6. Optionally, redefine all your VCS roots and connections.

  7. To check the metadata version after a downgrade, run the following command. A list of metadata versions for each TDV release is given in Repository Versions of TDV Server/BD

./repository/bin/psql -Uroot -hlocalhost -p9408 -d cisrepo -c "select * from cisrepo.metadata_version"

Downgrade from 8.8 to 8.7/8.6/8.5 BD/Studio

To downgrade TDV Studio/BD from version 8.7 to 8.6/8.5/8.4/8.3, follow these steps:

  1. Stop monitor daemon:

composite.<bat|sh> monitor stop

Note: To check if the Monitor daemon has stopped completely, check for the “Bye” message in cs_server.log.

  1. Run <install_dir>/install/rollback_patch.sh(bat) script (for Studio) and <install_dir>/bd/install/rollback_patch.sh(bat) script (for BD)

  2. Stop the repo and cache (For BD only).

  3. Run bd/studio_downgrade_patch.bat (sh)

  4. Apply downgraded version of BD/Studio patch

  5. Restart the service (For BD only).

To rollback a hotfix for TDV Server, Studio, or Business Directory

  1. If working on Windows, any open windows to the repository or jdk folder must be closed.

  2. Make sure that the TDV Server is stopped.

composite.<bat|sh> monitor stop

Note: To check if the Monitor daemon has stopped completely, check for the “Bye” message in cs_server.log.

  1. Run the rollback script located in

<TDV_Install_Dir>/install/rollback_TIB_tdv_<product><version>_HF-<hotfix_number>_all.<bat|sh>

  1. Navigate to <install_dir> and reapply the last service pack or hotfix. After downgrade it is necessary to apply the downgraded version of service pack/hotfix before starting the server.

  2. Start the Monitor Daemon.

For TDV: composite.<bat|sh> monitor start
For BD: bd.<bat|sh> monitor start

In the server.log, verify that the version is the target version you intended.

 

Repository Versions of TDV Server/BD

Release Version TDV Server BD
8.3 32 30
8.4 33 30
8.5 34 30
8.6 34 30
8.7 35 30
8.8 36 30