Differences

This shows you the differences between two versions of the page.

--- technote:upgrading [2020/10/06 23:54] – [Upgrading Operating System] Scott Cunliffe
+++ technote:upgrading [2025/08/07 01:09] (current) – [Visual Runtime] Scott Cunliffe
@@ Line 25: / Line 25: @@
 You will also need to schedule a time to perform the upgrade as you will need to shut down the Framework Server so consideration will need to be given to when any Syncs are scheduled or Customers may be accessing the data.
-For detailed information see [[technote:upgrade_server|Upgrade Server]].
+For detailed information see [[technote:upgrade_server|Upgrading Server]].
-===== Upgrading Operating System =====
+<note important>Always backup the TapeTrack database and any Sync or Server Utilities scripts before any upgrades are performed</note>
-Upgrading to a new operating system, such as Windows Server 2019, the actions required depend on the process you select for the upgrade.
+====== Other Considerations ======
-Most server upgrades will allow you to select an option to keep personal files, while by design this should ensure the integrity of your database and associated files, it is best practice to take a backup of the database, Sync files and any other scheduled TapeTrack task files.
-The other option is a custom install which, by default, doesn't keep any files, applications or settings so you have to take a complete backup of all TapeTrack data, associated files and a listing of all scheduled tasks, including any files the scheduled task use as well as execution times and permissions.
-When upgrading your operating system, although TapeTrack is compatible with all Windows operating systems from 2008 Server and Windows 7, it is a good idea to upgrade to the latest release of TapeTrack at the same time especially if your version of TapeTrack is more than two years old.
-Files you need to backup.
+===== TapeTrack License =====
-^File-Directory ^ Default Location ^
-|TapeTrack Database| <nowiki>C:\Program Files\TapeTrack\TapeTrack Framework Server\var</nowiki>|
-|TapeTrack Sync| <nowiki>C:\Program Files\TapeTrack\TapeTrack Sync</nowiki>|
-|TapeTrack SecureSync| <nowiki>C:\Program Files\TapeTrack\TapeTrack SecureSync</nowiki>|
-|TapeTrack Server Utilities Scripts| <nowiki>C:\Program Files\TapeTrack\TapeTrack Server Utilities\Scripts</nowiki>|
+If you are upgrading your hardware, Virtual Server or migrating to the Cloud there is a possibility of the MAC address of your server changing.
-===== Upgrading Server =====
+As your TapeTrack License Key is based off your Owner name, Expiry date and the MAC address, the current License Key will become invalid if any of these alter.
-===== Upgrading Or Migrating To A New Domain =====
+If your server has internet access, you can apply for a Temporary License Key, which will allow your to start using TapeTrack immediately, as well as give you two weeks grace period to contact the support desk for a Permanent Key based off your true License expiry date.
-===== Migrating To New Server Or The Cloud =====
+[[master:temporary_license|Get Temporary License]]
+If you don't have internet access, you will need to apply for a Permanent license to regain access to TapeTrack.
+Letting support know your upgrade plans will allow a TapeTrack technician to be available to assist in cutting a new Software Key and License installation to get you back up and running as quickly as possible.
+[[master:full_license|Get Full License]]
+Taking a screen shot of your TapeTrack License before your upgrade will help with noting the Owner name, and your current expiry date.
+{{license.png}}
+===== Windows AD Login =====
+If you, and other users, use Windows Active Directory integration to log into TapeTrack your User Identity in TapeTrack mirrors your Windows AD user name.
+If your upgrade is moving your users to another domain, or altering your Windows AD username the TapeTrack usernames will need to be updated to match.
+As a User-ID in TapeTrack cannot be edited, you will need to create new User-ID's for each User to match your new Domain name, as well as updating the new AD domain in the User's Identity tab.
+If you wish to maintain previous User-ID's for audit, or any other, purposes instead of deleting the User-ID's, they can be disabled in the User's Identity tab.  This will make the User-ID inactive and stop any further access.
+See [[master:user|Add New User]] on information to add new Users or access User Identity tab.
+{{user_identity.png}}
+===== TMSS10Sync =====
+If you are synchronizing TapeTrack with your Libraries, chances are you are using TMSS10Sync to do it.
+This program is usually installed on the same server as your TapeTrack Framework Server, default installation location is <nowiki>C:\Program Files\TapeTrack\TapeTrack Sync</nowiki>, although the location can be where ever was specified at installation, so if it is not in that location you will need to ascertain where it was installed, the next likely location would be <nowiki>D:\Program Files\TapeTrack\TapeTrack Sync</nowiki>.
+TMSS10Sync works in a 3 step process:
+  * Extract data from your Library
+  * Process the data in TapeTrack
+  * Report on the result of the Sync
+As well as optionally emailing the results, if set up to do so.
+Within the TapeTrack Sync will be several folders:
+  * bin
+    * Contains the executables, these files will be created when installing TMSS10Sync on the new server so don't need to be backed up.
+  * etc
+    * In a standard installation this folder will contain your ttidef file.  This file is used to translate the information imported from your libraries to a format for inputting into TapeTrack. This file is customised for your system and you will need to back this up and place it in the same folder on the new installation.
+  * reports
+    * Output from the Sync process is normally saved to this directory, while not required for the new installation, you may wish to backup these reports if you archive them or will need to reference them in the future for any reason.
+  * scripts
+    * This folder will contain one or several batch files that execute the Sync process.  These files are custom for your Sync and will need to be backed up and and place it in the same folder on the new installation.
+  * var
+    * On installation the var folder contains a sample CSV file, as an example on how to import data into TapeTrack.  If this is the only file in this folder you will not need to back it up, it will be created with the new installation.  If you have other customised files in this directory you will need to back them up and place in the same directory on the new installation.
+Almost all installation of TMSS10Sync have the code to execute the program contained within a batch file that is executed by Windows Scheduler, or another scheduler, that runs the Sync at a pre-set schedule.  Take note of the files that are executed by the scheduler as well as permissions, execution time and execution repetition so you can recreate this automation on the new installation.
+Remember to check the batch files and update the User-ID, password and/or server address if any of these values have been changed. This will be in the format <nowiki>-S user:-password@Server</nowiki>.  More details on the Server Argument can be viewed at [[cli:server_argument|Server Argument]].
+As well as updating any parameters involved in emailing the output files if required.
+===== Server Utilities =====
+TapeTrack Server Utilities are a collection of executables used for automating tasks and creating reports.  These files, while able to be executed manually are usually via batch script and scheduled automation.
+The Server Utilities executables will all be created by the installation of the Server Utilities installer.
+Any batch file scripts that reside in the Server Utilities directories will need to be backed up and placed in the same folders on the new installation.
+As the Server Utilities can be run also be run from client side computers, any alteration to the User-ID and passwords as well as the Server address (or IP) will need to be upgraded in the batch file code.
+===== Domains =====
+If you are changing the Windows Domain you will need to:
+  * Create a new User-ID for each user that logs in using the Windows AD feature of TapeTrack if their Windows User-ID is altered in the process as TapeTrack User-ID's much match the Windows AD username to access this function.
+  * Update connection attributes in TapeTrack Client software if the connection details to the Framework Server alter.
+===== Email server =====
+===== Migrating To The Cloud =====
+Migrating to the Cloud, TapeTrack will function the same as installed on your own hardware except for the Windows AD login function.
+Each user will need to have a password, stored in the TapeTrack Server, for authentication when logging in.
+This will mean Users will no longer need to check the ''No MD5'' checkbox on the login screen.
+If you have the ''Active Domain'' and ''Require AD Group'' selected in the Users ''Identity'' tab, you will need to remove the ''Active Domain'' and set 'Require AD Group'' to false
+{{user_identity_ad.png}}
+===== Visual Runtime =====
+TapeTrack utilizes Microsoft Visual Runtime Libraries to minimize the size of the executables as well as take advantage of Microsoft Security updates for these components, without the need for you to update TapeTrack each time such an update is available.  It also stops multiple installations of the same DLL files as they can be shared by multiple applications and ensures you get the most up to date version at the time of installation.
+If you are upgrading your operating system or your version of TapeTrack, you may need to download and install the relevant version of Visual Runtime to match.  The TapeTrack installer will check for the presence of the required Visual Runtime and notify you if this component is required to be downloaded and installed as part of the installation.  If you don't receive a popup prompting to install the Visual Runtime package, TapeTrack installer has confirmed it is already installed.
+If you need to install the Visual Runtime Package, instructions can be viewed [[technote:visual_c_runtime|here]].
+The latest supported releases can be downloaded from [[https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads|Microsoft Visual C++ downloads]]
+{{tag>technote visual_c upgrade server}}