# IndigoPerl Main Page

Feb 26 2005 | Version 2005.02 |  |

About IndigoPerl |  | Installation Notes
The PerlConsole |  | Using the Apache Webserver
GUI Package Manager |  | Indigo Package Manager

License |  | Release History

## About IndigoPerl

IndigoPerl is a binary build of Perl, Apache and PHP for Windows.

IndigoPerl includes an integrated Apache web server. It can be used for developing and running Perl scripts and web applications. A browser based GUI Package Manager for installing Perl modules is included. IndigoPerl is free.

Features:

Installer:

- Easy installation - just unzip and run setup.
- IndigoPerl is provided in zip format with an Perl script installer. You can easily customize or repackage it for redistribution with additional modules.
- It can be installed on all Win32 systems.
- It comes without a restrictive license - you can do whatever you want to do with it.
- Does not install files in windows directories.
- Does not keep data in registry, except for Apache service information
- Uses text files to keep configuration information
- Multiple versions can be kept on same PC
- Can be installed on multiple computers with a simple copy

Apache:

- Apache is pre-configured for running Perl and PHP CGI scripts.
- Mod_perl is also installed.

Perl:

- Perl comes pre-packaged with some of the most popular Perl modules, including:
  Archive-Tar, Compress-Zlib, DBD-mysqlPP, DBI, HTML-Parser, libwin32, libwww, mod_perl, TimeDate, URI, Win32-API.
- Includes PerlConsole, which provides a web browser based GUI access to the
  Perl help files, the GUI Package Manager and a documentation search engine

Package Manager:

- Includes a browser based GUI Package Manager
- This allows you to install and remove modules using a point-and-click interface
- Also includes IPM, a console version of the package manager
- Can install pre-built binary packages from repositories
- Can also install CPAN source modules.

## Installation

1. Extract the zip file to c:\indigoperl or to a temporary folder.
Extracting to the final installation directory will save a copy step later. We recommend that you install into a directory path without spaces.
2. Run setup.bat from an explorer or dos window.

System requirements:

Any Windows 32-bit system, including Windows 95/98/ME/NT/2000/XP.

To uninstall run uninstall.bat, then remove the installation directory.

Win95 users must have Winsock2 installed.
If you get an error message that says "A required dll WS2_32.dll is missing"
then you need to install Winsock2 from the following URL:
http://www.microsoft.com/windows95/downloads/contents/WUAdminTools/S_WUNetworkingTools/W95Sockets2/Default.asp

## Using the Apache Web Server

IndigoPerl comes with a pre-configured Apache web server.

Place your html documents in the htdocs directory and your scripts in the cgi-bin directory. Use the html and cgi samples as a starting point for your website.

Your perlscripts should start with a line that looks something like this:
#!perl

### Stopping and starting Apache - Windows NT, 2000 and XP

Apache is configured to start automatically as a service whenever the PC is rebooted. If you don't want it to start automatically open the Service Manager and change the setting for Apache service to start manually.

To manually start, stop or restart Apache, click on one of the shortcuts in the Start/Programs/IndigoPerl folder

### Stopping and starting Apache - Windows 95, 98, ME

Apache will start automatically whenever you log into your PC. If you don't want it to start automatically delete the 'Start Apache' shortcut in the Start/Programs/StartUp folder.

To manually start Apache, click on "Start Apache" icon in the the Start/Programs/IndigoPerl folder. To stop Apache click on the minimized Apache window and type Ctrl+C.

While Apache is running a minimized DOS window will remain open. The window title is initially 'start_apache', it will change to 'perl' or 'php' if a CGI script is started.

## The PerlConsole

The PerlConsole application provides a web browser based GUI interface to the Perl help files, the GUI Package Manager and a documentation search engine.

To start the PerlConsole, make sure that Apache is running then click on Start, then IndigoPerl, then PerlConsole.

## GUI Package Manager (GPM)

The GUI Package Manager (GPM) provides a web browser based GUI interface for installing Perl modules.

GPM can install pre-built binary packages from repositories.

GPM can also install CPAN source modules if you have Microsoft DevStudio installed. The module will be automatically downloaded, built, and installed.

To start the GPM start the PerlConsole, then Package Manager link from the main table of contents (top left corner of the window).

## Indigo Package Manager (IPM)

The Indigo Package Manager (IPM) provides a command line interface for managing your Perl modules.

IPM allows you to install and remove packages from your perl installation. IPM can install pre-built binary packages from repositories.

If you access the internet through a firewall or proxy you will need to set the following environment variables:

> Set HTTP_proxy to your proxy server name and port in the format: "http://proxy:8080" .

> If you require a user name and/or password to access your proxy, set HTTP_proxy_user and HTTP_proxy_pass to your user name and password.

To run IPM and to see a help summary run the following command from a DOS window: 'ipm help'.

## License

The intent of this document is to state the conditions under which IndigoPerl may be copied and distributed.
1. You may use IndigoPerl for commercial or non-commercial purposes without charge.
2. You may apply bug fixes, portability fixes and install additional Perl modules. A package modified in such a way shall still be covered by the terms of this license.
3. You may make and give away verbatim copies of IndigoPerl for personal use, or for use within your organization and to others outside your organization, provided that you duplicate all of the original copyright notices and associated disclaimers.
4. You may not distribute copies of IndigoPerl or components derived from IndigoPerl to others outside your organization where IndigoPerl is bundled with a commercial product without specific prior written permission from IndigoSTAR Software except as noted below.

5. You may distribute copies of IndigoPerl or components derived from IndigoPerl to others outside your organization where IndigoPerl is bundled with a commercial product as long as total sales of the bundled product do not exceed $1000 US per year.

6. IndigoSTAR's name and trademarks may not be used to endorse or promote packages derived from IndigoPerl without specific prior written permission from IndigoSTAR Software.
7. INDIGOPERL IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

## Release History

V2005 Mar 1 2005
Rebuilt with Perl 5.8.6

V2004 Mar 1 2004
Rebuilt with Perl 5.8.3, Apache 2.0.48, and PHP 4.3.4.

V2003 Feb 6 2003
Rebuilt with Perl 5.8 Apache 2.0 and PHP 4.2.3

V5.6 Build 09 Aug 24 2002
Build with Perl 5.6.1 Apache 1.3.26

V5.6 Build 01 May 1 2000
Initial release