Chapter 2. Getting started

1. Installation
1.1. Windows 95/98/2000/NT/XP
1.2. Mac OS X
1.3. Unix/Linux/Solaris
2. Running the application
2.1. Windows 95/98/2000/NT/XP
2.2. Mac OS X
2.3. Unix/Linux/Solaris
3. Supplying a License file
3.1. File based licensing
3.2. JAR based licensing

1. Installation

Important

downCast is not fully compatible with J2SE version 1.4.x due to a very unfortunate packaging of an outdated XML parser und XSLT processor (which downCast relies on) with the basic Java runtime library distribution. We're investigating how to resolve this issue. downCast will use more recent versions of these tools in which several important bugs have been fixed when running on J2SE version 1.2.x or J2SE version 1.3.x.

1.1. Windows 95/98/2000/NT/XP

In order to install downCast on a Windows machine, we supply an installer (requires J2SE version 1.2 or later). After downloading it, simply double-click its icon to start the installation. Follow the instructions given on screen. When you are asked for the Java Virtual Machine to be used to run downCast we recommend the use of Sun's J2SE version 1.3 runtime environment (JRE).

The installation process automatically creates an entry for downCast in the Windows Start menu, in the group infinity-loop.

1.2. Mac OS X

For installation under Mac OS X, we supply a disk image (.dmg) containing the application. Mount the disk image by double-clicking it and copy the downCast application into the Applications folder.

Note

downCast is not compatible with Mac OS 9 or earlier, since for these systems there is no support for J2SE version 1.2 or later available.

1.3. Unix/Linux/Solaris

To install downCast on a Unix machine we supply an installer that should run on all supported Unix (and derivatives) platforms. After downloading it, set the appropriate rights (use the chmod+x command) and execute the installer. Follow the instructions given on screen. This installs downCast on your machine.

2. Running the application

When you launch downCast for the first time, you will be presented with a window containing the Software License Agreement for using downCast. Please read that agreement carefully. If you agree to the license, click Accept License, otherwise choose Decline License and remove the application from your storage device(s).

2.1. Windows 95/98/2000/NT/XP

On Windows machines, start the application with the help of the Windows Start menu, in the group infinity-loop. In case you installed our downCast JAR archive without the help of the installer, simply double-click the downCast JAR archive icon (requires J2SE version 1.2 or higher).

Note

We have experienced occasions where this does not work reliably. In that case, open the commandline prompt and type java -Xmx512M -jar C:\fullpath\to\downcast.jar and hit the return key.

2.2. Mac OS X

On Mac OS X machines, double click the application icon.

2.3. Unix/Linux/Solaris

On Unix systems you either need to type downCast_Install in a shell/console window and hit return. In this case be sure that the current PATH environment variable includes the folder where this file (actually a batch file created by the installer) is located.

In case you have downloaded just the downCast JAR archive, type java -Xmx512M -jar downcast.jar. This requires J2SE version 1.2 or later to start the application. The main class in every case for the application is de.infinityloop.downcast.DownCast.

3. Supplying a License file

When requesting or purchasing a license from infinity-loop, you'll receive a file named downcast.license by email. This is your license key, store it at a safe place (make a backup to a different storage medium).

You can supply this license file in two ways: either by placing it at a specific location in your computer's file system or by packaging it into the downcast.jar file (advanced users only).

3.1. File based licensing

Drop the file downcast.license into the application's licenses folder:

Windows

userhome/infinity-loop/downCast/Licenses/

Mac OS X

/Users/user/Library/Application Support/infinity-loop/downCast/Licenses/

Unix, Linux, Solaris

~/infinity-loop/downCast/Licenses/

3.2. JAR based licensing

(For advanced users only.) You can package a license with the executable. To do this, you must package the downcast.license file into the JAR at the following (package-) location:

/de/infinityloop/downcast/resources/licenses/