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. Importing a license
3.2. File based licensing
3.3. 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.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.3 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.3 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.3 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.3 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. Importing a license

  1. To register, either click Register… in the startup dialog or choose Registration… from the Extras menu.

  2. In the Registration Details dialog, click Import License from File… and choose the license file (usually named downcast.license).

  3. You will be asked whether you want to copy the license into the default {Licenses Folder}. Usually, you should click Yes to have the license read by downCast automatically it starts up.

  4. After processing of this file, your license details should be displayed in the text area of the dialog. Click Done.

If you have trouble registering downCast with the attached license file, please contact us at <>.

3.2. File based licensing

Drop the file downcast.license into the {Licenses Folder} (see Section 5, “Magic Folders and Locations”).

3.3. JAR based licensing

(For advanced users only.) You can package a license with the executable. To do this, you must package the upcast.license file into the JAR at the following (package-) location: (see Section 5, “Magic Folders and Locations”)

{JAR Resource Location Path}/licenses/