Users Guide

Enabling HTTPS Using a Self-Signed SSL Certificate | Using SSL Certificate
178 OMNM 6.5.3 Installation Guide
Enabling HTTPS Using a Self-Signed SSL Certificate
1 Edit script: ‘makecert.sh’
(in directory: <INSTALL_DIR>\oware\synergy\tomcat-7.0.70\bin\certs)
a. Edit the group of lines starting with ‘KT_’ and set appropriate values for:
‘KT_HOSTNAME’ and ‘KT_IPADDRESS’
b. Changing values of other ‘KT_’ variables is optional
2 Edit script: ‘setenv.bat’ (Windows) or ‘sentenv.sh’ (Linux)
(in directory: <INSTALL_DIR>\oware\synergy\tomcat-7.0.70\bin)
a. Change line FROM: “ENABLE_SSL=false” TO: “ENABLE_SSL=true”
b. Change line with ‘SSL_PASSWORD=’ to match ‘KT_PASSWORD’ value, if changed in
step 1.
c. Change line with ‘SSL_CERTKEYFILE=’ to match ‘KT_FILENAME’ value, if changed
in step 1.
3 Execute script: ‘makecert.sh’
(in directory: <INSTALL_DIR>\oware\synergy\tomcat-7.0.70\bin\certs)
a. [Windows ONLY] Open a Windows command prompt, execute: oware
b. [Linux ONLY] Open a Terminal window
c. Execute: cd “$OWARE_USER_ROOT/oware/synergy/tomcat-7.0.70/bin/certs”
d. Execute: ./makecert.sh
e. Script will generate three files: 1) ‘selfsigned.cer’ 2) ‘selfsigned.jks’ 3) ‘selfsigned-csr.txt’
4 Edit file: ‘web.xml’
(in directory: <INSTALL_DIR>\oware\synergy\tomcat-7.0.70\conf)
a. Copy and paste contents of file: ‘web-ssl-addition.xml’
b. Into file: ‘web.xml’ just BEFORE the last line that contains: “</web-app>”
5 Stop, Update & Restart Web Server Service
(Execute from directory: <INSTALL_DIR>\oware\synergy\tomcat-7.0.70\bin) [Windows
ONLY]
a. From an Administrative command prompt, execute: net stop synergy
b. From an Administrative command prompt, execute: service.bat update
c. From an Administrative command prompt, execute: net start synergy [Linux ONLY]
d. From a root terminal, execute: service synergy stop
e. From a root terminal, execute: service synergy start
6 Install certificate on all client machines that access the application. [Windows ONLY]
a. Open Windows File Explorer to directory:
%OWARE_USER_ROOT%\oware\synergy\tomcat-7.0.70\bin\certs
b. Open file: ‘selfsigned.cer’ and choose “Install Certificate...”
c. Choose “Local Machine” as the Store Location