CSWS_PHP for HP Secure Web Server for OpenVMS (based on Apache) Installation Guide and Release Notes

This document is the Installation Guide and Release Notes for CSWS_PHP V1.3 for HP Secure Web Server on OpenVMS, released in November 2005.

Key features and updates for V1.3:

• It is based on PHP 4.3.10, which includes over 30 non-critical bug fixes and addresses several security issues.
• It incorporates the PHP_GD extension for creating and manipulating image files.
• New kits are available for OpenVMS I64 Version 8.2 and higher, and OpenVMS Alpha 7.3-2 and higher.
• It is intended to work with Secure Web Server (SWS) versions 2.1 and 1.3-1, but not SWS V2.0.

Installation Process:

• Prerequisites: OpenVMS Alpha 7.3-2+ or I64 8.2+, and HP Secure Web Server 1.3-1 or 2.1+.
• Before installing/upgrading: Shut down the Secure Web Server. If upgrading, back up any modified PHP.INI file.
• Command: Use PRODUCT INSTALL CSWS_PHP and ensure it's installed into the same device and directory as the HP Secure Web Server.
• Post-installation: The installer modifies HTTPD.CONF to enable MOD_PHP and runs PHP_SETUP.COM, so no manual configuration of CSWS_PHP is generally required. Restart the Secure Web Server.
• Removal: Shut down SWS, then use PRODUCT REMOVE CSWS_PHP.

Using Extensions:

• CSWS_PHP 1.3 includes various extensions (e.g., ODBC, OCI, OpenVMS specific functions).
• Extensions can be enabled by uncommenting extension= lines in the PHP.INI file (located in APACHE$COMMON:[PHP]) or by using the dl() function in PHP scripts.
• ODBC and OCI extensions require defining specific logical names (APACHE$ODBC_SHR/PFX and APACHE$OCI_SHR/PFX respectively) at the beginning of the APACHE$COMMON:[000000]LOGIN.COM file to make them functional.
• Sample PHP scripts (calendar, info, odbc, openvms) are provided to demonstrate extension usage.

Release Notes and Limitations:

• Logical Name Changes: In CSWS_PHP V1.2 and higher, PHP$ logical names (e.g., PHP$ODBC_SHR) were changed to APACHE$ prefixed names (e.g., APACHE$ODBC_SHR) for better compatibility with other scripting languages.
• Extended Filename Support: For ODS-5 files with extended filenames (multiple dots), specific DECC$EFS_CASE_PRESERVE, DECC$EFS_CASE_SPECIAL, DECC$EFS_CHARSET, and DECC$FILE_SHARING logical definitions must be added to PHP_SETUP.COM.
• DNS Functions: PHP DNS functions CHECKDNSRR and GETMXRR are only supported on systems using HP TCP/IP Services for OpenVMS.
• LINK Functions: LINK, LINKINFO, SYMLINK, and READLINK functions are not supported in this version.