ActiveState® PerlEx and FastCGI are two technologies that can boost the performance of BMC FootPrints Service Core, and are available for use with the application. FastCGI is available on all supported platforms, and PerlEx is available in Windows 32-bit. The technology can be compared to an automobile. The default BMC FootPrints Service Core installation uses CGI which is akin to starting up a car and pressing the accelerator every time a page is viewed. FastCGI and PerlEx leave the car running, so that the initial step of starting the car can be avoided on each page view. Below are the steps an administrator must complete before enabling either acceleration technology.
In following the steps below, c:\FootprintsServiceCore or /usr/local/footprintsservicecore refers to the "base install location" (i.e. "where BMC FootPrints Service Core is installed") of BMC FootPrints Service Core. By default, this would be c:\FootprintsServiceCore on a Windows server and /usr/local/footprintsservicecore on a Unix or Linux server. When performing the steps below, please adjust the path accordingly for the actual "base install location" of BMC FootPrints Service Core in your environment.
NOTE
PerlEx for FootPrints is only available on 32-bit Windows operating systems.
If both PerlEx and FastCGI are enabled, the PerlEx technology will take precedence and override the use of FastCGI. It is NOT recommended to turn on both technologies.
PerlEx
Before You Enable PerlEx
The following are necessary preconditions for PerlEx
to function correctly. While
this setup is automated for BMC FootPrints Service Core, users should check to ensure
that the setup functioned properly:
Make sure permissions
are correct by running MRchangePermissions.pl in the \Footprints\cgi\ directory.
For example:
Make sure .plex is
mapped to \footprints\bin\perl\bin\PerlEx30.dll in application mappings and allow all verbs. To
do so:
In IIS, select web
site->default web site->MRcgi, then right-click on Properties
and select
Configuration.
Extension should
be .plex and the executable path should be \footprints\bin\perl\bin\PerlEx30.dll;
allow all verbs.
For IIS 6.0+ only,
Web Service Extensions should have a PerlEx ISAPI Extension that maps
.plex to \footprints\bin\perl\bin\PerlEx30.dll and it should be set to
”allowed” (earlier versions of IIS do not have a Web Service Extensions
section).
For IIS 6.0+ only,
reset the default application pool (earlier versions do not have application
pools) and web site after any changes. To do this from a command prompt, enter iisreset.exe and press enter.
Enabling PerlEx in BMC FootPrints Service Core
To enable PerlEx in BMC FootPrints Service Core:
Select Administration
| System from the BMC FootPrints Service Core Toolbar, then select PerlEx/FastCGI from the Features
section of the System Administration page. The
PerlEx/FastCGI page is displayed.
In the PerlEx section of the page, click the Test
PerlEx button to test whether PerlEx and IIS are properly configured.
Do not
enable PerlEx unless your system passes the test successfully.
If your system
successfully passes the test, click the Enabled radio button.
Enter the System
Administration password in the space provided and click the Save
button.
Reset the PerlEx Process
A button is provided for resetting the PerlEx process.
Use this
button only if BMC Support tells you to use it.
Switching from PerlEx to FastCGI
To change from the PerlEx engine to the FastCGI engine:
Select Administration
| System from the BMC FootPrints Service Core Toolbar, then select PerlEx/FastCGI from the Features
section of the System Administration page. The
PerlEx/FastCGI page is displayed.
In the PerlEx section of the page, click the Disabled radio button.
Enter the System
Administration password in the space provided and click the Save button.
FastCGI
Windows Server 2003 and 2003 R2 with IIS 6 (32-bit and 64-bit)
BMC FootPrints Service Core FastCGI on this platform requires the IIS FastCGI extension, and a URL rewriting mechanism (we recommend Ionic's ISAPI Rewrite Filter [IIRF]). These instructions are for a system that currently does not have any other FastCGI applications installed . If there are other FastCGI applications running on this machine, please contact BMC Support for further assistance.
Install and Configure Fast CGI, and Enable in IIS
Install FastCGI for IIS 6.0 by using the Web Platform Installer (WPI) at this address: http://www.iis.net/download/fastcgi.
Configure FastCGI by editing the fcgiext.ini file in the "<Windows Root>\system32\inetsrv" directory. Remove the entire contents of this file, and add the following to the end:
Open up the IIS manager (Start -> Run -> inetmgr.exe), and right-click the 'MRcgi' virtual directory item. Open the 'Properties' window from this menu.
Click on the 'Virtual Directory' tab, and then click the 'Configuration' button.
Click the 'Add' button on the 'Mappings' tab to add a new extension mapping.
Set the executable field to:
<Windows Root>\system32\inetsrv\fcgiext.dll
Set the extension field to:
.fcgi
Press the OK button.
Install the URL Rewriting Mechanism (IIRF)
The following instructions describe how to install the URL rewriting mechanism, Ionic's ISAPI Rewrite Filter (IIRF), that will rewrite URLs, for example:
Install IIRF by following the steps on Iconic's installation wizard.
Configure IIRF
Right-click the 'IIRF.dll' file and click 'Properties'.
Under the 'Security' tab, verify that the IIS web group has read and execute privileges on the file (by default the group is called IIS_WPG).
Once the permissions have been verified, start up the IIS manager: Start -> Run, enter inetmgr.exe and then click the OK button. Right-click the website that is running BMC FootPrints Service Core (by default it will be 'Default Web Site') and click 'Properties'.
Click the 'ISAPI Filters' tab, and click the 'Add' button. For 'Filter Name', enter 'IIRF' or some other uniquely identifiable name. For 'Executable', click the Browse button and choose the 'IIRF.dll' file in the IIRF bin directory.
Copy the IIRF.template file from the 'etc' directory into the cgi directory. Rename this file IIRF.ini. Edit the file and change the line that says RewriteEngine OFF to RewriteEngine ON. If you have previously done this, and have made changes to this file, make sure that the changes are propagated to the new copy.
Restart the web server (Start -> Run -> iisreset.exe), and then visit this URL: http://localhost/iirfStatus. The server name ('localhost' in this example) should be switched with the name of the server running BMC FootPrints Service Core. If IIRF is working properly, you will see a status screen describing the IIRF instance that is currently running.
On the 'System Administration' page in BMC FootPrints Service Core, click the 'PerlEx' or the 'FastCGI' page. Verify that FastCGI is active (it will be stated in the FastCGI section).
To Disable FastCGI
To disable FastCGI, edit the 'IIRF.ini' file located in the 'cgi' directory of BMC FootPrints Service Core, and change the line that says 'RewriteEngine ON' to 'RewriteEngine OFF'.
Windows Server 2008 and 2008 R2 with IIS 7.x (32-bit and 64-bit)
BMC FootPrints Service Core FastCGI on this platform requires the IIS FastCGI extension (which should be enabled already), and URL Rewrite 2.0 from Microsoft. These instructions are for a system that currently does not have any other FastCGI applications installed. If there are other FastCGI applications running on this machine, please contact BMC Support for further assistance.
NOTE FOR WINDOWS SERVER 2008 SP1 and SP2 (does not apply to Windows Server 2008 R2)
A default installation of Windows Server 2008 SP1 and SP2 requires a hotfix from Microsoft in order for FastCGI to run properly. The hotfix from Microsoft is available through the following Microsoft KB article:
In addition, a package must be installed on the Windows Server 2008 host to enable the "FastCGI Settings" IIS option. The package can be installed from this URL:
After applying the hotfix and the Administration Pack, run the MRconfigFastCGI.pl script, as indicated in step 2 below.
The FastCGI Settings, as identified in Step 5 below, will be available after installing the Administration Pack, but there is no option for the 'Standard Error Mode' setting. After executing the MRconfigFastCGI.pl script, the Windows Administrator can check the C:\Windows\System32\inetsrv\config\applicationHost.config file for the proper configuration of FastCGI. The correct configuration in this file is as follows:
A script is available to automatically enable FastCGI for BMC FootPrints Service Core on this platform configuration. To execute the script, open a shell (Run -> ‘cmd.exe’) and navigate to the ‘cgi’ directory inside the BMC FootPrints Service Core application directory. Execute the following command, and adjust the paths to match the BMC FootPrints Service Core installation on this machine.
The script will present you with a menu of options. Select ‘Enable FastCGI’. If this script successfully executes, skip to step 7 and verify that FastCGI is active. If the script failed to run properly, or if you would like to manually enable FastCGI, continue on to step 4.
Add the FastCGI module mapping for IIS.
Go to 'Start -> Run -> inetmgr.exe', and click on the 'MRcgi' virtual directory in the tree in the left pane.
In the right pane, double-click the 'Handler Mappings' icon. Right-click in the mapping list and select 'Add module mapping'.
For the 'Request Path' field enter:
*.fcgi
In the 'Module' dropdown select 'FastCgiModule'. For the 'Executable' field, enter the following value and be sure to update the paths to match the actual BMC FootPrints Service Core installation on this machine:
When you complete the above dialog, you will be presented with another dialog asking if a FastCGI application should be created for this mapping. Answer ‘Yes’ to this dialog.
Configure the FastCGI application:
In the left pane of the IIS administration window, click on the item representing the entire computer or host (it will normally be at the top level of the tree under ‘Start Page’).
In the right pane, double-click the ‘FastCGI Settings’ icon.
Double-click the row on this page that has ‘CentralDispatch.fcgi’ listed in the Arguments column (the path to CentralDispatch.fcgi will also be present in the same column).
Set the ‘Standard Error Mode’ setting to IgnoreAndReturn200.
Set the ‘Activity Timeout’ to 70.
Set ‘Instance MaxRequests’ to 3000.
Set ‘Max Instances’ to 5.
All of the other settings can be left at their default values.
Configure URL Rewrite for FastCGI.
Go to Start -> Run -> inetmgr.exe, and click on the 'MRcgi' virtual directory in the tree in the left pane.
In the right pane, double-click the 'URL Rewrite' icon. Right-click in the 'Inbound Rule List' (the top section) and select 'Add Rule'.
Select to create a blank rule. You must give the rule a name.
'Requested URL' should be set to 'Matches the Pattern', and 'Using' should be set to 'Regular Expressions'. The 'Pattern' field should be set to:
/?(\w+\.pl)(?!ex)
Make sure the 'Ignore Case' checkbox is checked.
Inside the 'Conditions' section, make sure that the 'Logical grouping' field is set to 'Match All', and click the 'Add' button. The 'Condition Input' is set to:
{R:1}
'Check if input string' should be set to 'Matches the Pattern'.
The 'Pattern' field should be set to the following (this is all one string without spaces or breaks):
In the 'Action' section, set the 'Action Type' to 'Rewrite' and the 'Rewrite URL' to:
/MRcgi/CentralDispatch.fcgi?dispatch_script={R:1}
Make sure the 'Append query string' checkbox is checked, and that the 'Log rewritten URL' checkbox is unchecked.
Make sure that the 'Stop processing of subsequent rules' checkbox is checked.
Click the 'Apply' link on the right under 'Actions'.
Visit the 'System Administration' page in BMC FootPrints Service Core, and click on the 'PerlEx' or the 'FastCGI' page. Verify that FastCGI is active (it will be stated in the FastCGI section).
To disable FastCGI, click on the rewrite rule in the 'Inbound Rule List' and select 'Disable Rule' from the actions menu on the right.
Unix/Linux with Apache 2 (32-bit or 64-bit)
BMC FootPrints Service Core FastCGI on a Unix/Linux with Apache 2 (32-bit or 64-bit) platform requires installing and activating the mod_fcgid and mod_rewrite Apache modules before performing the procedure below. These instructions are for a system that does not have any existing FastCGI applications running. If FastCGI applications are running on the same machine as the one on which you are installing BMC FootPrints Service Core, contact BMC Support for further assistance.
Make sure that the following are installed:
Apache Development package (httpd-devel)
Apache Portable Runtime (apr)
Apache Portable Runtime Development package (apr-devel)
Unpack tarball and change directory to the unpack directory.
Run:
./configure.apxs
Run:
make
Run:
make install
The `make install` inserts a line into the httpd.conf file to load the newly built module:
LoadModule fcgid_module modules/mod_fcgid.so
Run:
mkdir /var/run/fcgidsock
chown apache:root /var/run/fcgidsock
chmod 700 /var/run/fcgidsock
Edit the BMC FootPrints Service Core Apache configuration file and add the following information to the end of the file. You cannot cut and paste these instructions. You must change the path of the LoadModule directive and the path of the BMC FootPrints Service Core application directory (<Directory "/usr/local/footprintsservicecore/cgi">) in the instructions to match your system:
In BMC FootPrints Service Core, select Administration | System from the toolbar, then select Perlex/FastCGI from the Administration page.
In the FastCGI Setup section of the administration page, verify that FastCGI is active.
To disable FastCGI, set the 'RewriteEngine on' line in the configuration file to 'RewriteEngine off'.
By default, the communications sockets reside in the Apache logs/fcgidsock directory, which is accessible only by root and not by child Apache processes. In this default configuration, a FastCGI process can never create the communications socket, resulting in a "Service Unavailable" message. In order for the default configuration to work, you can add an execute bit for the "other" group (permissions change from 700 to 701) on the/var/log/httpd directory. However, this creates two other problems:
Adding this execute bit allows all other users the ability to change directory into /var/log/httpd.
If the Apache program is updated via OS means (yum update httpd), there is a very good chance that the update could alter the file system permissions changes that allow FastCGI to function.
When configuring the mod_fcgid module in Apache, there are directives which allow the communications sockets to be placed in an alternate directory. The communications socket directive should be pointed at a directory in /var/run (numerous other applications use this same directory structure to store their PID and socket files).