-----------------------------------------------------------------
Installing Apache 2.0 + SSL on Windows
-----------------------------------------------------------------

1. Install Apache2 

    Install the standard Apache by running REPORTER_INSTALL\windows\components\apache\standard\apache_2.0.59-win32-X86-no_ssl.msi.

    Refer to the Netcool/Reporter 2.2.0.0 Administration Guide for details. The root installation directory of Apache is considered APACHE_HOME.

2. Configure SSL

   There are two ways to configure SSL:

   Method 1: Install OpenSSL.

    To do this,

    a. Decompress the file REPORTER_INSTALL\windows\components\apache\SSL\Openssl-0.9.8e-Win.zip

    b. Copy the openssl file under the decompressed root folder to APACHE_HOME\bin.

    c. Copy all three files under the \bin sub-folder to APACHE_HOME\bin.

    d. Copy REPORTER_INSTALL\windows\components\apache\SSL\mod_ssl.so to APACHE_HOME\modules.

    e. Copy REPORTER_INSTALL\windows\components\apache\SSL\ssl.conf to APACHE_HOME\conf.

    f. Copy the files ssleay32.dll and libeay32.dll under the \bin sub-folder to WINNT\System32.


   Method 2: Install SSL compliant Apache

    To do this,

    a. Make a backup copy of the httpd.conf file under APACHE_HOME.

    b. Decompress REPORTER_INSTALL\windows\components\apache\SSL\apache_2.0.59-win32-x86-openssl-0.9.8e.zip to APACHE_HOME. This completes the installation of SSL compliant Apache.

    c. Recover the httpd.conf file, i.e. replace the httpd.conf file under APACHE_HOME with the copy that you backed up in step a.

    d. Copy the files ssleay32.dll and libeay32.dll under the decompressed Openssl \bin sub-folder to WINNT\System32.

3. Edit APACHE_HOME\conf\http.conf
	
    a: Fill in DocumentRoot with the directory path immediately above INFOHOME. For example, if INFOHOME is located at C:\http\htdocs\infospc, fill in DocumentRoot value so that it will appear like:

        DocumentRoot "C:\http\htdocs"

    b: Change <Directory "APACHE_HOME\htdocs"> to the same path value as DocumentRoot, for example, <Directory "C:\http\htdocs">.

    c: Delete # before LoadModule ssl_module modules/mod_ssl.so.
    

4. Edit APACHE_HOME\conf\ssl.conf

    a. Add # before <IfDefine SSL> and <IfDefine>.

    b. Change Listen 443 to Listen SSL_port.

    c. Change <VirtualHost _default_:443> to <VirtualHost SERVERNAME:SSL_port>


5. Create a new certificate for your secure Apache web server

    a. Launch a command window and change the directory to APACHE_HOME\bin.

    b. Run the following commands:

      openssl req -config openssl.cnf -new -out my-server.csr
        This creates a certificate signing request and a private key. When asked for "Common Name (eg, your websites domain name)", give the exact domain name of your web server (e.g. www.my-server.dom). The certificate belongs to this server name and browsers might generate errors if the name does not match.

	openssl rsa -in privkey.pem -out my-server.key
	  This removes the passphrase from the private key. For security reasons, the my-server.key file should be only readable by the apache server and the administrator.
	You must delete the .rnd file because it contains the entropy information for creating the key and could be used for cryptographic attacks against your private key.

	openssl x509 -in my-server.csr -out my-server.cert -req -signkey my-server.key -days 365
	  This creates a self-signed certificate. Optionally, you can apply for a certificate from a certificate authority. If you know your users, you can tell them to install the certificate into their browsers. Note that this certificate expires after one year. You can increase -days 365 if you want to increase the expiration time.

    c. Create an APACHE_HOME/conf/ssl directory and move my-server.key and my-server.cert into it.


-------------------------------
Variable Definitions
-------------------------------

The following variables are referenced throught this file. Their meaning is as follows:

* REPORTER_INSTALL - The path to the Netcool Reporter package.
* INFOHOME - The root installation directory of Netcool/Reporter, for example, C:\http\htdocs\infospc.
* APACHE_HOME - The root installation directory of your Apache.
* SERVERNAME - You web server name.
