[SAM] Tomcat Upgrade Guide for Windows
1 Download latest version of Apache Tomcat
Select 32-bit/64-bit Windows Service Installer
Select 32-bit/64-bit Windows Service Installer
Transfer Installer into Windows Server Hosting Netrust Application
Transfer Installer into Windows Server Hosting Netrust Application
2. Tomcat Upgrade
2.1. Files and Configuration Backup
Create a folder ‘<Netrust Application>-backup-<date in YYYYMMDD>’ in backup folder (e.g. C:\Netrust\samoidc-backup-20210819)
Copy entire existing Apache Tomcat folder and paste into this location (e.g. existing Apache Tomcat folder is C:\Netrust\Tomcat
9.040sam-oidc-uat)
Create a folder ‘<Netrust Application>-backup-<date in YYYYMMDD>’ in backup folder (e.g. C:\Netrust\samoidc-backup-20210819)
Copy entire existing Apache Tomcat folder and paste into this location (e.g. existing Apache Tomcat folder is C:\Netrust\Tomcat
9.040sam-oidc-uat)
Create readme.txt and write ‘Reason for upgrade’, ‘Existing Apache Tomcat version’, ‘New Apache
Tomcat version’
Create readme.txt and write ‘Reason for upgrade’, ‘Existing Apache Tomcat version’, ‘New Apache
Tomcat version’
In existing Apache Tomcat’s bin folder, double click ‘<version>sam-oidc-uatw.exe’
In existing Apache Tomcat’s bin folder, double click ‘<version>sam-oidc-uatw.exe’
Under ‘Log on’ tab, take note of account used for log on and paste contents into readme.txt
Under ‘Log on’ tab, take note of account used for log on and paste contents into readme.txt
Under ‘Java’ tab, copy contents in ‘Java Virtual Machine’ and paste into readme.txt (exclude \jre\bin\server\jvm.dll)
Under ‘Java’ tab, copy contents in ‘Java Virtual Machine’ and paste into readme.txt (exclude \jre\bin\server\jvm.dll)
Within the content of Java Options, copy out the
‘-DSAMOIDCConfig= <path>’ and paste it into the readme.txt
Under ‘Java’ Tab, copy contents in ‘Initial memory pool’, ‘Maximum memory pool’, and ‘Thread stack size’ and paste into readme.txt
Within the content of Java Options, copy out the ‘-DSAMOIDCConfig= <path>’ and paste it into the readme.txt
Under ‘Java’ Tab, copy contents in ‘Initial memory pool’, ‘Maximum memory pool’, and ‘Thread stack size’ and paste into readme.txt
2.2. Stop and Disable Existing Apache Tomcat
In existing Apache Tomcat’s bin folder, double click ‘<version>sam-oidc-uatw.exe’
Click ‘Stop’ and ensure ‘Service status’ changes to ‘Stopped’
Change ‘Startup type’ to ‘Disabled’
2.3. Install Apache Tomcat
Run Installer, click ‘Next >’
Unselect all items, select ‘Native’, click ‘Next >’
Update service name to ‘sam-oidc-<Apache Tomcat Version>’, click ‘Next >’ (e.g.9.0.52-sam-oidc)
Replace Java path with Java used in existing Apache Tomcat, click ‘Next >’ (e.g. C:\Program Files\Java\jdk1.8.0_202)
Copy path starting from ‘Tomcat’ (e.g.
Tomcat 9.0_9.0.52-sam-oidc)
Change path to the same path as existing Apache Tomcat (e.g. C:\Netrust\) and paste folder name (e.g.
Tomcat 9.0_9.0.52-sam-oidc), click ‘Install’
Unselect ‘Run Apache Tomcat’ and ‘Show Readme’, click ‘Finish’
2.4. Configure Apache Tomcat
Open Apache Tomcat folder in Windows Explorer (e.g.
C:\Netrust\Tomcat 9.0_9.0.52-sam-oidc)
Delete all Contents in Apache Tomcat’s webapps folder
Copy contents of from existing Apache Tomcat ‘\webapps’ folder and paste into Apache Tomcat’s webapps folder (e.g.
C:\Netrust\Tomcat 9.0_9.0.52-sam-oidc\webapps)
Copy existing Apache Tomcat ‘\conf\server.xml’ file and paste into Apache Tomcat’s conf folder (e.g. C:\Netrust\Tomcat 9.0_9.0.52-sam-oidc\conf)
Double click ‘<version>sam-oidc-uatw.exe’ (e.g. 9.0.50-sam-oidc-uatw.exe)
Change ‘Startup type’ to ‘Automatic (Delayed Start)’
Under ‘Log on’ tab, change ‘Log on as’ to match the ‘Log on as’ tab of existing Apache Tomcat (for accounts, input the correct password)