Show last authors
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.
Rangee GmbH ©2021