Installing Komodo 3.0.1

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

Supported operating systems:

The following platforms are officially supported. Current Critical Updates, Windows Updates, and Service Packs must be installed (see http://windowsupdate.microsoft.com).

  • Windows XP
  • Windows Server 2003
  • Windows 2000

Other operating systems:

Komodo can also be run on the following platforms. This version of Komodo has not necessarily been tested on these platforms; platform-specific bugs may or may not be fixed.

  • Windows NT4 (service pack 5)
  • Windows Me
  • Windows 98 (remote debugging unavailable)

Software Prerequisites on Windows

Installation Prerequisites:

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

Language and Debugging Prerequisites:

  • 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. You can download the latest version of ActivePerl from the ActiveState website. 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.
  • Python: Python 1.5.2 or greater is required to debug Python programs. You can download the latest version of ActivePython from the ActiveState website. 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 PHP syntax checking. PHP 4.3.1 or greater is required to debug PHP programs. Debugging and syntax checking are also available for PHP 5. 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: Tcl 7.6 or greater is required to debug Tcl programs. You can download the latest version of ActiveTcl from the ActiveState website.

GUI Builder Prerequisites:

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

Source Code Control Integration Prerequisites:

  • CVS Source Control Integration: Requires CVS, which is available from http://www.cvshome.org, or the latest stable version of CVSNT, which is available from http://www.cvsnt.org/wiki/.
  • CVS Source Control Integration using Putty: Requires Putty version 0.52 or greater.
  • Perforce Source Control Integration: Requires a connection to a Perforce server with version 99.1 or later.

Miscellaneous Prerequisites:

  • Komodo Documentation: Komodo's documentation is displayed within the system's default browser. Supported browsers include Mozilla 1.0 or greater (and all browsers based on Mozilla 1.0 or greater), Opera 6 or greater, Internet Explorer 5 or greater and Konqueror version 3.0.3 or greater. JavaScript and cookies must be enabled.
  • The Visual Package Manager: requires ActivePerl Build 633 or later.
  • 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.

 

Upgrading from Previous Komodo Versions

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

Uninstalling

Unless you are currently using a beta version of Komodo, it is not necessary to uninstall previous versions before installing Komodo 3.0.1 as long as the new version is installed in its own new directory. The Komodo 3.0.1 installation will import settings from previous Komodo versions.

If you want to replace an existing Komodo installation with the latest version, or if you are currently using a beta version, uninstall the existing version before installing the new one.

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

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.

 

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.

 

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

 

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

Operating System Requirements

Supported operating systems:

The following platforms are officially supported.

  • Red Hat 7.3, 8.x and 9.x
  • Red Hat Enterprise Linux 3 (WS, ES and AS)
  • SuSE 9.x

Other operating systems:

Komodo can also be run on the following platforms. This version of Komodo has not necessarily been tested on these platforms; platform-specific bugs may or may not be fixed.

Software Prerequisites on Linux

Installation Prerequisites:

  • glibc 2.1 (or higher) and libjpeg.so.62 (or higher): These libraries are included in standard Linux distributions.

Two packages, based on different C++ libraries, are available for both Komodo Professional and Komodo Personal:

  • The libcpp3 package: built for libstdc++ version 3 (Red Hat 7.x and 8.x)
  • The libcpp5 package: built for libstdc++ version 5 (Red Hat 9.x, Red Hat Enterprise Linux 3, SuSE 8.x and 9.x, Fedora Core 2)

Choose the distribution that corresponds to your version of libstdc++. To check which version of libstdc++ is installed on your machine, run the following command:

	ls /usr/lib/libstdc++*

If libstdc++.so.5 appears in the output, install the libcpp5 version. If not, install the libcpp3 version.

Language and Debugging Prerequisites:

  • 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. You can download the latest version of ActivePerl from the ActiveState website. 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.
  • Python: Python 1.5.2 or greater is required to debug Python programs. You can download the latest version of ActivePython from the ActiveState website. 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 for PHP syntax checking. PHP 4.3.1 or greater is required to debug PHP programs. Debugging and syntax checking are also available for PHP 5. 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. If you intend to debug PHP applications on a remote Linux Red Hat 9 server, you must install the Red Hat 7.3 backwards-compatibility package. Download the file compat-libstdc++-7.3-2.96.118.i386.rpm from the Red Hat FTP site (ftp://rpmfind.net/linux/redhat/9/en/os/i386/RedHat/RPMS).
  • Tcl: Tcl 7.6 or greater is required to debug Tcl programs. You can download the latest version of ActiveTcl from the ActiveState website.

GUI Builder Prerequisites:

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

Source Code Control Integration Prerequisites:

  • CVS Source Control Integration: Requires CVS, which is available from http://www.cvshome.org.
  • Perforce Source Control Integration: Requires a connection to a Perforce server with version 99.1 or later.

Miscellaneous Prerequisites:

  • Komodo Documentation: Komodo's documentation is displayed within the system's default browser. Supported browsers include Mozilla 1.0 or greater (and all browsers based on Mozilla 1.0 or greater), Opera 6 or greater, Internet Explorer 5 or greater and Konqueror version 3.0.3 or greater. JavaScript and cookies must be enabled.
  • The Visual Package Manager: requires ActivePerl Build 633 or later.
  • Web Services To use Web services in Perl or Python programs, ActivePerl and / or ActivePython are required.

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.

 

Upgrading from Previous Komodo Versions

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

Uninstalling

Unless you are currently using a beta version of Komodo, it is not necessary to uninstall previous versions before installing Komodo 3.0.1 as long as the new version is installed in its own new directory. The Komodo 3.0.1 installation imports settings from previous Komodo versions.

If you want to replace an existing Komodo installation with the latest version, or if you are currently using a beta version, uninstall the existing version before installing the new one.

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

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. 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 (/home/user/Komodo-x.x).

      If multiple users are sharing the system and will be using the same installation, install Komodo in a location every user can access (e.g. /opt/Komodo-x.x/ or /usr/local/Komodo-x.x/).

      Note: Each Komodo user requires an individual license key.

      Do not install Komodo in a path that contains spaces or non-alphanumeric characters.

      Be sure to install Komodo into a directory with a unique name. Do not install Komodo directly in a generic directory containing numerous shared files and directories (such as /usr/local) because Komodo does not divide its installed files into bin, lib, include, share, and etc subdirectories.

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

 

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.

 

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.

 

Solaris

Prerequisites

Hardware Prerequisites

  • Sun Sparc architecture
  • UltraSparc IIe or faster CPU recommended
  • 256MB RAM min, 512MB recommended
  • 100 MB hard disk space
  • up to 200 MB of temporary hard disk space during installation

Operating System Requirements

  • Solaris 2.8 or later.

Note - Komodo Personal Edition is not available for Solaris.

Software Prerequisites

Installation Prerequisites:

  • GNU tar: is required for unpacking the Komodo installation file. If you use the native Solaris tar version, you will get a checksum error when attempting to unpack the Komodo tar package, and any attempt to run the install script will fail.

Language and Debugging Prerequisites:

  • 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. You can download the latest version of ActivePerl from the ActiveState website. 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.
  • Python: Python 1.5.2 or greater is required to debug Python programs. You can download the latest version of ActivePython from the ActiveState website. 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 for PHP syntax checking. PHP 4.3.1 or greater is required to debug PHP programs. Debugging and syntax checking are also available for PHP 5. 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: Tcl 7.6 or greater is required to debug Tcl programs. You can download the latest version of ActiveTcl from the ActiveState website.

GUI Builder Prerequisites:

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

Source Code Control Integration Prerequisites:

  • CVS Source Control Integration: Requires CVS, which is available from http://www.cvshome.org.
  • Perforce Source Control Integration: Requires a connection to a Perforce server with version 99.1 or later.

Miscellaneous Prerequisites:

  • Komodo Documentation: Komodo's documentation is displayed within the system's default browser. Supported browsers include Mozilla 1.0 or greater (and all browsers based on Mozilla 1.0 or greater), Opera 6 or greater, Internet Explorer 5 or greater and Konqueror version 3.0.3 or greater. JavaScript and cookies must be enabled.
  • The Visual Package Manager: requires ActivePerl Build 633 or later.
  • Web Services To use Web services in Perl or Python programs, ActivePerl and / or ActivePython are required.

 

Installing Komodo on Solaris

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

To install Komodo on Solaris:

  1. Ensure you have the prerequisite hardware and software.
  2. Download the Komodo installer file (with the extension tar.gz into a temporary directory. You need a temporary directory to crack the tarball. You will not install Komodo in this temporary directory.
  3. Using GNU tar, 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 (/home/user/Komodo-x.x).

      If multiple users are sharing the system and will be using the same installation, install Komodo in a location every user can access (e.g. /opt/Komodo-x.x/ or /usr/local/Komodo-x.x/).

      Note: Each Komodo user requires an individual license key.

      Do not install Komodo in a path that contains spaces or non-alphanumeric characters.

      Be sure to install Komodo into a directory with a unique name. Do not install Komodo directly in a generic directory containing numerous shared files and directories (such as /usr/local) because Komodo does not divide its installed files into bin, lib, include, share, and etc subdirectories.

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

 

Starting Komodo on Solaris

To start Komodo on Solaris:

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

 

Uninstalling Komodo on Solaris

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 Solaris:

  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.