HOWTO: Install StrongKey on Linux or Windows

For a TEST environment, it is recommended that you create a Windows/Linux user called “symkey” to own and execute all the following software. This will keep everything organized, and distinct, under a single user ID. While on a Linux machine,this user ID will not need to be “root”, on a Windows machine, this user will need to have Administrator access to install software.

Since the installation instructions are mostly identical for both the platforms, the documentation will use the Linux style in discussing filenames and directory paths. However, Windows users must use the drive-letter and the windows-style notation in the place of the Linux style notation, in such cases.

When the documentation refers to /usr/local/etc/symkey/, the Windows user should substitute this for c:\usr\local\etc\symkey (assuming you've installed StrongKey on the C: drive; if not, use the appropriate drive-letter).

In order to simplify setup, we recommend creating the following directories ahead of time for the installation of the software. While these are non-traditional names for Windows, we recommend its use to stay consistent with StrongKey's primary development/deployment environment (Linux). It helps us keep our support costs low and focuses us on the capability of StrongKey, rather than on each OS vendor's conventions. In the long term, we believe you will agree that it will provide you greater quality of support at lower costs.

Note: If you are willing to go the extra distance to make your environment more productive with the use of StrongKey, we encourage you to install Cygwin on your Windows PC. Cygwin provides a number of Linux-like tools that make the support and debugging of StrongKey significantly easier. It does not, in any way, interfere with your standard Windows applications or environment. You can find the latest versions of Cygwin at www.cygwin.com.

The directories that need to be created are:

1. Download and install MySQL 5.0 (Windows Essentials x86) from
   http://dev.mysql.com/downloads/mysql/5.0.html.

   For more information on how to install MySQL 5.0, please refer to the document below.

   howto-install-mysql5-linux.html (Linux)

   howto-install-mysql5-windows.html (Windows)

    

2. Download and install JDK 5.0 (Update 7 at the time of writing) – also known as J2SE5 - from http://java.sun.com/j2se/1.5.0/download.jsp.

   Also download the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 5.0 from the same location.

   For more information, please refer to the document below.

   howto-install-jdk1.5.0-linux.html (Linux)

   howto-install-jdk1.5.0-windows.html (Windows)

    

3. Download, install and configure the Sun Java System Application Server PE 8.2 from http://java.sun.com/j2ee/1.4/download.html#sdk.

   For more information on how to install Sun Java System Application Server PE 8.2, please refer to the document below.

   howto-install-sjsas82-linux.html (Linux)

   howto-install-sjsas82-windows.html (Windows)

    

4. Download, install and configure the Java Web Services Developer Pack 2.0 from http://java.sun.com/webservices/downloads/webservicespack.html

   You will need to find a line on this page indicating Java WSDP with a Download button associated with it; click on the Download button to find the actual download.

   For more information on how to install Java Web Services Developer Pack 2.0, please refer to the document below.

   howto-install-jwsdp20-linux.html (Linux)

   howto-install-jwsdp20-windows.html (Windows)

    

5. Configure the SJSAS82 to connect to the MySQL Database using a JDBC driver.

   For more information, please refer to the document below.

   howto-config-appserv-db.html

    

6. Create the symkey schema.

   For more information, please refer to the document below.

   howto-create-schema.html

    

7. Deploy the StrongKey EAR (enterprise archive) file.

   For more information, please refer to the document below.

   howto-deploy-symkey-ear.html

    

8. Install the Symmetric Key Client Library (SKCL)

   For more information, please refer to the document below.

   howto-install-skcl.html

    

9. Seed the TEST environment with the test objects provided in the CLI utility.

   For more information, please refer to the document below.

   howto-run-cli.html

    

10. Test the Symkey Client Library (SKCL) using the xenc utility.

    For more information, please refer to the document below.

    howto-run-xenc.html

     

11. Install and Configure the StrongKey Administration GUI

    For more information, please refer to the document below.

    howto-install-gui.html

     

12. If you plan on reviewing and/or modifying the StrongKey source-code, we recommend the NetBeans 5.0 IDE. StrongKey source is available as a NetBeans project to facilitate software development with the SKCL API. (Note: Eclipse users, please be patient, as we intend to deliver StrongKey as an Eclipse project too).

    Download and install the IDE from http://www.netbeans.org/.

    For more information, please refer to the document below.

    howto-install-netbeans.html

     

13. Build the StrongKey distribution from source.

    howto-build-strongkey.html