COGENT Online
CONTENTS
COGENT Version 2.3 Help

COGENT Version 2.3 Installation Notes

These notes contain instructions for installing and configuring COGENT to run under Windows, UNIX and Mac OS X environments.

Installation on Windows 95/98/NT/2000 etc.:

COGENT does not currently come as a self-installing package. This means that you need to do a little work to install it:

To create a shortcut from the desktop to the COGENT program:
To create a menu item on the Start Menu to the COGENT program:
Setting essential preferences:

The first time you run COGENT, it will run an installation wizard in order to set various user and system preferences. To set these preferences, run COGENT. The installation wizard gives two options:

In either case the relevant preferences can be adjusted after installation from COGENT's preferences panel. Standard installation requires that you set the system folder and the user folder. The system folder should be set to the folder in which COGENT was installed (e.g., C:\Program Files\COGENT 2.3.1). The user folder may be set to any existing folder. If COGENT is installed in the default location (C:\Program Files) then the default values for these preferences will be correct.

Custom installation allows independent locations to be set for a range of preferences. This is never necessary, but offered for advanced users who have unusual tastes in the location of system files. Such users are assumed to not require further documentation.


Installation on UNIX

On UNIX, COGENT may be installed in either single user mode or multi-user mode. Single user mode is applicable if you want to install/run COGENT but do not have system privileges. Multi-user mode requires system privileges and makes COGENT available to all users on a UNIX system.

Single user installation
Multi-user installation
Setting essential preferences:

The first time you run COGENT, it will run an installation wizard in order to set various user and system preferences. To set these preferences, run COGENT. The installation wizard gives two options:

In either case the relevant preferences can be adjusted after installation from COGENT's preferences panel. Standard installation requires that you set the system directory, the user directory and the location of the oos binary. The system directory should be set to the directory in which COGENT was installed (e.g., /usr/local/src/cogent for multi-user COGENT or ~/COGENT for single-user COGENT, where ~ should be replaced by the user's home directory). The user directory may be set to any existing directory for which the user has write access. The recommended setting is ~/COGENT, where ~ should be replaced by the user's home directory. The location of the oos binary must also be set appropriately. With multi-user installation in default directory, the location will be /usr/local/bin/oos. With single-user installation it will be ~/bin/oos (where ~ should be replaced by the user's home directory).

Custom installation allows independent locations to be set for a range of preferences. This is never necessary, but offered for advanced users who have unusual tastes in the location of system files. Such users are assumed to not require further documentation.


Installation on Mac OS X

To run COGENT on the Mac you must have:

NOTE: The following instructions are new. We have reports that they work flawlessly, but please let us know of any difficulties.

Once you have these, installation basically follows that of UNIX, with the use of the OS X sudo command replacing the more standard UNIX su:

Setting essential preferences:

The first time you run COGENT, it will run an installation wizard in order to set various user and system preferences. To set these preferences, run COGENT. The installation wizard gives two options:

In either case the relevant preferences can be adjusted after installation from COGENT's preferences panel. Standard installation requires that you set the system folder, the user folder and the location of the oos binary. The system folder should be set to the folder in which COGENT was installed (e.g., /usr/local/src/cogent). The user folder may be set to any existing folder for which the user has write access. The recommended setting is ~/COGENT, where ~ should be replaced by the user's home folder. The location of the oos binary must also be set appropriately. With installation in default folder, the location will be /usr/local/bin/oos.

Custom installation allows independent locations to be set for a range of preferences. This is never necessary, but offered for advanced users who have unusual tastes in the location of system files. Such users are assumed to not require further documentation.


COGENT Online
CONTENTS
COGENT Version 2.3 Help