How to install CXP with Apache Web Server
Posted: Mon Nov 03, 2014 3:27 pm
These instructions are specifically for Wamp Apache. This is the version of Apache that installs with Wamp Server. Wamp Server includes Apache, PHP and MySQL because this is one of the most popular installations for a variety of applications, including PhpBB3, the Donnay Software Web Forum. However, with minor modifications, these instructions apply to any installation of Apache.
If you follow these installation instructions step-by-step, you should get up and running very quickly.
1. Install Xbase++ 2.0 on a workstation or your server. It is not necessary to have the complete Xbase++ installation on your server. All that is needed on the server is the CXP20 folders.
2. After the Xbase++ 2.0 installation is complete, locate the following folder: C:\Program Files (x86)\Alaska Software\cxp20
3. Create a new folder on your server named C:\cxp20, then copy the entire C:\Program Files (x86)\Alaska Software\cxp20 folder, including sub-directories to the new C:\cxp20 folder on your server.
4. Locate the following folder on your workstation or server: C:\inetpub\wwwroot. If you installed CXP when you installed Xbase++ 2.0, then the installation program will have copied some CXP files to this folder. The file cxpinfo.cxp will be installed to c:\inetpub\wwwroot only if IIS is installed.
5. Locate the following folder on your server: C:\wamp\www. This is the root folder for Apache. It is defined
in the httpd.conf file of Apache as the root folder with the DocumentRoot entry. If you not using WAMP, then it will be defined as a different location.
6a. Copy all *.CXP files in the C:\inetpub\wwwroot folder to the C:\wamp\www folder on your server.
If there is a c:\inetpub\wwwroot\cxp-application folder it does NOT need to be copied to your server. This folder is automatically maintained by CXP. That folder does not even exist if the cxpinfo.cxp page was not executed previously.
6b. Copy the c:\inetpub\wwwroot\websamples folder to the c:\wamp\www folder on your server. The websamples provide a source of information illustrating usage and filling gaps where the documentation is weak.
7. Download the following file from the Apache website: http://www.apache.org/dist/httpd/binari ... 32-x86.zip then extract the mod_fcgid.so file into the C:\wamp\bin\apache\apache2.2.22\modules folder on the server. This is the module that handles FastCGI.
8. Run the C:\cxp20\bin\apachecfg.exe with the following parameters: -i -c=C:\wamp\bin\apache\apache2.2.22 -n=c:\cxp20\bin\cxp-worker.exe. This will create a backup of your c:\wamp\bin\apache\apache2.2.22\conf\httpd.conf file and will add new entries that will enable the CXP system and FastCGI. Hint: apachecfg.exe -h prints the usage of the tool.
9. Stop and restart your wampApache service. Note: this may not be necessary if Apache is already running because apachecfg.exe normally restarts the service. It will only be necessary if you had to make additional modifications to your httpd.conf file (which is not recommended).
10. Open a web browser on your server and navigate to http://localhost/cxpinfo.cxp. This should show your first CXP page. After you confirm that everything is running ok, then navigate to http://localhost/websamples/index.cxp to run the sample selection.
NOTE: If you did not get Apache from the WAMP installation, then the Apache system will have a different installation folder on your server and may also be a different version. The above instructions are for WAMP Apache 2.22.22.
Just modify the instructions to accommodate your directory structure.
KNOWN ANOMOLIES:
When calling the CXP page from the web browser, Apache is case sensitive.
This would not work: DD787.Cxp
This would work: DD787.cxp
The CXP page cannot be given the same name as the root directory.
This will cause an Internal Error: localhost/dd787/dd787.cxp
This will work: localhost/dd787/rsvp787.cxp
If you follow these installation instructions step-by-step, you should get up and running very quickly.
1. Install Xbase++ 2.0 on a workstation or your server. It is not necessary to have the complete Xbase++ installation on your server. All that is needed on the server is the CXP20 folders.
2. After the Xbase++ 2.0 installation is complete, locate the following folder: C:\Program Files (x86)\Alaska Software\cxp20
3. Create a new folder on your server named C:\cxp20, then copy the entire C:\Program Files (x86)\Alaska Software\cxp20 folder, including sub-directories to the new C:\cxp20 folder on your server.
4. Locate the following folder on your workstation or server: C:\inetpub\wwwroot. If you installed CXP when you installed Xbase++ 2.0, then the installation program will have copied some CXP files to this folder. The file cxpinfo.cxp will be installed to c:\inetpub\wwwroot only if IIS is installed.
5. Locate the following folder on your server: C:\wamp\www. This is the root folder for Apache. It is defined
in the httpd.conf file of Apache as the root folder with the DocumentRoot entry. If you not using WAMP, then it will be defined as a different location.
6a. Copy all *.CXP files in the C:\inetpub\wwwroot folder to the C:\wamp\www folder on your server.
If there is a c:\inetpub\wwwroot\cxp-application folder it does NOT need to be copied to your server. This folder is automatically maintained by CXP. That folder does not even exist if the cxpinfo.cxp page was not executed previously.
6b. Copy the c:\inetpub\wwwroot\websamples folder to the c:\wamp\www folder on your server. The websamples provide a source of information illustrating usage and filling gaps where the documentation is weak.
7. Download the following file from the Apache website: http://www.apache.org/dist/httpd/binari ... 32-x86.zip then extract the mod_fcgid.so file into the C:\wamp\bin\apache\apache2.2.22\modules folder on the server. This is the module that handles FastCGI.
8. Run the C:\cxp20\bin\apachecfg.exe with the following parameters: -i -c=C:\wamp\bin\apache\apache2.2.22 -n=c:\cxp20\bin\cxp-worker.exe. This will create a backup of your c:\wamp\bin\apache\apache2.2.22\conf\httpd.conf file and will add new entries that will enable the CXP system and FastCGI. Hint: apachecfg.exe -h prints the usage of the tool.
9. Stop and restart your wampApache service. Note: this may not be necessary if Apache is already running because apachecfg.exe normally restarts the service. It will only be necessary if you had to make additional modifications to your httpd.conf file (which is not recommended).
10. Open a web browser on your server and navigate to http://localhost/cxpinfo.cxp. This should show your first CXP page. After you confirm that everything is running ok, then navigate to http://localhost/websamples/index.cxp to run the sample selection.
NOTE: If you did not get Apache from the WAMP installation, then the Apache system will have a different installation folder on your server and may also be a different version. The above instructions are for WAMP Apache 2.22.22.
Just modify the instructions to accommodate your directory structure.
KNOWN ANOMOLIES:
When calling the CXP page from the web browser, Apache is case sensitive.
This would not work: DD787.Cxp
This would work: DD787.cxp
The CXP page cannot be given the same name as the root directory.
This will cause an Internal Error: localhost/dd787/dd787.cxp
This will work: localhost/dd787/rsvp787.cxp