Komodo Installation Guide

Windows

Prerequisites

Hardware Requirements

Operating System Requirements

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

To install on Windows XP, you may need to upgrade your version of Windows Installer.

Software Prerequisites on Windows

Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions. For major release upgrades (e.g. 3.5 to 4.0) the installer will automatically put Komodo in a new directory.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version before installing the new one, or manually specify a different install directory during the installation process. Your Komodo preferences will be preserved as they are installed in a different directory.

Installing Komodo on Windows

Before you start:

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.

Command Line Installation Options

Komodo can also be installed from the command line. For example:

c:\> msiexec.exe /i Komodo-<version>.msi

Komodo's installer uses Windows Installer technology, which allows you to partially control the install from the command line. For example:

Installing the MSI in Silent Mode

You can have the Komodo installer run with a reduced user interface. For example, the following will install silently and only open a dialog when the installation is complete.

c:\> msiexec.exe /i Komodo-<version>.msi /qn+

The following will install with no dialog at all.

c:\> msiexec.exe /i Komodo-<version>.msi /q

Turning on Logging

You can generate a log of the Komodo installation with the following command:

c:\> msiexec.exe /i Komodo-<version>.msi /L*v install.log

Controlling the Install Directory

Command line options can be used to configure Komodo installation properties. The following will install Komodo to "E:\myapps\Komodo", instead of the default location:

c:\> msiexec.exe /i Komodo-<version>.msi INSTALLDIR=D:\myapps\Komodo

Controlling Which Features Get Installed

Komodo is divided into a number of distinct features. In the "Customize Setup" dialog you can select which features to install. You can also do this on the command line with the ADDLOCAL property. For example, the following command will install just the core Komodo functionality (i.e. not the PyWin32 extensions or the documentation.

c:\> msiexec.exe /i Komodo-<version>.msi ADDLOCAL=core

The current set of Komodo features are:

core             Komodo core
env              Windows environment settings
    desktop      Desktop shortcut
    quicklaunch  Quick launch shortcut
    register     Register this as the default Komodo
docs             Documentation

The hierarchy denotes dependencies (i.e. to install quicklaunch you must install the env.

The register option puts the Komodo location in the registry so 'start komodo' works, and adds bindings for .kpz and .kpf Komodo project files.

Starting Komodo on Windows

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

Uninstalling Komodo on Windows

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

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

Mac OS X

Prerequisites

Hardware Requirements

Operating System Requirements

Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version or rename the .app before installing the new one. Your Komodo preferences will be preserved as they are installed in a different directory.

Installing Komodo on Mac OS X

To install Komodo:

Starting Komodo on OS X

Click the Komodo icon in the Dock or the Applications folder.

Uninstalling Komodo on OS X

Drag the Komodo icon into the Trash.

Linux

Prerequisites

Hardware Requirements

Operating System Requirements

Supported operating systems:

The following platforms are officially supported.

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:

Non-ASCII Input Requirements (IME):

Adding Perl or Python to the PATH Environment Variable

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

Upgrading from Previous Komodo Versions

Newer versions of Komodo should not be installed in the same directory as older versions. For major release upgrades (e.g. 3.5 to 4.0) the installer will automatically put Komodo in a new directory.

For minor releases (e.g. 4.1 to 4.2) and patch-level releases (4.1.1 to 4.1.2), use the auto-update system (Help|Check for Updates). The changes will be applied safely in the current install directory. If you need to update using an installer, completely uninstall the older version before installing the new one, or manually specify a different install directory during the installation process. Your Komodo preferences will be preserved as they are installed in a different directory.

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. Download the Komodo installer (.tar.gz file) into a convenient directory.
  2. Unpack the tarball: 
    tar -xvzf Komodo-<version>-<platform>.tar.gz
  3. Change to the new directory: 
    cd Komodo-<version>-<platform>
  4. Run the install script ("install.sh"): 
    ./install.sh
  5. Answer the installer prompts:
    • Specify where you want Komodo installed, or press 'Enter' to accept the default location (/home/<username>/Komodo-<IDE|Edit>-x.y).The -I option can be used to specify the install directory. For example: 
      ./install.sh -I ~/opt/Komodo-IDE-4.2

      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 their own license key.
      • Do not install Komodo in a path that contains spaces or non-alphanumeric characters.
      • Be sure to install Komodo into its own directory (i.e. not directly in an existing directory containing shared files and directories such as /usr/local).


  7. Once the installer has finished, add Komodo to your PATH with one of the following:
    • Add Komodo/bin to your PATH directly: 
      export PATH=<installdir>/bin:$PATH
    • Add a symlink to Komodo/bin/komodo from another directory in your PATH: 
      ln -s <installdir>/bin/komodo /usr/local/bin/komodo
      Note: Creating symlinks in system directories such as /usr/bin requires root access.

After completing the installation, you can delete the temporary directory where the Komodo tarball was unpacked.

Starting Komodo on Linux

To start Komodo on Linux enter `komodo` at the command line or create a shortcut on your desktop or in your toolbar using the full path to the komodo executable.

Uninstalling Komodo on Linux

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.

Note: You cannot relocate an existing Komodo installation to a new directory by simply moving it. You must uninstall Komodo from the existing location and reinstall it in the new location.