home *** CD-ROM | disk | FTP | other *** search
/ Netrunner 2004 October / NETRUNNER0410.ISO / regular / ActivePerl-5.8.4.810-MSWin32-x86.msi / _815c9c87ac45a92b805fdcf79ecf8865 < prev    next >
Encoding:
Text File  |  2004-06-01  |  21.6 KB  |  554 lines
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  2.  
  3. <HTML>
  4. <HEAD>
  5. <TITLE>ActivePerl 5.8.4.810 -- Installation Guide</TITLE>
  6. <LINK REL="stylesheet" HREF="Active.css" TYPE="text/css">
  7. </HEAD>
  8.  
  9. <BODY>
  10.  
  11. <table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="#EAE2BB">
  12. <tr> 
  13. <td width="57"><a target=_blank href="http://www.ActiveState.com/ActivePerl/">
  14. <img src="images/activeperl_logo.gif" width="57" height="48" border="0" alt="ActivePerl"></a></td>
  15. <td><div align="center" class="heading">ActivePerl User Guide</div></td>
  16. <td width="112"><a target=_blank  href="http://www.ActiveState.com">
  17. <img src="images/AS_logo.gif" width="112" height="48" border="0"  alt="ActiveState" /></a></td>
  18. </tr>
  19. <tr>
  20. <td class="lineColour" colspan="3"></td>
  21. </tr>
  22. </table>
  23.  
  24. <h1>Installing ActivePerl</h1>
  25.  
  26. <A NAME="__index__"></A>
  27. <!-- INDEX BEGIN -->
  28.  
  29. <UL>
  30.  
  31.     <LI><A HREF="#activeperl 5.8.4.810  installation guide">ActivePerl 5.8.4.810 - Installation Guide</A></LI>
  32.     <UL>
  33.  
  34.         <LI><A HREF="#installing activeperl on linux (x86)">Installing ActivePerl on Linux (x86)</A></LI>
  35.         <UL>
  36.  
  37.             <LI><A HREF="#linux prerequisites">Linux Prerequisites</A></LI>
  38.             <LI><A HREF="#linux installers">Linux Installers</A></LI>
  39.             <LI><A HREF="#linux configuration">Linux Configuration</A></LI>
  40.             <LI><A HREF="#uninstalling activeperl on linux">Uninstalling ActivePerl on Linux</A></LI>
  41.         </UL>
  42.  
  43.         <LI><A HREF="#installing activeperl on solaris (sparc)">Installing ActivePerl on Solaris (sparc)</A></LI>
  44.         <UL>
  45.  
  46.             <LI><A HREF="#solaris prerequisites">Solaris Prerequisites</A></LI>
  47.             <LI><A HREF="#solaris installers">Solaris Installers</A></LI>
  48.             <LI><A HREF="#solaris configuration">Solaris Configuration</A></LI>
  49.             <LI><A HREF="#uninstalling activeperl on solaris">Uninstalling ActivePerl on Solaris</A></LI>
  50.         </UL>
  51.  
  52.         <LI><A HREF="#installing activeperl on windows (x86)">Installing ActivePerl on Windows (x86)</A></LI>
  53.         <UL>
  54.  
  55.             <LI><A HREF="#windows prerequisites">Windows Prerequisites</A></LI>
  56.       <li><a href="#upgrade_56">Upgrading from ActivePerl 5.6.x</a></li>
  57.       <li><a href="#upgrade_58">Upgrading from ActivePerl 5.8.x</a></li>
  58.             <LI><A HREF="#windows installers">Windows Installers</A></LI>
  59.             <LI><A HREF="#windows configuration">Windows Configuration</A></LI>
  60.             <LI><A HREF="#uninstalling activeperl on windows">Uninstalling ActivePerl on Windows</A></LI>
  61.         </UL>
  62.  
  63.     </UL>
  64.  
  65. </UL>
  66. <!-- INDEX END -->
  67.  
  68. <HR>
  69. <P>
  70.  
  71. <P>Welcome, and thanks for downloading ActivePerl.  This release corresponds
  72. to Perl version 5.8.1.</P>
  73. <P>Please note that ActivePerl 800 series builds are NOT binary-compatible with
  74. the older 600 and 500 series builds.  In particular, do not attempt to use extensions
  75. or PPM packages built for the 500 and 600 series builds with ActivePerl 800 series
  76. builds and vice versa.</P>
  77. <P>Binaries for the following platforms are available:</P>
  78. <UL>
  79. <LI>
  80. Linux x86 for Red Hat 6.2 or later
  81. <P></P>
  82. <LI>
  83. Linux x86 for Debian 2.2 or later
  84. <P></P>
  85. <LI>
  86. Solaris sparc for Solaris 2.6 or later
  87. <P></P>
  88. <LI>
  89. Windows x86 for Windows 9x, NT, Me, 2000 and 2003
  90. <P></P></UL>
  91. <P>
  92. <H2><A NAME="installing activeperl on linux (x86)">Installing ActivePerl on Linux (x86)</A></H2>
  93. <P>
  94. <H3><A NAME="linux prerequisites">Linux Prerequisites</A></H3>
  95. <UL>
  96. <LI>
  97. Hardware: 75 MB hard disk space for typical install
  98. <P></P>
  99. <LI>
  100. Operating System: Red Hat 6.2 or later, Debian 2.2 or later
  101. <P></P>
  102. <LI>
  103. Online Help: Web browser
  104. <P></P>
  105. <LI>
  106. Perl Environment Variables: if you have set Perl environment variables such 
  107. as <CODE>PERLLIB</CODE>, <CODE>PERL5LIB</CODE> or <CODE>PERL5OPT</CODE>, you should unset them before 
  108. installing ActivePerl.  Otherwise, these variables may cause incompatible 
  109. versions of Perl modules to be used during the installation process.
  110. <P></P></UL>
  111. <P>
  112. <H3><A NAME="linux installers">Linux Installers</A></H3>
  113. <DL>
  114. <DT><STRONG><A NAME="item_RPM_Package_for_Red_Hat_6%2E2_or_later">RPM Package for Red Hat 6.2 or later</A></STRONG><BR>
  115. <DD>
  116. The Red Hat compatible package is in RPM format.  This should be installed
  117. as root, using the following command:
  118. <PRE>
  119.     % rpm -i ActivePerl-5.8.4.810-i686-linux.rpm</PRE>
  120. <P>This will install ActivePerl into /usr/local/ActivePerl-5.8.  If you
  121. wish to change the default install location, use the <CODE>--prefix</CODE> option 
  122. as follows:</P>
  123. <PRE>
  124.     % rpm -i --prefix /opt/ActivePerl-5.8 ActivePerl-5.8.4.810-i686-linux.rpm</PRE>
  125. <P>To uninstall Activeperl, run:</P>
  126. <PRE>
  127.     % rpm -e ActivePerl</PRE>
  128. <P>The RPM package has only been tested with Red Hat 6.2, but is expected to be
  129. compatible with other Red Hat 6.2 compatible installations as well.</P>
  130. <P></P>
  131. <DT><STRONG><A NAME="item_DPKG_Package_for_Debian_2%2E2_or_later">DPKG Package for Debian 2.2 or later</A></STRONG><BR>
  132. <DD>
  133. The Debian-compatible package is in dpkg format.  This should be installed
  134. as root, using the following command:
  135. <PRE>
  136.     % dpkg -i ActivePerl-5.8.4.810-i686-linux.deb</PRE>
  137. <P>This will install ActivePerl into /usr/local/ActivePerl-5.8.  The dpkg
  138. installation package has no mechanism to change the default installation
  139. location.  Consider installing ActivePerl using the ActivePerl Generic
  140. Installer or the RPM package if you need this.</P>
  141. <P>To uninstall ActivePerl, run:</P>
  142. <PRE>
  143.     % dpkg -r ActivePerl</PRE>
  144. <P>The Debian package has only been tested with Debian 2.2, but is expected
  145. to be compatible with other Debian 2.2 compatible installations as well.</P>
  146. <P></P>
  147. <DT><STRONG><A NAME="item_Generic_AS_Package_for_Linux">Generic AS Package for Linux</A></STRONG><BR>
  148. <DD>
  149. The generic installer allows installation as an unprivileged user 
  150. into a user-specified path. GNU tar is required for extracting the files.
  151. See ``Known Issues'' in the ActivePerl Release Notes for details.
  152. <P>Download the distribution to a temporary directory, extract the files,
  153. chdir to the ActivePerl directory and then run the script ``install.sh''.
  154. The installation script will prompt you for the target installation
  155. directory.</P>
  156. <PRE>
  157.     % tar zxf ActivePerl-5.8.4.810-i686-linux.tar.gz
  158.     % cd ActivePerl-5.8.4.810
  159.     % ./install.sh</PRE>
  160. <P></P></DL>
  161. <P>
  162. <H3><A NAME="linux configuration">Linux Configuration</A></H3>
  163. <P>The Red Hat and Debian packages are installed into the
  164. /usr/local/ActivePerl-5.8 directory.  Add the /usr/local/ActivePerl-5.8/bin
  165. directory to your PATH environment variable to conveniently access it.
  166. For example, in the C shell:</P>
  167. <PRE>
  168.     % setenv PATH /usr/local/ActivePerl-5.8/bin:$PATH</PRE>
  169. <P>The ActivePerl Generic installer allows you to install the package anywhere
  170. that the user has write permission.  Add the bin directory to your PATH
  171. environment variable to conveniently access it.  For example, in the
  172. C shell (assuming you installed into /home/larry/ActivePerl-5.8):</P>
  173. <PRE>
  174.     % setenv PATH /home/larry/ActivePerl-5.8/bin:$PATH</PRE>
  175. <P>
  176. <H3><A NAME="uninstalling activeperl on linux">Uninstalling ActivePerl on Linux</A></H3>
  177. <DL>
  178. <DT><STRONG><A NAME="item_Debian_Package">Debian Package</A></STRONG><BR>
  179. <DD>
  180. If you installed ActivePerl using the DPKG format installer, uninstall 
  181. as follows:
  182. <PRE>
  183.     dpkg -r ActivePerl</PRE>
  184. <P></P>
  185. <DT><STRONG><A NAME="item_RPM_Package">RPM Package</A></STRONG><BR>
  186. <DD>
  187. If you installed ActivePerl using the RPM format installer, uninstall 
  188. as follows:
  189. <PRE>
  190.     rpm -e ActivePerl</PRE>
  191. <P></P>
  192. <DT><STRONG><A NAME="item_AS_Package">AS Package</A></STRONG><BR>
  193. <DD>
  194. If you installed ActivePerl using the AS format installer, remove the directory 
  195. into which ActivePerl was installed. For example:
  196. <PRE>
  197.     /bin/rm -rf /usr/local/ActivePerl-5.8</PRE>
  198. <P></P></DL>
  199. <P>
  200. <H2><A NAME="installing activeperl on solaris (sparc)">Installing ActivePerl on Solaris (sparc)</A></H2>
  201. <P>
  202. <H3><A NAME="solaris prerequisites">Solaris Prerequisites</A></H3>
  203. <UL>
  204. <LI>
  205. Hardware: 75 MB hard disk space for typical install
  206. <P></P>
  207. <LI>
  208. Operating System: Solaris 2.6 or later
  209. <P></P>
  210. <LI>
  211. Online Help: Web browser
  212. <P></P>
  213. <LI>
  214. Perl Environment Variables: if you have set Perl environment variables such 
  215. as <CODE>PERLLIB</CODE>, <CODE>PERL5LIB</CODE> or <CODE>PERL5OPT</CODE>, you should unset them before 
  216. installing ActivePerl.  Otherwise, these variables may cause incompatible 
  217. versions of Perl modules to be used during the installation process.
  218. <P></P></UL>
  219. <P>
  220. <H3><A NAME="solaris installers">Solaris Installers</A></H3>
  221. <DL>
  222. <DT><STRONG><A NAME="item_PKGADD_Package">PKGADD Package</A></STRONG><BR>
  223. <DD>
  224. The Solaris package is in pkgadd format.  This should be installed
  225. as root, using the following commands:
  226. <PRE>
  227.     % gunzip ActivePerl-5.8.4.810-sun4-solaris.pkg.gz
  228.     % pkgadd -d ActivePerl-5.8.4.810-sun4-solaris.pkg</PRE>
  229. <P>pkgadd will query you for the installation location, which can be
  230. changed from the default of /usr/local/ActivePerl-5.8.</P>
  231. <P>To uninstall ActivePerl, run:</P>
  232. <PRE>
  233.     % pkgrm ASperl</PRE>
  234. <P>This package has only been tested with Solaris 2.6, but is expected to be
  235. compatible with other Solaris 2.6 compatible installations as well,
  236. including Solaris 2.7 and Solaris 2.8.</P>
  237. <P></P>
  238. <DT><STRONG><A NAME="item_Generic_AS_Package_for_Solaris">Generic AS Package for Solaris</A></STRONG><BR>
  239. <DD>
  240. The Generic Installer allows installation as an unprivileged user, and
  241. into a user-specified path. GNU tar is required for extracting the files. 
  242. See ``Known Issues'' in the ActivePerl Release Notes for details.
  243. <P>Download the distribution to a temporary directory, extract the files,
  244. chdir to the ActivePerl directory and then run the script ``install.sh''.
  245. The installation script will prompt you for the target installation
  246. directory.</P>
  247. <PRE>
  248.     % tar zxf ActivePerl-5.8.4.810-sun4-solaris.tar.gz
  249.     % cd ActivePerl-5.8.4.810
  250.     % ./install.sh</PRE>
  251. <P></P></DL>
  252. <P>
  253. <H3><A NAME="solaris configuration">Solaris Configuration</A></H3>
  254. <P>The Solaris package is installed into the /usr/local/ActivePerl-5.8 directory.  
  255. Add the /usr/local/ActivePerl-5.8/bin directory to your PATH environment 
  256. variable to conveniently access it. For example, in the C shell:</P>
  257. <PRE>
  258.     % setenv PATH /usr/local/ActivePerl-5.8/bin:$PATH</PRE>
  259. <P>The ActivePerl Generic installer allows you to install the package anywhere
  260. that the user has write permission.  Add the bin directory to your PATH
  261. environment variable to conveniently access it.  For example, in the
  262. C shell (assuming you installed into /home/larry/ActivePerl-5.8):</P>
  263. <PRE>
  264.     % setenv PATH /home/larry/ActivePerl-5.8/bin:$PATH</PRE>
  265. <P>
  266. <H3><A NAME="uninstalling activeperl on solaris">Uninstalling ActivePerl on Solaris</A></H3>
  267. <DL>
  268. <DT><STRONG>PKGADD Package</STRONG><BR>
  269. <DD>
  270. If you installed ActivePerl using the PKGADD format installer, 
  271. uninstall as follows:
  272. <PRE>
  273.     pkgrm -d ASperl</PRE>
  274. <P></P>
  275. <DT><STRONG>AS Package</STRONG><BR>
  276. <DD>
  277. If you installed ActivePerl using the AS format installer, remove the 
  278. directory into which ActivePerl was installed. For example:
  279. <PRE>
  280.     /bin/rm -rf /usr/local/ActivePerl-5.8</PRE>
  281. <P></P></DL>
  282. <P>
  283. <H2><A NAME="installing activeperl on windows (x86)">Installing ActivePerl on Windows (x86)</A></H2>
  284. <P>
  285. <H3><A NAME="windows prerequisites">Windows Prerequisites</A></H3>
  286. <UL>
  287. <LI>
  288. <STRONG>Hardware</STRONG>: 75 MB hard disk space for typical install
  289. <P></P>
  290. <LI>
  291. <STRONG>Perl for ISAPI</STRONG>: requires an ISAPI-compatible web server, such as IIS 4.0 
  292. or greater, or PWS 4.0 or greater
  293. <P></P>
  294. <LI>
  295. <STRONG>PerlScript</STRONG>: requires an ActiveX scripting host such as Internet Explorer 
  296. 4.0 or greater or Windows Scripting Host
  297. <P></P>
  298. <LI>
  299. <STRONG>Perl Environment Variables</STRONG>: if Perl environment variables such as <CODE>PERLLIB</CODE>, 
  300. <CODE>PERL5LIB</CODE> or <CODE>PERL5OPT</CODE> have been set on your system, you should unset them 
  301. before installing ActivePerl.  Otherwise, these variables may cause incompatible 
  302. versions of Perl modules to be used during the installation process.
  303. <P></P>
  304. <LI>
  305. <STRONG>System Account</STRONG>: (MSI Installer only) Do not launch the installation package 
  306. from a directory for which the ``System'' account does not have read permission.  
  307. If you do, the Windows Installer Service will not be able to access the MSI 
  308. file in order to perform the installation.  You may get an error message to this 
  309. effect, or it may fail mysteriously.
  310. <P></P>
  311. <LI>
  312. <STRONG>Administrative Rights</STRONG>: If you are installing Perl on behalf of other users, 
  313. we recommend running the installer while logged in with an account that has 
  314. administrative privileges (Windows NT/2000/XP/2003).  Running without administrative 
  315. privileges results in the following limitations:
  316. <UL>
  317. <LI>
  318. The PerlScript feature will be unavailable.
  319. <P></P>
  320. <LI>
  321. ActivePerl applications will not write messages to the event log.
  322. <P></P>
  323. <LI>
  324. Environment variables are set only for the current user.
  325. <P></P>
  326. <LI>
  327. The option to create a file association for Perl files is disabled.
  328. <P></P>
  329. <LI>
  330. Registry entries are created under HKEY_CURRENT_USER and not under
  331. HKEY_LOCAL_MACHINE.
  332. <P></P></UL>
  333. </UL>
  334. <UL>
  335. <LI>
  336. <STRONG>Windows XP / Windows 2003 Server</STRONG>: no additional requirements
  337. <P></P>
  338. <LI>
  339. <STRONG>Windows 2000</STRONG>
  340. <UL>
  341. <LI>
  342. (MSI Installer only) Microsoft Windows Installer 2.0 or greater, available from:
  343. <A HREF="http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/NT/InstMsiW.exe">http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/NT/InstMsiW.exe</A>
  344. <P></P></UL>
  345. <LI>
  346. <STRONG>Windows Me</STRONG>
  347. <UL>
  348. <LI>
  349. (MSI Installer only) Microsoft Windows Installer 2.0 or greater, available from:
  350. <A HREF="http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/9x/InstMsiA.exe">http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/9x/InstMsiA.exe</A>
  351. <P></P></UL>
  352. <LI>
  353. <STRONG>Windows NT</STRONG>
  354. <UL>
  355. <LI>
  356. Service Pack 5 or greater
  357. <P></P>
  358. <LI>
  359. (MSI Installer only) Microsoft Windows Installer 2.0 or greater, available from:
  360. <A HREF="http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/NT/InstMsiW.exe">http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/NT/InstMsiW.exe</A>
  361. <P></P>
  362. <LI>
  363. (for the ActiveX Scripting Engine) Internet Explorer 5 or greater, available from:
  364.     <A HREF="http://windowsupdate.microsoft.com">http://windowsupdate.microsoft.com</A>
  365. <P></P></UL>
  366. <LI>
  367. <STRONG>Windows 9x</STRONG>
  368. <UL>
  369. <LI>
  370. (MSI Installer only) Microsoft Windows Installer 2.0 or greater, available from:
  371. <A HREF="http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/9x/InstMsiA.exe">http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/9x/InstMsiA.exe</A>
  372. <P></P>
  373. <LI>
  374. (for the ActiveX Scripting Engine) Internet Explorer 5 or greater available from:
  375.     <A HREF="http://windowsupdate.microsoft.com">http://windowsupdate.microsoft.com</A>
  376. <P></P>
  377. <LI>
  378. (for the ActiveX Scripting Engine) DCOM for Windows 9x, available from:
  379.     <A HREF="http://www.microsoft.com/com/resources/downloads.asp">http://www.microsoft.com/com/resources/downloads.asp</A>
  380. <P></P>
  381. <LI>
  382. MSVCRT (Windows 95 only), available from:
  383.     <A HREF="ftp://ftp.microsoft.com/softlib/mslfiles/mxvcrt.exe">ftp://ftp.microsoft.com/softlib/mslfiles/mxvcrt.exe</A>
  384. <P></P></UL>
  385. </UL>
  386. <P>
  387.  
  388. <h3><a name="upgrade_56">Upgrading from ActivePerl 5.6.x</a></h3>
  389.  
  390. <p>When upgrading from ActivePerl version 5.6, additional packages
  391. that were installed using PPM must be manually reinstalled for 
  392. ActivePerl 5.8. Before performing the upgrade, generate a list of modules by
  393. running the following command at a command prompt:</p>
  394.  
  395. <pre>
  396. dir /b c:\perl\site\lib\ppm-conf\*.ppd > c:\ppm_modules.txt
  397. </pre>
  398.  
  399. <p>This will write a list of the modules installed via PPM to the file
  400. <code>ppm_modules.txt</code>. Alter the command as necessary to suit your
  401. installation.</p>
  402.  
  403. <p>After uninstalling the old version of ActivePerl, manually delete the
  404. <code>c:\perl</code> directory, then install ActivePerl 5.8.x. Use the
  405. version of PPM installed with ActivePerl 5.8 to re-install the modules listed
  406. in <code>ppm_modules.txt</code>.</p>
  407.  
  408. <h3><a name="upgrade_58">Upgrading from ActivePerl 5.8.x</a></h3>
  409.  
  410. <p>If you have installed modules using the PPM included with earlier versions
  411. of ActivePerl 5.8, use the following steps to upgrade ActivePerl. PPM modules can
  412. only be migrated to later ActivePerl builds if you installed ActivePerl using
  413. the <a href="#windows installers">MSI Installer</a>.</p>
  414.  
  415. <ol>
  416.   <li>Use Window's <strong>Add / Remove Programs</strong> applet (accessible
  417.   from the <strong>Control Panel</strong>) to uninstall ActivePerl.</li>
  418.   
  419.   <li>Manually delete all directories beneath the Perl installation directory
  420.   (by default <code>C:\Perl</code>) except the <code>site\lib</code> directory.</li>
  421.   
  422.   <li>Install ActivePerl to the same directory (i.e., <code>C:\Perl</code>).</li>
  423.   
  424.   <li>Use the <strong>ppm upgrade</strong> command to check for module updates.</li>
  425. </ol>
  426.   
  427.  
  428.  
  429.  
  430. <H3><A NAME="windows installers">Windows Installers</A></H3>
  431.  
  432. <p>If you are using ActivePerl to serve CGI / ASP scripts using IIS or
  433. another Web server, stop the Web server before installing ActivePerl.</p>
  434.  
  435. <DL>
  436. <DT><STRONG><A NAME="item_MSI_Installer_Package">MSI Installer Package</A></STRONG><BR>
  437. <DD>
  438. To install the MSI package double-click on the MSI file in Windows Explorer.
  439. <P>Do not install over a 500 or 600 series build of ActivePerl.  This package must be 
  440. installed into a separate directory.</P>
  441. <DL>
  442. <DT><STRONG><A NAME="item_MSI_Package_Installation_from_the_Command_Line">MSI Package Installation from the Command Line</A></STRONG><BR>
  443. <DD>
  444. You can install ActivePerl from the command line using the 'msiexec'
  445. program. For example:
  446. <PRE>
  447.     msiexec /i msi_file.msi</PRE>
  448. <P>The ADDLOCAL command line property is used to specify which features should 
  449. be installed. (If ADDLOCAL is not specified, all features are installed.) 
  450. For example:</P>
  451. <PRE>
  452.     msiexec /i msi_file.msi ADDLOCAL="PERL_FEATURE,PERLIS"</PRE>
  453. <P>The following features may be specified with the ADDLOCAL switch:</P>
  454. <UL>
  455. <LI>
  456. PERL_FEATURE (the Perl core)
  457. <P></P>
  458. <LI>
  459. PPM (the Programmer's Package Manager)
  460. <P></P>
  461. <LI>
  462. PERLIS (the Perl for ISAPI interpreter)
  463. <P></P>
  464. <LI>
  465. PERLSE (the Perl ActiveX Scripting Engine)
  466. <P></P>
  467. <LI>
  468. EXAMPLES (some simple examples)
  469. <P></P>
  470. <LI>
  471. DOCUMENTATION (the ActivePerl documentation)
  472. <P></P></UL>
  473. <P>A set of command-line properties can be used to configure the installation. 
  474. For example:</P>
  475. <PRE>
  476.     msiexec /i msi_file.msi TARGETDIR="c:\perl" PERL_PATH="Yes"</PRE>
  477. <UL>
  478. <LI>
  479. TARGETDIR: Used to specify the absolute path where ActivePerl will be 
  480. installed. If not specified, ActivePerl will be installed in a default 
  481. location on the same drive as the Windows operating system.
  482. If this option is used, a value is required.
  483. <P></P>
  484. <LI>
  485. PL_IISMAP: If this option is set to 'Yes', the installer will create a 
  486. global IIS script mapping for '.pl' and Perl. By default, the installation 
  487. does not create the script mapping.
  488. <P></P>
  489. <LI>
  490. PLX_IISMAP: If this option is set to 'Yes', the installer will create
  491. a global IIS script mapping for '.plx' and PerlIS. By default, the installation 
  492. does not create the script mapping.
  493. <P></P>
  494. <LI>
  495. PERL_PATH: If this option is set to 'Yes', the Perl/bin directory
  496. will be added to the system PATH environment variable. By default, 
  497. the directory is not added to the path.
  498. <P></P></UL>
  499. <P>The following command-line switches can be used:</P>
  500. <DL>
  501. <DT><STRONG><A NAME="item_Silent_Mode">Silent Mode</A></STRONG><BR>
  502. <DD>
  503. To run in silent mode, specify the '/q' command line option. The installer 
  504. will run with no UI.
  505. <P></P>
  506. <DT><STRONG><A NAME="item_Logging">Logging</A></STRONG><BR>
  507. <DD>
  508. To log the installation process, specify the '/l' command line option and 
  509. the name of the log file.  For example:
  510. <PRE>
  511.     msiexec /i msi_file.msi /l log.txt</PRE>
  512. <P>To enable verbose logging, use the '*v' modifier with the '/l' command 
  513. line option.  For example:</P>
  514. <PRE>
  515.     msiexec /i msi_file.msi /l*v log.txt</PRE>
  516. <P></P></DL>
  517. </DL>
  518. <DT><STRONG><A NAME="item_AS_Installer_Package">AS Installer Package</A></STRONG><BR>
  519. <DD>
  520. The AS package is a generic installation package that can be used on 
  521. systems where the MSI package is not supported. The AS package provides 
  522. no uninstall functionality. To install using the AS package, double-click 
  523. the the installer file and follow the prompts.
  524. <P></P></DL>
  525. <P>
  526. <H3><A NAME="windows configuration">Windows Configuration</A></H3>
  527. <P>If you run Perl at the command prompt, the script will be executed by the first 
  528. Perl.exe it encounters in the list of paths in the PATH environment variable. 
  529. To ensure the script is executed by the Perl interpeter you want it to be executed
  530. by, you can specify the complete path to the Perl.exe you want to use. 
  531. (typing perl -v at the command prompt will tell you which version 
  532. of Perl is currently first in your PATH)</P>
  533. <P>Installing ActivePerl will change your Path environment variable and may change 
  534. registry settings, such as file associations, which may affect your Web server. 
  535. If you want to use a previously installed copy of Perl, you will need to
  536. modify these settings.</P>
  537. <P>
  538. <H3><A NAME="uninstalling activeperl on windows">Uninstalling ActivePerl on Windows</A></H3>
  539. <DL>
  540. <DT><STRONG><A NAME="item_MSI_Package">MSI Package</A></STRONG><BR>
  541. <DD>
  542. If you installed ActivePerl using the MSI installer, uninstall using the 
  543. Windows <STRONG>Add / Remove Programs</STRONG> applet.
  544. <P></P>
  545. <DT><STRONG>AS Package</STRONG><BR>
  546. <DD>
  547. If you installed ActivePerl using the AS installer, uninstall by deleting 
  548. the directory in which ActivePerl was installed.
  549. <P></P></DL>
  550.  
  551. </BODY>
  552.  
  553. </HTML>
  554.