Set up SSL Explorer on SME Server

Author:  Chris Carr
Contributor: 
Release supported: Tested on e-smith 6.5RC1
License:
Last updated: Friday, 3 June 2005 10.00 am 		 Symac
Issue:  Set SSL Explorer on SME Server
Solution:  Follow this HowTo
STEP 1:  Install SME Server 6.5

Carry out standard installation of SME Server
 
STEP 2: Install of Java  5.0 JRE

Download Linux RPM (self-extracting file) version of Java 5.0 JRE from:
www.java.com/en/download/manual.jsp

Copy jre-1_5_0_02-linux-i586-rpm.bin to /root/apps/java on SME Server

Make this file executable, at the console
# cd /root/apps/java

# chmod a+x jre-1_5_0_02-linux-i586-rpm.bin


Start installation by extracting rpm from file
 # ./jre-1_5_0_02-linux-i586.rpm
 
Type  yes to agree to the license terms

Run the rpm command on the extracted rpm file
# rpm -iv jre-1_5_0_02-linux-i586.rpm

Java JRE is installed in usr/java/jre1.5_0_02 
STEP 3:  Install SSL Explorer

Download current version of SSL Explorer (sslexplorer_linux_rpm__0_1_11.zip) from
http://sourceforge.net/projects/sslexplorer

Extract and copy sslexplorer_linux_0_1_11.rpm to /root/apps/sslexplorer

Run the rpm command  on this rpm file
#  rpm -iv sslexplorer_linux_0_1_11.rpm

SSl Explorer will be installed to /opt/sslexplorer

If you would like SSL Explorer to be configured as a service, create an empty file /etc/redhat-release
# touch /etc/redhat-release

This file identifies that the operating system is Redhat to the service install script
Then run the following command
# /opt/sslexplorer/platforms/linux/install-service

So that the service will start automatically, a symbolic link to this service needs to be created  in /etc/rc.d/rc7.d
# cd /etc/rc.d/rc7.d
 

STEP 4:  Configure SSL Explorer

Run the SSL Explorer Configuration utility:
#  cd /opt/sslexplorer

# ./setup-sslexplorer

SSL Explorer will start at the console in configuration mode.

This will show a URL (http://localhost:2080) to use for initial configuration of  SSL Explorer.

Access the web based set up procedure from a browser on a PC on the local network using the URL http://IP_Address_of_SME_Server:28080

Follow "The Web Based Setup Procedure" in the SSL Explorer Reference Guide PDF included in the SSL Explorer download.

We configured using the Built-in user database.

In addition you need to change the port for SSL Explorer WEB Server within Setup/General Options to an unused port, as Port 443 is already used for HTTPS by the SME Server Web Server. We used port 28081.

Shutdown SSL Explorer from the Web browser

STEP 5: Start SSL Explorer
Either:  If you installed SSL Explorer as a service type:
# service sslexplorer start

You can check that the SSL Explorer service has started by:
# service sslexplorer status

Or:      Run SSL Explorer in console mode, type:
# ./sslexplorer-console


Troubleshooting tip: -    If SSL Explorer does not start as a service, first verify that it will run in Console mode.
We found that SSL Explorer would not run as a service because a Java path had  not         been correctly created in the wrapper.conf file in /opt/sslexplorer/conf

        We amended  a line in wrapper.conf from:

wrapper.java.command=testing JVM in /usr/java/jre1.5.0_02... /usr/java/jre1.5.0_02/bin/java

to:

wrapper.java.command=/usr/java/jre1.5.0_02/bin/java

The service then started correctly.


STEP 6:  Complete Configuration of SSL Explorer

At a PC on the local network use a browser to go to URL:
https://IP_Address_of_SME_Server:28081


Login with username admin  and chosen password to complete configuration of SSL Explorer