Wiki source code of TCMS - Upgrade bzw. Update des TCMS
Last modified by Patrick Theil on 2022/07/29 12:23
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{warning title="Backup"}} | ||
| 2 | In any case, make a backup of the TCMS database before the update {{status title="File"/}} → {{status title="Export Database"/}} | ||
| 3 | {{/warning}} | ||
| 4 | |||
| 5 | |||
| 6 | There are 2 options for updating a TCMS depending on the initial situation: | ||
| 7 | |||
| 8 | 1. [[Update of existing TCMS>>doc:||anchor="Update"]] | ||
| 9 | 1. [[Upgrade of TCMS via a new installation with data transfer>>doc:||anchor="Upgrade"]] | ||
| 10 | |||
| 11 | = Update of existing TCMS = | ||
| 12 | |||
| 13 | {{id name="Update"/}} | ||
| 14 | |||
| 15 | {{info}} | ||
| 16 | This procedure is recommended for: | ||
| 17 | |||
| 18 | * smaller Update steps (TCMS source firmware >= 8.04) | ||
| 19 | * no necessary adjustment of the hard disk capacity | ||
| 20 | {{/info}} | ||
| 21 | |||
| 22 | == Export of existing database == | ||
| 23 | |||
| 24 | Now back up your existing TCMS database. On your TCMS, select the option {{status title="File"/}} → {{status title="Export Database"/}} and save the file. | ||
| 25 | |||
| 26 | {{lightbox image="001.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} | ||
| 27 | |||
| 28 | == TCMS Update == | ||
| 29 | |||
| 30 | === Installing the update === | ||
| 31 | |||
| 32 | Update the firmware and TCMS version on the TCMS as described here: | ||
| 33 | [[Rangee Firmware- und Softwareupdate Update>>doc:HowTos.RangeeOS - Firmware- und Softwareupdate.WebHome]] | ||
| 34 | |||
| 35 | == Database import == | ||
| 36 | |||
| 37 | === Reset current database === | ||
| 38 | |||
| 39 | After the update, log in to the TCMS interface and execute a database reset via {{status title="Edit"/}} → {{status title="Settings"/}} → {{status title="Database"/}} → {{status title="Create / Reset Database Tables"/}}. | ||
| 40 | |||
| 41 | {{lightbox image="002.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} | ||
| 42 | |||
| 43 | === Database import === | ||
| 44 | |||
| 45 | Now import the backed-up database via {{status title="File"/}} → {{status title="Import Database"/}} into your new TCMS. | ||
| 46 | |||
| 47 | {{lightbox image="003.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} | ||
| 48 | |||
| 49 | = Upgrade of TCMS via a new installation with data transfer = | ||
| 50 | |||
| 51 | {{id name="Upgrade"/}} | ||
| 52 | |||
| 53 | {{info}} | ||
| 54 | This procedure is recommended for: | ||
| 55 | |||
| 56 | (% style="list-style-type:square" %) | ||
| 57 | * Necessary increase of TCMS hard disk capacity (repository space) | ||
| 58 | * TCMS source firmware < 8.04 | ||
| 59 | {{/info}} | ||
| 60 | |||
| 61 | = Installing a new instance = | ||
| 62 | |||
| 63 | 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>>url:https://rangee.com/supportformular/||shape="rect"]]. | ||
| 64 | |||
| 65 | Instructions for installation on various systems can be found here: | ||
| 66 | |||
| 67 | [[TCMS - Installation>>doc:HowTos.TCMS - Installation.WebHome]] | ||
| 68 | |||
| 69 | |||
| 70 | == Transfer of the existing repository (optional) == | ||
| 71 | |||
| 72 | If you have used the repository function with your existing TCMS, you can transfer the data like this: | ||
| 73 | |||
| 74 | 1. Open the new TCMS | ||
| 75 | 1. Goto {{status title="Edit"/}} → {{status title="Settings"/}}→ {{status title="Upstream Repository"/}} and enter the following: | ||
| 76 | 11. "Scheme" → "http:~/~/" | ||
| 77 | 11. "Host" → IP or Hostname of your existing TCMS | ||
| 78 | 11. "Path" → "repository" (lowercase) | ||
| 79 | 11. Confirm with {{status title="Apply"/}}{{lightbox image="004.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} | ||
| 80 | 1. Open {{status title="Edit"/}} → {{status title="Repository"/}} | ||
| 81 | 1. Select all packages in the {{status title="Available Packages"/}} column and confirm with {{status title="Add"/}}. {{lightbox image="005.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} | ||
| 82 | 1. As soon as the packages appear in the "Local packages" column, the transfer is complete. | ||
| 83 | |||
| 84 | == Export of existing database == | ||
| 85 | |||
| 86 | Now backup your existing TCMS database. On your existing TCMS, select {{status title="File"/}} → {{status title="Export Database"/}} and save the file. | ||
| 87 | |||
| 88 | {{lightbox image="001.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} | ||
| 89 | |||
| 90 | == Database Import == | ||
| 91 | |||
| 92 | Now import the backed up database via {{status title="File"/}} → {{status title="Import Database"/}} into your new TCMS. | ||
| 93 | |||
| 94 | {{lightbox image="003.png" title="TCMS - Upgrade bzw. Update des TCMS" group="1"/}} | ||
| 95 | |||
| 96 | == Adjustment of the access data == | ||
| 97 | |||
| 98 | Store your desired administration access data on the new TCMS under: | ||
| 99 | |||
| 100 | |||
| 101 | {{status title="Kommbox"/}} → {{status title="USER CONFIGURATION"/}} and {{status title="TCMS"/}} → {{status title="Edit"/}} → {{status title="Settings"/}} → {{status title="Superuser"/}} | ||
| 102 | |||
| 103 | |||
| 104 | == Adoption of the local network settings == | ||
| 105 | |||
| 106 | 1. Make a note of the network settings stored on your previous TCMS {{status title="Kommbox"/}} → {{status title="Input / Output"/}} → {{status title="Network Configuration"/}}. | ||
| 107 | 1. Shutdown the old TCMS and then apply the Network Configuration on the new TCMS. | ||
| 108 | |||
| 109 | From this point on, all existing clients will log in and out on the new TCMS. The migration is hereby completed. |