Komodo User Guide

Installing Komodo 2.3

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.

  • 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.

  • Tcl: Background syntax checking and debugging require a licensed version of ActiveState's Tcl Dev Kit, included with membership to ASPN Tcl.

  • 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.3 (unless you are currently using a beta version of Komodo 2.3). The Komodo 2.3 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. However, if you are running a beta version of Komodo 2.3, you must uninstall before installing another version.

Remote Debugging

This version of Komodo contains updated remote debugging extensions. Refer to the Remote Debugging instructions for information about updating the extension.

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:

  • Double-click the desktop icon
    or
  • Go to Start, then Programs, then ActiveState Komodo, then Komodo
    or
  • 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 on Windows, do one of the following:

  1. From the Start menu, select Programs, then ActiveState Komodo.
  2. Select Uninstall Komodo

OR

  1. From the Start menu, select Settings, then Control Panel.
  2. Double-click Add/Remove Programs.
  3. Highlight ActiveState Komodo and click Remove.
Top

Linux

Prerequisites

Hardware Requirements

  • Intel x86 processor, 233 MHz (or faster) with 128 MB RAM
  • 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 (8.6MB). 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 (7.6MB). 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.


  • 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.

  • Tcl: Background syntax checking and debugging require ActiveState's Tcl Dev Kit, included with membership to ASPN Tcl.

  • 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 your PATH environment variable

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

  • Modify your PATH environment variable. For example, if you use Bash, 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.

or

  • Create a symbolic link to the Perl or Python executable. For example, for ActivePerl  

    ln -s <installdir>/bin/perl /usr/local/bin/perl

    For ActivePython,

    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.3 (unless you are currently using a beta version of Komodo 1.2). The Komodo 2.3 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. However, if you are running a beta version of Komodo 1.2, you must uninstall before installing another version.

Remote Debugging

This version of Komodo contains updated remote debugging extensions. Refer to the Remote Debugging instructions for information about updating the extension.

Installing Komodo on Linux

This version of Komodo allows non-root installation on Linux. Use this procedure for installing Komodo.

To install Komodo on Linux:

  1. Ensure you have the prerequisite hardware and software.
  2. Download the Komodo tar.gz file into a temporary directory. You need a temporary directory to crack the tarball. You will not install Komodo in this temporary directory.
  3. Crack the tarball into the temporary directory. This unpacks 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>.tar.gz

      where <version> is the version of Komodo
      and <build> is the Komodo build number

  4. Change to the new directory. From the command line, enter

    • cd Komodo-<version>-<build>

  5. Run the install script ("install.sh"). From the command line, enter

      ./install.sh

  6. 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.

  7. Add the Komodo directory to your path. To do this, either:
    • Modify your PATH environment variable. For example, if you use Bash, put the following in your ~/.bashrc file:

        export PATH=<installdir>:$PATH

        where <installdir> points to where you installed Komodo

    • or

    • 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 you installed Komodo

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. You will get an error if you select the "License" link from within Komodo.

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.
Top