[SAM] Tomcat Upgrade Guide for Windows

[SAM] Tomcat Upgrade Guide for Windows

1            Download latest version of Apache Tomcat 

Select 32-bit/64-bit Windows Service Installer



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 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’


 

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)


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)

 

Under the ‘Java’ tab, ensure that the ‘Java Virtual Machine’ is the same as the one copied into the readme.txt, and append in the ‘-DSAMOIDCConfig= <path>’

             

Under the ‘General’ tab, click ‘Start’ and ensure ‘Service Status’ updates to ‘Started’

Conduct end-to-end tests and provide updates to support@netrust.net

    • Related Articles

    • [nSign] Tomcat Upgrade Guide for Windows

      1 Download latest version of Apache Tomcat Select 32-bit/64-bit Windows Service Installer Transfer Installer into Windows Server Hosting Netrust Application 2. Tomcat Upgrade 2.1. Files and Configuration Backup Create a folder ‘<Netrust ...

    • SAM-OIDC configuration change for NDI Migration

      NDI migration (Windows version) 1. Changing Configuration -Locate to the sam-oidc config folder (Note: the folder will be located within C drive if there is only C drive within the server. Else it will be located within other 'Drive") (Note: the sam ...

    • Java Upgrade

      1.     Java Upgrade 1.1.    Install Oracle Java installer (JRE) Launch Oracle  installer after the download, click next until following screen. Set location to within Netrust/java folder. Complete the installation.     1.2.    Locate Tomcat Folder ...

    • Restarting of Tomcat Service

      1) Select the Search icon on taskbar, key in Services and press enter 2) Locate the Tomcat Service 3) Right click on the Tomcat Service and select "Restart" (Be reminded to select the correct Tomcat Service to be restarted)

    • Verifying nSign Tomcat service status

      1) Select the Search icon on taskbar, key in Services and press enter 2) Ensure that the status of nSign Tomcat Service is "Running"