Procedure 16.11. Edit Property Files and Setup Redirection

1. Create a directory to store logs, property files, and lock files.

   The rest of this procedure assumes that you are using the directory C:\connectors\ for this purpose. If you use a different directory, modify the instructions accordingly.

2. Create the isapi_redirect.properties file.

   Create a new file called C:\connectors\isapi_redirect.properties. Copy the following contents into the file.

   # Configuration file for the ISAPI Redirector
   # Extension uri definition
   extension_uri=c:\connectors\isapi_redirect.dll
   
   # Full path to the log file for the ISAPI Redirector
   log_file=c:\connectors\isapi_redirect.log
   
   # Log level (debug, info, warn, error or trace)
   # Use debug only testing phase, for production switch to info
   log_level=debug
   
   # Full path to the workers.properties file
   worker_file=c:\connectors\workers.properties
   
   # Full path to the uriworkermap.properties file
   worker_mount_file=c:\connectors\uriworkermap.properties
   
   #Full path to the rewrite.properties file 
   rewrite_rule_file=c:\connectors\rewrite.properties
   

   If you do not want to use a rewrite.properties file, comment out the last line by placing a # character at the beginning of the line. See Step 5 for more information.

3. Create the uriworkermap.properties file

   The uriworkermap.properties file contains mappings between deployed application URLs and which worker handles requests to them. The following example file shows the syntax of the file. Place your uriworkermap.properties file into C:\connectors\.

   # images and css files for path /status are provided by worker01
   /status=worker01
   /images/*=worker01
   /css/*=worker01
   
   # Path /web-console is provided by worker02
   # IIS (customized) error page is used for http errors with number greater or equal to 400
   # css files are provided by worker01
   /web-console/*=worker02;use_server_errors=400
   /web-console/css/*=worker01
   
   # Example of exclusion from mapping, logo.gif won't be displayed  
   # !/web-console/images/logo.gif=*
   
   # Requests to /app-01 or /app-01/something will be routed to worker01
   /app-01|/*=worker01
   
   # Requests to /app-02 or /app-02/something will be routed to worker02
   /app-02|/*=worker02
   

4. Create the workers.properties file.

   The workers.properties file contains mapping definitions between worker labels and server instances. The following example file shows the syntax of the file. Place this file into the C:\connectors\ directory.

   # An entry that lists all the workers defined
   worker.list=worker01, worker02
   
   # Entries that define the host and port associated with these workers
   
   # First JBoss EAP 6 server definition, port 8009 is standard port for AJP in EAP 
   worker.worker01.host=127.0.0.1
   worker.worker01.port=8009
   worker.worker01.type=ajp13
   
   # Second JBoss EAP 6 server definition
   worker.worker02.host= 127.0.0.100
   worker.worker02.port=8009
   worker.worker02.type=ajp13
   

5. Create the rewrite.properties file.

   The rewrite.properties file contains simple URL rewriting rules for specific applications. The rewritten path is specified using name-value pairs, as shown in the example below. Place this file into the C:\connectors\ directory.

   #Simple example
   # Images are accessible under abc path
   /app-01/abc/=/app-01/images/
   

6. Restart the IIS server.

   Restart your IIS server by using the net stop and net start commands.

   C:\> net stop was /Y
   C:\> net start w3svc