Komodo User Guide

Installing Komodo 2.5

Windows

Prerequisites

Hardware Requirements

  • Intel x86 processor, 200 MHz (or faster) with 128 MB RAM.
  • Up to 230 MB in your TMP directory (as indicated by the value of your 'TMP' environment variable) during installation, even if you plan to install Komodo to another drive. If you do not have the required space on this drive, manually set the 'TMP' environment variable to a directory on a drive with sufficient space.

Operating System Requirements

  • Windows XP, 2000, NT (service pack 5 recommended), Me or 98 (remote debugging is not available on Windows 98)

Software Prerequisites on Windows

  • Windows 98, Me and NT users: Microsoft Windows Installer (MSI) version 2.0 or greater ( MSI 2.0 for 9x and Me, MSI 2.0 for NT)
  • Windows 98/NT4 Users: Windows Scripting Host: Microsoft's Windows Scripting Host is required by the Microsoft Windows Installer. Older versions of Windows did not include the Windows Scripting Host. To check if your system has the Windows Scripting Host, select Run from the Windows Start menu, and enter wscript. If the Windows Script Host Setting dialog appears, WSH is installed on your system. If it doesn't, download the WSH from http://www.microsoft.com/msdownload/vbscript/scripting51.asp.
  • Debugging: if firewall software is installed on the system, it must be configured to allow Komodo to access the network during remote debugging.
  • Perl: Perl 5.6 or greater is required to debug Perl programs. Download ActivePerl Build 623 or later. Ensure that the directory location of the Perl interpreter (by default, C:\perl) is included in your system's PATH environment variable. Some advanced features, such as background syntax checking and remote debugging, require ActivePerl.
  • The Visual Package Manager: requires ActivePerl Build 633 or later.
  • Python: Python 1.5.2 or greater is required to debug Python programs. Download ActivePython build 202 or greater. Ensure that the directory location of the Python interpreter (by default C:\Pythonxx (where "xx" is the Python version)) is included in your system's PATH environment variable. Some advanced features, such as background syntax checking and remote debugging, require ActivePython. Python 1.5.2 or greater and a fully configured Tkinter installation are required to create Python dialogs with the GUI Builder.
  • PHP: PHP 4.0.5 or greater is required for background syntax checking and debugging PHP programs. Download PHP from http://www.php.net/downloads.php. Ensure that the directory location of the PHP interpreter (by default C:\PHP) is included in your system's PATH environment variable. For complete instructions for configuring Komodo and PHP, see Configuring the PHP Debugger. PHP debugging extensions are available on ASPN, the ActiveState Programmer Network.
  • Web Services: To use Web services in Perl or Python programs, ActivePerl and / or ActivePython are required.
  • Perl Dev Kit: In order to build executable programs, ActiveX controls and Windows services in Perl, you must have ActiveState's Perl Dev Kit version 3.1 or greater installed on your system.
  • CVS Source Control Integration: Requires the cvs.exe executable available from http://www.cvshome.org.
  • CVS Source Control Integration using Putty: Requires Putty version 0.52 or greater.
  • Perforce Source Control Integration: Requires a Perforce client to be installed on your system.
  • Perl Dialogs created with the GUI Builder: Require the Perl Tk module. This module has been included with ActivePerl since build 631. If necessary, manually install using the command "ppm install Tk".
  • Python Dialogs created with the GUI Builder: Require Python version 1.5.2 or greater.
  • Tcl Dialogs created with the GUI Builder: Require Tcl version 8.3 or greater.
Top

Upgrading from Previous Komodo Versions

To determine your current Komodo version, select Help|About Komodo.

Uninstalling

It is not necessary to uninstall previous versions of Komodo before installing Komodo 2.5 (unless you are currently using a beta version of Komodo 2.5). The Komodo 2.5 installation will import settings from previous Komodo versions (with the exceptions described below).

If you want to replace an existing Komodo installation with the latest version, uninstall the existing version of Komodo before installing the latest version.

If you want to run two versions of Komodo, you may do so, but ensure they are installed in directories with unique names.

Installing Komodo on Windows

Before you start:

  • If you intend to run the installation from a shared network drive, your system must have SYSTEM rights (or greater) to the directory from which the installation is run. Alternatively, run the installation from a local drive.

To install Komodo on Windows:

  1. Ensure you have the prerequisite hardware and software.
  2. Download the Komodo installer file.
  3. Double-click the installer file and follow the instructions.

When installation is complete, you will see an ActiveState Komodo icon on your desktop.

Top

Starting Komodo on Windows

To start Komodo on Windows, use one of the following methods:

  • Double-click the desktop icon
  • Select Start|Programs|ActiveState Komodo|Komodo
  • Add the Komodo install directory to your PATH environment variable, then from the command line prompt, enter komodo.
Top

Uninstalling Komodo on Windows

To uninstall Komodo, select Start|Programs|ActiveState Komodo|Modify, Repair or Uninstall Komodo.

Alternatively, use the Add/Remove Programs menu (accessible from the Windows Control Panel).

Top

Linux

Prerequisites

Hardware Requirements

  • Intel x86 processor, 233 MHz (or faster) with 128 MB RAM (or greater)
  • 100 MB hard disk space
  • up to 200 MB of temporary hard disk space during installation

Supported Operating Systems

  • Red Hat Linux version 8.0 or greater
  • SuSE Linux version 8.0 or greater

Software Prerequisites on Linux

Ensure the following software is installed on your machine:

  • glibc 2.1 (or higher) and libjpeg.so.62 (or higher): These libraries are included in standard Linux distributions.
  • Debugging:
    • Python, XSLT and PHP require TCP/IP to be installed and properly configured, even if you are debugging scripts locally.
    • If firewall software is installed on the system, it must be configured to allow Komodo to access the network during remote debugging.
  • Perl: Perl 5.6 or greater is required to debug Perl programs. Download ActivePerl Build 623 or later. Ensure that the directory location of the Perl interpreter is included in your system's PATH environment variable. See Adding Perl or Python to the PATH Environment Variable for instructions. Some advanced editing features, such as background syntax checking, also require that you have Perl installed.
  • The Visual Package Manager: requires ActivePerl Build 633 or later.
  • Python: Python 1.5.2 or greater is required to debug Python programs. Download ActivePython build 202 or greater. Ensure that the directory location of the Python interpreter is included in your system's PATH environment variable. See Adding Perl or Python to the PATH Environment Variable for instructions. Some advanced editing features, such as background syntax checking, also require that you have Python installed. Python 1.5.2 or greater and a fully configured Tkinter installation are required to create Python dialogs with the GUI Builder.
  • PHP: PHP 4.0.5 or greater is required to debug PHP programs. Download PHP from http://www.php.net/downloads.php. For complete instructions for configuring Komodo and PHP, see Configuring the PHP Debugger. PHP debugging extensions are available on ASPN, the ActiveState Programmer Network.
  • Web Services To use Web services in Perl or Python programs, ActivePerl and / or ActivePython are required.
  • CVS Source Control Integration: Requires the cvs.exe executable available from http://www.cvshome.org.
  • CVS Source Control Integration using Putty: Requires Putty version 0.52 or greater.
  • Perforce Source Control Integration: Requires a Perforce client to be installed on your system.
  • Perl Dialogs created with the GUI Builder: Require the Perl Tk module. This module has been included with ActivePerl since build 631. If necessary, manually install using the command "ppm install Tk".
  • Python Dialogs created with the GUI Builder: Require Python version 1.5.2 or greater.
  • Tcl Dialogs created with the GUI Builder: Require Tcl version 8.3 or greater.

Adding Perl or Python to the PATH Environment Variable

To add Perl or Python to the PATH environment variable, do one of the following:

  • Modify your PATH environment variable. For example, if you use the Bash shell, add the following line to your ~/.bashrc file:
    export PATH=<installdir>/bin:$PATH
    ...where <installdir> points to the directory where you installed ActivePerl or ActivePython.
  • Create a symbolic link to the Perl or Python executable. For example, for ActivePerl, enter:
    ln -s <installdir>/bin/perl /usr/local/bin/perl
    For ActivePython, enter:
    ln -s <installdir>/bin/python /usr/local/bin/python
    ...where <installdir> points to the directory where you installed ActivePerl or ActivePython.
Top

Upgrading from Previous Komodo Versions

To determine your current Komodo version, select Help|About Komodo.

Uninstalling

It is not necessary to uninstall previous versions of Komodo before installing Komodo 2.5 (unless you are currently using a beta version of Komodo 2.5). The Komodo 2.5 installation will import settings from previous Komodo versions (with the exceptions described below).

If you want to replace an existing Komodo installation with the latest version, uninstall the existing version of Komodo before installing the latest version.

If you want to run two versions of Komodo, you may do so, but ensure they are installed in directories with unique names.

Installing Komodo on Linux

This version of Komodo allows non-root installation on Linux. Note, however, that the user who executes the license file will be the user who is licensed to use the software.

To install Komodo on Linux:

  1. Ensure you have the prerequisite hardware and software.
  2. Create a temporary directory into which you will download the Komodo installer file. You will delete this directory after the installation procedure is complete.
  3. Download the Komodo installer file (with the extension tar.gz) into the temporary directory.
  4. Crack the tarball. When you enter the command below, it will unpack the file into a directory with the same name as the Komodo tar.gz file. From the command line, enter:
    tar -xvzf Komodo-<version>-<build>-linux-ix86.tar.gz
    ...where <version> is the version of Komodo and <build> is the Komodo build number.


  5. Change to the new directory. From the command line, enter:
    cd Komodo-<version>-<build>-linux-ix86
  6. Run the install script ("install.sh"). From the command line, enter:
    ./install.sh
  7. Answer the installer prompts:


    • Specify where you want Komodo installed or press Enter to accept the default location. Do not install Komodo in a path that contains spaces or non-alphanumeric characters.
    • Verify you have enough disk space.

    Note - The installer will not install Komodo into a directory where Komodo is already installed. Be sure to install Komodo into a directory with a unique name.

  8. Add the Komodo directory to your path. To do this, either:

    • Modify your PATH environment variable. For example, if you use the Bash shell, put the following in your ~/.bashrc file:
      export PATH=<installdir>:$PATH
      ...where <installdir> points to the location where Komodo was installed.


    • Create a symbolic link to the Komodo executable (not to the bin directory). For example:
      ln -s <installdir>/komodo /usr/local/bin/komodo
      ...where <installdir> points to the directory where Komodo was installed.

When installation is complete, you can delete the temporary directory where the Komodo tarball was cracked.

The Komodo license will be sent to the email address you provided during registration. You must install this license. Otherwise, you will get an error if you select the "License" link from within Komodo.

  1. To make the license executable, enter:

    chmod +x <filename>


  2. To run the license, enter:

    ./<filename>
Top

Starting Komodo on Linux

To start Komodo on Linux:

  • If necessary, open the graphical shell by entering startx.
  • Open the GUI terminal emulator, and enter komodo.
Top

Uninstalling Komodo on Linux

Use the procedure only if you want to fully remove Komodo from your system.

Note that you cannot relocate an existing Komodo installation to a new directory. You must uninstall Komodo from the existing location and reinstall it in the new location.

To uninstall Komodo on Linux:

  1. Delete the directory that Komodo created during installation.
  2. If you wish to delete your Komodo preferences, delete the ~/.komodo directory. If you do not delete this directory, subsequent installations of Komodo will use the same preferences.
Top