Installation of the Huygens Software

On different platforms all the avaliable programs of the Huygens Software are installed automatically as part of the Huygens Suite. Since installation details may change as new versions are released, for up to date details please visit this wiki page or have a look at the Huygens Manuals.

To use all features of the different programs, valid License Strings should be purchased, but test licenses are also available on request.

1 -

Installation

1.1 -

Installation on Mac OS X

Go to the folder were you downloaded the distribution and double-click on it. It will be extracted by "StuffIt Expander" to a .pkg file, which will be placed in the same directory. Double click this .pkg file, and follow the installation wizard.

If the automatic extractions fails, you can always open a terminal window (a shell) and command the following:

 gunzip huygens-file.pkg.tar.gz
 tar xf huygens-file.pkg.tar

Notice that the huygens-file as you download it will change its extension after each step. At the end you'll get a huygens-file.pkg that you can double click to install.

Only users with administrative privileges can install applications in the default destination.

If you want to install the application in a directory different to the default one (because you are beta-testing a new release, or because you don have enough permissions, for example) specify the destination directory while you use the installation wizard.

If any problem occurs during the installation, please copy the error messages as displayed in the installer log (Window > Installer log) and send them to SVI.

1.2 -

Installation on Microsoft Windows

You have received an executable file for installation, for instance huygens-331p0.exe. Double click its icon to start the installation. During installation, the directory C:\Program files\SVI\ will be created by default (C:\Program files (x86)\SVI\ on 64-bit versions of XP or Vista). You may specify a different installation directory if necessary. After completion the Huygens Essential, Professional, Scripting, and FreeSFP icons appear on your desktop. Double click on one of these icons to start the program.

1.3 -

Installation on Linux

RedHat or SuSE users, or users with another RPM-based Linux, should use the .rpm installer, for instance huygens-3.3.0-p2.x86_64.rpm. Double click the file, or open a Unix shell, go to the directory where this file is located, become superuser and type:

 rpm -ivh --force huygens-3.3.0-p2.x86_64.rpm

Ubuntu users, or users with another Debian-based Linux, should use the the .deb installer, for instance huygens_3.3.0-p2_amd64.deb. Double click the file, or open a Unix shell, go to the directory where this file is located and type:

 sudo dpkg -i huygens_3.3.0-p2_amd64.deb

In contrast to RPM, the Debian package manager removes the previous package before installing the new one.

After installing the software, open a terminal and type huygenspro, essential, huscript, or freesfp to start the software.

A directory /usr/local/svi will be created; symlinks to the executables will be installed in /usr/local/bin.

1.4 -

Installation on SGI Irix 6.5

Currently the Irix distribution is a single `tardist' file containing various components. By default all components are installed. Become superuser and type:

 swmgr -f huygens-2.9.3-p2.tardist

Press `Start' in the Software Manager window.

A directory /usr/local/svi will be created; the executables will be installed in /usr/local/bin and /usr/sbin.

1.5 -

Installation on IBM AIX 5.2

Log in as root on your workstation or ask your system administrator to do so. Huygens for AIX is distributed in a tar file. Go to the directory where you downloaded it to. After unpacking the distribution file with tar xvf my_aixfile.tar you will find three new files: svi.tar.Z, README.AIX and a shell script AIX-install.sh. To install the software you have to run the file AIX-install.sh by typing ./AIX-install.sh. This script will unpack the svi.tar.Z file under /usr/local and then will do some post installation tasks and verification. After a successful installation it will print the message "OK." to the screen.

A directory /usr/local/svi will be created; the executables will be installed in /usr/local/bin.

2 -

After the installation

After a first-time installation there is not yet a license available. Still, you can start the software. Without a license it will run in `Freeware mode'. Among others, this gives you access to the License tools in the Help menu.

2.1 -

Launching the application

On AIX, Irix and Linux start the software by clicking its icon or by typing the program name (essential, huygenspro, huscript or freesfp) into a Unix shell. If this doesn't work directly, you may need to add the application directory to the search path, see below.

On Mac OS X and Windows click on the application icon.

You can also use an X11 shell in the Mac to run the programs from the command line. Go to the program directory, usually /Applications/SVI/bin and type ./essential (mind the dot-slash) or other application name to launch the Aqua version. This you need to do in any case when you are running the program remotely from another machine: in that case use the remote version, type ./essential.remote or ./essential -remote (again, mind the dot-slash syntax). See running remotely for more details on the Mac and other platforms remote execution.

Without a license the software will open in FreeWare mode and display the start-up window.

2.2 -

Installing a license

License String explains how to obtain and install a license string.

2.3 -

Adding to the shell search path

Users of the csh or tcsh shell can add the /usr/local/bin or /usr/sbin/ directory to their shell search path by adding the following line to the .cshrc file in their home directory:

set path=(/usr/local/bin $path) or set path=(/usr/sbin $path)

You can inquire your shell by typing: echo $SHELL

3 -

Updating the software

Download the new version from the SVI website at http://www.svi.nl. Proceed with the installation as explained above.

Do not uninstall the old version as this will delete your license string. On Mac OS X make sure you make a backup of the license string in a safe place before you remove the previous installation.

4 -

Removing the software

• Irix: Open the Software Manager, select Manage Installed Software, and mark the packages you wish to remove.
• Mac OS X: Drag the installation to the waste basket.
• Microsoft Windows: Clicking Start in your Windows desktop and select: Programs > Huygens Essential > Uninstall.
• Linux: see below.

Removing the software will also cause your license string to be removed. If you prefer to uninstall your current version prior to installing a newer one, be sure to store your license string in a safe place.

4.1 -

More details for Linux

If Huygens was installed using RPM, you can use this command to remove the package:

 rpm -e huygens

If the package manager complains that multiple versions are installed, then query for the installed versions and remove them one-by-one:

 rpm -q huygens

To remove packages using Debian package manager, type

 dpkg -r huygens

To query for packages installed by the Debian package manager, use

 dpkg-query -W huygens

5 -

System requirements for Huygens

5.1 -

Windows and Linux

Huygens runs on the following Windows operating systems:

• 2003 Server;
• XP (32 and 64 bit edition);
• Vista (32 and 64 bit edition);
• Windows 7 (32 and 64 bit edition)

On Linux, the RedHat, SuSE and Ubuntu distributions are supported.

• A standard ethernet card is required to provide your computer with a system ID.
• Processor: AMD Athlon or Intel Pentium 4 and higher.
• RAM memory: 2 GB or larger.
• Graphics card: any fairly modern card will do.

5.2 -

Mac OS X

• Operating system: Mac OS X 10.4 or higher. Mac OS X 10.5 is required for full 64 bit capabilities.
• Processor: Intel or G5 PowerPC or higher. Mac OS X 10.5 is required for full multiprocessor support on Intel platforms.
• RAM memory: 2 GB or larger.

5.3 -

SGI Irix, IBM AIX

Huygens Essential and Huygens Scripting run on all SGI equipment running Irix 6.5 on a MIPS R10000 processor or higher, IBM AIX 5.2 equipment with a Power4 processor or higher. The recommended RAM size is 2 GB or larger.

6 -

Version information

All SVI software packages contain an image processing engine called the Huygens Compute Engine (HuCE). Though different packages may contain different version numbers for their interfaces, the most relevant version number is the common one of the HuCE. The version number of the HuCE is can be seen in Help > About in all packages with a graphical interface, and is returned by the huOpt version command.