TCMS - Upgrade or update of the TCMS

Last modified by Patrick Theil on 2022/07/29 12:23

Backup

In any case, make a backup of the TCMS database before the update  File  →  Export Database

There are 2 options for updating a TCMS depending on the initial situation:

  1. Update of existing TCMS
  2. Upgrade of TCMS via a new installation with data transfer

Update of existing TCMS

This procedure is recommended for:

  • smaller Update steps (TCMS source firmware >= 8.04)
  • no necessary adjustment of the hard disk capacity

Export of existing database

Now back up your existing TCMS database.  On your TCMS, select the option   File  →  Export Database  and save the file.

TCMS Update

Installing the update

Update the firmware and TCMS version on the TCMS as described here:
Rangee Firmware- und Softwareupdate Update

Database import

Reset current database

After the update, log in to the TCMS interface and execute a database reset via  Edit  →  Settings  →  Database  →  Create / Reset Database Tables .

Database import

Now import the backed-up database via  File  →  Import Database  into your new TCMS.

Upgrade of TCMS via a new installation with data transfer

This procedure is recommended for:

  • Necessary increase of TCMS hard disk capacity (repository space)
  • TCMS source firmware < 8.04

Installing a new instance

First install a new TCMS next to the existing one in the desired target version. The current version is available on request from  Rangee Support.

Instructions for installation on various systems can be found here:

TCMS - Installation

Transfer of the existing repository (optional)

If you have used the repository function with your existing TCMS, you can transfer the data like this:

  1. Open the new TCMS
  2. Goto   Edit Settings →  Upstream Repository and enter the following:
    1. "Scheme" → "http://"
    2. "Host" → IP or Hostname of your existing TCMS
    3. "Path" → "repository" (lowercase)
    4. Confirm with  Apply

  3. Open  Edit Repository
  4. Select all packages in the Available Packages column and confirm with Add .   

  5. As soon as the packages appear in the "Local packages" column, the transfer is complete.

Export of existing database

Now backup your existing TCMS database. On your existing TCMS, select    File →  Export Database  and save the file.

Database Import

Now import the backed up database via  File  →  Import Database  into your new TCMS.

Adjustment of the access data

Store your desired administration access data on the new TCMS under:

Kommbox  →  USER CONFIGURATION  and  TCMS  →  Edit  →  Settings  →  Superuser

Adoption of the local network settings

  1. Make a note of the network settings stored on your previous TCMS Kommbox Input / Output Network Configuration .
  2. Shutdown the old TCMS and then apply the Network Configuration on the new TCMS.

From this point on, all existing clients will  log in and out on the new TCMS. The migration is hereby completed.