Perl fr OpenVMS Alpha Installatin Guide and Release Ntes January 25, 2002 Perl fr OpenVMS Versin 5.6.1 CPQ-AXPVMS-PERL-V0506-1-1.PCSI-DCX-AXPEXE On this page yu'll find infrmatin abut: Sftware prerequisites Dcumentatin Dwnlading the kit Expanding the kit Upgrading Perl frm an Earlier Versin Installing Perl fr OpenVMS Pst-installatin tasks Remving Perl fr OpenVMS Release ntes Sftware Prerequisites The Perl fr OpenVMS kit requires the fllwing sftware: OpenVMS Alpha Versin 7.2-1 r higher Perl runs with the Cmpaq Secure Web Server fr OpenVMS Alpha via CSWS_PERL. Yu can als use Perl in a standalne mde thrugh the cmmand line. Yu d nt need t install Cmpaq Secure Web Server fr OpenVMS nr CSWS_PERL t use Perl. Dcumentatin Fr mre infrmatin abut Perl, see The Surce fr Perl and Perl Mngers. See the CSWS_PERL fr Cmpaq Secure Web Server fr OpenVMS Alpha Installatin Guide and Release Ntes fr infrmatin abut running CSWS_PERL with Perl and Cmpaq Secure Web Server fr OpenVMS. Perl packages smetimes cntain dcumentatin infrmatin within the package. If the installed package includes dcumentatin, yu can view it by defining the fllwing freign cmmand: $ PERLDOC :== $PERL_ROOT:[000000]PERL.EXE - PERL_ROOT:[LIB.POD]PERLDOC.COM -t Dwnlading the Kit Dwnlad the Perl fr OpenVMS Alpha self-extracting file.
Perl V5.6.1 fr OpenVMS Alpha Perl V5.5-3A2 fr OpenVMS Alpha Make sure the file type f the saved file is.pcsi-dcx-axpexe. Imprtant: A new "ht fix" saveset is available fr Perl V5.5-3A2. If yu are dwnlading Perl V5.5-3A2 r have previusly dwnladed and are using Perl V5.5-3A2, Cmpaq recmmends that yu dwnlad and restre the backup saveset. Instructins are included in the PERL_README.TXT file. Dwnlad the Perl V5.5-3A2 "ht fix" saveset. Perl V5.5-3A2 fr OpenVMS Alpha saveset Perl V5.5-3A2 "ht fix" README file After the saveset has been dwnladed and transferred t yur OpenVMS system, set the RMS file attributes f the saveset file as fllws: $ SET FILE/ATTRIB=(lrl:32256,mrs:32256,rfm:fix)PERL_0505-3A2-1.BCK Then fllw the instructins in the PERL_README.TXT file. Expanding the Kit T expand the Perl fr OpenVMS Alpha self-extracting file, enter ne f the fllwing cmmands, depending n the file yu dwnladed: $ RUN CPQ-AXPVMS-PERL-V0506-1-1.PCSI-DCX-AXPEXE $ RUN CPQ-AXPVMS-PERL-V0505-3A2-1.PCSI-DCX-AXPEXE The system displays infrmatin abut the file cmpressin versin, and help infrmatin abut the cmmand syntax. At the Decmpress int (file specificatin): prmpt, press return. The system expands the file and names the decmpressed file CPQ-AXPVMS-PERL-V0506-1-1.PCSI. D nt rename this file. Upgrading Perl frm an Earlier Versin Yu can install a new Perl fr OpenVMS kit ver an existing versin f Perl. Restart the Cmpaq Secure Web Server fr the new Perl kit t take affect. Imprtant If yu install a new Perl kit t a different lcatin frm an earlier Perl kit using the /DESTINATION qualifier n the PRODUCT INSTALL cmmand line, the new Perl kit will nt wrk with the Cmpaq Secure Web Server unless yu fllw the steps belw. This ccurs because the CSWS_PERL fr Cmpaq Secure Web Server kit (als knwn as MOD_PERL) adds extensins t Perl. Thse extensins, and any user-added extensins, remain in the riginal lcatin. If yu want t install a new Perl kit t a different lcatin, fllw these steps:
1. Save yur CSWS_PERL cnfiguratin file (APACHE$COMMON:[CONF]MOD_PERL.CONF) 2. Make sure the PERL_ROOT lgical name is pinting t the ld Perl lcatin 3. Remve CSWS_PERL 4. Install the new Perl kit t the new lcatin 5. Pint the PERL_ROOT lgical name t the new Perl lcatin 6. Re-install CSWS_PERL 7. Re-install any user-installed Perl extensins 8. Restre yur CSWS_PERL cnfiguratin file Installing Perl fr OpenVMS T install the Perl fr OpenVMS Alpha kit, enter the fllwing cmmand where DISK$DKA0:[APACHE_KITS] is an example f a disk and directry name. $ PRODUCT INSTALL PERL/DESTINATION=DISK$DKA0:[000000] Nte: Perl is nt dependent n the Cmpaq Secure Web Server fr OpenVMS installatin and can reside anywhere n the system. Cmpaq Secure Web Server uses the PERL_ROOT lgical t lcate Perl. Fr a descriptin f the features yu can request with the PRODUCT INSTALL cmmand when starting an installatin such as running the IVP, purging files, and cnfiguring the installatin, see the POLYCENTER Sftware Installatin Utility User's Guide. As the installatin prcedure prgresses, the system displays the fllwing infrmatin. The fllwing prduct has been selected: Layered Prduct D yu want t cntinue? [YES] Cnfiguratin phase starting... Yu will be asked t chse ptins, if any, fr each selected prduct and fr any prducts that may be installed t satisfy sftware dependency requirements. Cmpaq Cmputer Crpratin. * This prduct des nt have any cnfiguratin ptins. Executin phase starting... The fllwing prduct will be installed t destinatin: DKB100:[000000.] Prtin dne: 0%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100% The fllwing prduct has been installed: Layered Prduct Pst-installatin tasks are required fr Perl fr OpenVMS.
The release ntes give detailed directins. This infrmatin is a brief checklist. Perl fr OpenVMS can run standalne, hwever, this kit is a special build that supprts the Cmpaq Secure Web Server. T enable this kit fr use by the web server, the fllwing lgicals must be visible. PERL_ROOT - A rted lgical pinting t the tp level directry f this Perl installatin. PERLSHR - Pinting t the Perl shared image fr this installatin. T run perl scripts in a standalne fashin, define a freign cmmand t run the main Perl executable. PERL := $PERL_ROOT:[000000]PERL.EXE Als, help can be btained frm sme f the Perl mdules (if the authr prvided it). Help can be extracted by defining anther freign cmmand. PERLDOC := $PERL_ROOT:[000000]PERL.EXE - PERL_ROOT:[LIB.POD]PERLDOC.COM -t Pst-Installatin Tasks 1. Define the PERL_ROOT lgical In rder fr the Cmpaq Secure Web Server fr OpenVMS sftware t use Perl (via CSWS_PERL), Perl must be made available t the server prcesses. Tw lgicals are required t lcate this kit fr the Cmpaq Secure Web Server. If n ther versins f Perl are being used n this system, it is recmmended that these lgicals be defined systemwide. Otherwise, the lgicals must be defined as either /GROUP r /JOB by the main server prcess. The PERL_ROOT lgical lcates the tp level directry f the Perl installatin. It is rted and must be a cncealed lgical. Fr example: $ DEFINE/SYSTEM/EXEC/TRANSLATION=CONCEALED - _$ PERL_ROOT DKB100:[.PERL5_006_01.] 2. Define the PERLSHR lgical Once the tp level directry is defined, Cmpaq Secure Web Server fr OpenVMS needs access t the shareable image in this kit (PERLSHR.EXE). By default, OpenVMS lks in SYS$SHARE, but since this kit can be installed anywhere, this lgical is necessary. Fr example: $ DEFINE/SYSTEM/EXEC PERLSHR - _$ PERL_ROOT:[000000]PERLSHR.EXE
Cmpaq Secure Web Server fr OpenVMS is nw able t lcate this installatin f Perl. 3. Define the freign cmmand Perl can als be used in a standalne mde withut Cmpaq Secure Web Server fr OpenVMS. T use Perl in this manner, define a freign cmmand t the Perl main image. Fr example: $ PERL :== $PERL_ROOT:[000000]PERL.EXE Perl scripts can then be executed frm the cmmand line by using this verb and the Perl script name as the parameter. Use the cmmand "Perl -h" t see ther ptins. Remving Perl fr OpenVMS Yu can remve the Perl fr OpenVMS kit by using the POLYCENTER Sftware Installatin utility. Enter the fllwing cmmand: $ PRODUCT REMOVE PERL This cmmand remves all files and directries created by this installatin. Nte that if yu install Perl packages t extend the capabilities f Perl r create additinal files in the installatin area, PCSI will nt have knwledge f these files and will nt delete them. This will cause the directry structure t remain because the directries will nt be cmpletely empty. Sme manual interventin may be needed t cmpletely remve the kit. Release Ntes This sectin cntains ntes n the current release f Perl fr OpenVMS. Prblem crrected: Envirnment variables exceeding 255 characters CSWS_PERL uses lgical names t cntain envirnment variables used by Perl scripts. Previusly, if the equivalence string fr any lgical name exceeded 255 characters, CSWS_PERL terminated with the fllwing errr in APACHE$ROOT:[LOGS]ERROR_LOG: Fatal VMS errr (status=340) at ROOT$:[PERL5_006_01]VMS.C;2 This errr was mst likely t ccur if yur brwser transmits an HTTP_ACCEPT string that exceeds 255 characters. This errr has been crrected in Perl V5.5-3A2 and higher fr OpenVMS. Envirnment variables can nw cntain up t 32,385 characters. If yu have a versin f Perl earlier than V5.5-3A2 installed, install the latest versin, then reinstall CSWS_PERL t crrect this prblem. Tracking versins f Perl and CSWS_PERL
The Perl and CSWS_PERL kits are tightly cnnected. Future versins f Perl r CSWS_PERL may nt interact crrectly acrss versin numbers. This release f Perl wrks with CSWS_PERL V1.1. Multiple versins f Perl Yu can run this kit f Perl n the same system with ther versins f Perl that yu have dwnladed frm the pen surce Perl distributin site. If yu chse t d this, be careful that the Cmpaq Secure Web Server sftware "sees" this versin f Perl. Otherwise, yur web based scripts will nt perate crrectly. The way Cmpaq Secure Web Server "sees" Perl is thrugh lgical names. See Pst-Installatin Tasks fr infrmatin abut hw t set these lgical names. Perl example syntax Sme examples fund in Perl manuals d nt shw the same syntax as that required by this versin f Perl. Cmpaq recmmends that yu use the PERLDOC feature t display the help text (if available) t find the crrect syntax. Perl-status lcatin Thrugh Cmpaq Secure Web Server, the "perl-status" lcatin gives useful infrmatin abut Perl and CSWS_PERL. Part f that wealth f infrmatin requires the Devel::Symdump Perl package t be installed. This kit des nt cntain that package. It can be btained frm CPAN via the web at: http://www.perl.cm.