Wiki source code of TCMS - Upgrade bzw. Update des TCMS
Last modified by Patrick Theil on 2022/07/29 12:23
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
51.1 | 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"/}} | ||
| |
20.8 | 3 | {{/warning}} |
| |
20.3 | 4 | |
| |
20.8 | 5 | |
| |
51.1 | 6 | There are 2 options for updating a TCMS depending on the initial situation: |
| |
20.3 | 7 | |
| |
51.1 | 8 | 1. [[Update of existing TCMS>>doc:||anchor="Update"]] |
| 9 | 1. [[Upgrade of TCMS via a new installation with data transfer>>doc:||anchor="Upgrade"]] | ||
| |
20.3 | 10 | |
| |
51.1 | 11 | = Update of existing TCMS = |
| |
20.3 | 12 | |
| 13 | {{id name="Update"/}} | ||
| 14 | |||
| 15 | {{info}} | ||
| |
51.1 | 16 | This procedure is recommended for: |
| |
20.3 | 17 | |
| |
51.1 | 18 | * smaller Update steps (TCMS source firmware >= 8.04) |
| 19 | * no necessary adjustment of the hard disk capacity | ||
| |
20.3 | 20 | {{/info}} |
| 21 | |||
| |
51.1 | 22 | == Export of existing database == |
| |
20.3 | 23 | |
| |
51.1 | 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. |
| |
20.3 | 25 | |
| |
51.1 | 26 | {{lightbox image="001.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} |
| |
20.3 | 27 | |
| |
51.1 | 28 | == TCMS Update == |
| |
20.3 | 29 | |
| |
51.1 | 30 | === Installing the update === |
| |
20.3 | 31 | |
| |
51.1 | 32 | Update the firmware and TCMS version on the TCMS as described here: |
| |
33.1 | 33 | [[Rangee Firmware- und Softwareupdate Update>>doc:HowTos.RangeeOS - Firmware- und Softwareupdate.WebHome]] |
| |
20.3 | 34 | |
| |
51.1 | 35 | == Database import == |
| |
20.3 | 36 | |
| |
51.1 | 37 | === Reset current database === |
| |
20.3 | 38 | |
| |
51.1 | 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"/}}. |
| |
20.3 | 40 | |
| |
51.1 | 41 | {{lightbox image="002.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} |
| |
20.3 | 42 | |
| |
51.1 | 43 | === Database import === |
| |
20.3 | 44 | |
| |
51.1 | 45 | Now import the backed-up database via {{status title="File"/}} → {{status title="Import Database"/}} into your new TCMS. |
| |
49.1 | 46 | |
| |
51.1 | 47 | {{lightbox image="003.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} |
| |
49.1 | 48 | |
| |
51.1 | 49 | = Upgrade of TCMS via a new installation with data transfer = |
| |
20.3 | 50 | |
| 51 | {{id name="Upgrade"/}} | ||
| 52 | |||
| 53 | {{info}} | ||
| |
51.1 | 54 | This procedure is recommended for: |
| |
20.3 | 55 | |
| |
20.8 | 56 | (% style="list-style-type:square" %) |
| |
51.1 | 57 | * Necessary increase of TCMS hard disk capacity (repository space) |
| 58 | * TCMS source firmware < 8.04 | ||
| |
20.3 | 59 | {{/info}} |
| 60 | |||
| |
51.1 | 61 | = Installing a new instance = |
| |
20.3 | 62 | |
| |
51.1 | 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"]]. |
| |
20.3 | 64 | |
| |
51.1 | 65 | Instructions for installation on various systems can be found here: |
| |
20.3 | 66 | |
| |
37.1 | 67 | [[TCMS - Installation>>doc:HowTos.TCMS - Installation.WebHome]] |
| |
20.3 | 68 | |
| 69 | |||
| |
51.1 | 70 | == Transfer of the existing repository (optional) == |
| |
20.3 | 71 | |
| |
51.1 | 72 | If you have used the repository function with your existing TCMS, you can transfer the data like this: |
| |
20.3 | 73 | |
| |
51.1 | 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. | ||
| |
20.3 | 83 | |
| |
51.1 | 84 | == Export of existing database == |
| |
20.3 | 85 | |
| |
51.1 | 86 | Now backup your existing TCMS database. On your existing TCMS, select {{status title="File"/}} → {{status title="Export Database"/}} and save the file. |
| |
20.3 | 87 | |
| |
51.1 | 88 | {{lightbox image="001.png" title="TCMS - Upgrade or update of the TCMS" group="1"/}} |
| |
20.3 | 89 | |
| |
51.1 | 90 | == Database Import == |
| |
20.3 | 91 | |
| |
51.1 | 92 | Now import the backed up database via {{status title="File"/}} → {{status title="Import Database"/}} into your new TCMS. |
| |
50.1 | 93 | |
| |
51.1 | 94 | {{lightbox image="003.png" title="TCMS - Upgrade bzw. Update des TCMS" group="1"/}} |
| |
50.1 | 95 | |
| |
51.1 | 96 | == Adjustment of the access data == |
| |
20.3 | 97 | |
| |
51.1 | 98 | Store your desired administration access data on the new TCMS under: |
| |
20.3 | 99 | |
| 100 | |||
| |
51.1 | 101 | {{status title="Kommbox"/}} → {{status title="USER CONFIGURATION"/}} and {{status title="TCMS"/}} → {{status title="Edit"/}} → {{status title="Settings"/}} → {{status title="Superuser"/}} |
| |
20.3 | 102 | |
| 103 | |||
| |
51.1 | 104 | == Adoption of the local network settings == |
| |
20.3 | 105 | |
| |
51.1 | 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. | ||
| |
20.3 | 108 | |
| |
51.1 | 109 | From this point on, all existing clients will log in and out on the new TCMS. The migration is hereby completed. |