In order to install upCast 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 upCast we recommend the use of Sun's J2SE version 1.3 runtime environment (JRE).
The installation process automatically creates an entry for upCast in the Windows menu, in the group .
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 upCast application into the Applications folder.
upCast 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.
To install upCast on a Unix machine we supply an installer that runs 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 upCast on your machine.
When you launch upCast for the first time, you will be presented with a window containing the Software License Agreement for using upCast. Please read that agreement carefully. If you agree to the license, click , otherwise choose and remove the application from your storage device(s).
On Windows machines, start the application with the help of the Windows menu, in the group . In case you installed our upCast JAR archive without the help of the installer, simply double-click the upCast JAR archive icon (requires J2SE version 1.3 or later).
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\upcast.jar and hit the return key.
On Unix systems you either need to type upCast_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 upCast JAR archive, type java -Xmx512M -jar upcast.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.upcast.UpCast.
When requesting or purchasing a license from infinity-loop, you'll receive a file named upcast.license by email. This is your license key, store it in a safe place (make a backup to a different storage medium).
You can supply this license file in three ways: by importing it into a running instance of upCast, by placing it at a specific location in your computer's file system or by packaging it into the upcast.jar file (advanced users only).
To register, either click in the startup dialog or choose from the menu.
In the Registration Details dialog, click and choose the license file (usually named upcast.license).
You will be asked whether you want to copy the license into the default {Licenses Folder}. Usually, you should click to have the license read by upCast automatically it starts up.
After processing of this file, your license details should be displayed in the text area of the dialog. Click .
If you have trouble registering upCast with the attached license file, please contact us at <<support@infinity-loop.de>>.
Drop the file upcast.license into the {Licenses Folder}.
(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:
{JAR Resource Location Path}/licenses/