Morphon Technologies

This guide explains how to install Morphon T-o-M on a Microsoft Windows server. Morphon T-o-M is supported under Windows 2000 and newer, but will work on any system with a Sun Java VM. Morphon T-o-M requires Sun's Java Runtime (version 1.5 or newer) installed.

All commands listed below should be run with administrative rights. If you'd like to use a different installation path, feel free to do so.

To install Morphon T-o-M as a regular program that you start and stop by hand, following these steps:

1. Install a Java Runtime Environment (JRE), if not available yet.
2. Extract morphon-tom-1.3-bundle.zip to C:\Program Files\
3. Start Morphon T-o-M: Execute C:\Program Files\Morphon T-o-M 1.3 Stand-Alone\run.cmd
4. Verify the installation: browse to http://localhost:8080/morphon-tom/

To stop Morphon T-o-M, press ctrl-c in the program's window.

Morphon T-o-M can also be installed as a Windows Service, such that it starts automatically when Windows starts. Follow these steps:

1. Install a Java Runtime Environment (JRE), if not available yet.
2. Extract morphon-tom-1.3-bundle.zip to C:\Program Files\
3. Execute C:\Program Files\Morphon T-o-M 1.3 Stand-Alone\install-service.cmd
4. Verify installation: browse to http://localhost:8080/morphon-tom/

To uninstall the Windows service, execute C:\Program Files\Morphon T-o-M 1.3 Stand-Alone\remove-service.cmd

Stopping and starting the service works like any other Windows service; use Microsoft Management Console's Services snap-in, or run one of the following commands:

• to stop:

  net stop Jetty6-Service

• to start:

   net start Jetty6-Service

If you have purchased a Morphon T-o-M license you must configure the license key. Follow these steps:

1. Follow the steps for Demo mode (either Regular or Windows Service)
2. Execute the file C:\Program Files\Morphon T-o-M 1.3 Stand-Alone\edit-configuration.cmd. Notepad will open the Morphon T-o-M configuration file.
3. Insert the following line, replacing your_license_key with the license key you received.

    license = your_license_key

4. Save the file and close Notepad
5. Restart Morphon T-o-M

Morphon T-o-M uses cryptographic keys to offload all aspects of encrypting and signing. You may choose to use a 'soft' software based keystore, or your certificate vendor may have supplied you with a hardware key such as a USB token or PCI device. The following sections have configuration examples for the most common cases.

1. Follow the steps for Demo mode or Licensed mode.
2. Copy your JKS file to C:\keystore.jks.
3. Execute the file C:\Program Files\Morphon T-o-M 1.3 Stand-Alone\edit-configuration.cmd. Notepad will open the Morphon configuration file.
4. Add the following lines, substituting your-alias, your-keystore-password and your-key-password with the proper values for your keystore:

   jkskey.type = jks
   jkskey.path = C:/keystore.jks
   jkskey.alias = your-alias
   jkskey.storepw = your-keystore-password
   jkskey.keypw = your-key-password
   

5. Replace the line

   keys = demo

   with

   keys = demo, jkskey

6. Save the file and close Notepad
7. Restart Morphon T-o-M

You can now use the key called "jkskey" in your templates.

1. Follow the steps for Demo mode or Licensed mode.
2. Follow the instructions that came with your hardware token to install it. For specific tokens, see below.
3. Execute the file C:\Program Files\Morphon T-o-M 1.3 Stand-Alone\edit-configuration.cmd. Notepad will open the Morphon configuration file.
4. Add the following lines, substituting pkcs11_library.dll, your-alias, your-keystore-password and your-key-password with the proper values for your hardware token:

   pkcs11key.type = pkcs11
   pkcs11key.name = pkcs11_token
   pkcs11key.library=C:/WINDOWS/system32/pkcs11_library.dll
   pkcs11key.slot=10
   pkcs11key.alias = your_alias
   pkcs11key.storepw = your-store-pw
   pkcs11key.keypw = your-key-password
   

5. Replace the line

   keys = demo

   with

   keys = demo, pkcs11key

6. Save the file and close Notepad
7. Restart Morphon T-o-M

You can now use the key called "pkcs11key" in your templates.

1. Download and install the SafeNet Borderless Security PK Client.
2. Download and install the latest drivers for the iKey.
3. Follow the steps for Demo mode or Licensed mode.
4. Execute the file C:\Program Files\Morphon T-o-M 1.3 Stand-Alone\edit-configuration.cmd. Notepad will open the Morphon configuration file.
5. Add the following lines, substituting your-alias, your-keystore-password and your-key-password with the proper values for your iKey token:

   pkcs11key.type = pkcs11
   pkcs11key.name = pkcs11_token
   pkcs11key.library=C:/WINDOWS/system32/dkck201.dll
   pkcs11key.slot=10
   pkcs11key.alias = your_alias
   pkcs11key.storepw = your-store-pw
   pkcs11key.keypw = your-key-password
   pkcs11key.disabledMechanisms = { CKM_MD5_RSA_PKCS CKM_SHA1_RSA_PKCS }
   

6. Replace the line

   keys = demo

   with

   keys = demo, pkcs11key

7. Save the file and close Notepad
8. Restart Morphon T-o-M