Chapter 2. Installation/Configuration

There are four versions of the EspressChart installer, one for Windows, one for Unix, one for Mac OS X, and a Pure Java version. Although EspressChart itself is pure Java, the different versions make it easy to install EspressChart on the platform of your choice.

2.1. Running the Installer

Windows Version

To start the Windows installer, run the installEC.exe file and the installer will launch.

Unix Version

To start the Unix installer, run the installEC.bin file, and the installer will launch.

Mac OS X Version

To start the Mac installer, double click the InstallEC.zip file to extract the InstallEC.app file. Double-click on InstallEC.app, and the installer will launch.

Pure Java Version

To start the pure Java installer, a Java Virtual Machine, the equivalent of Java 1.2 or higher, must already be installed on the machine where EspressChart is to be installed. Make sure that the JVM is included in your path (or move the installEC.jar file to the same directory as the JVM). From a command prompt navigate to the directory where you have placed the installEC.jar file, and type the following command: java -jar installEC.jar. The installer will then launch.

Once the installation program has launched and you agree to the license agreement, the first option asks you to specify the directory into which you would like to install EspressChart.

The default location is \EspressChart\. You can specify a new directory or browse to one by clicking the Choose… button.

Click to view larger image

Choose Location Dialog

Once you choose an installation directory, the next option asks you whether you would like to install the evaluation or licensed version.

Click to view larger image

Install Version Dialog

If you elect to install a licensed version, the next dialog will prompt you to enter your license key and to verify the host name of the machine on which you're installing EspressChart.

Click to view larger image

Enter License Key Dialog

After you have entered the information, the installer will attempt to register the license key with Quadbase. If registration fails, you will be unable to continue installing the release version of EspressChart. You will have the option to continue installing the evaluation version. After the installation completes, you can register your key online at http://www.quadbase.com/register/, or contact Quadbase Sales for additional help.

[Note]Note

After the installation completes, the release version will only run for the hostname specified in this dialog, so double-check to make sure the host name is correct. You can also use the IP address of the machine if you prefer.

The next option allows you to specify a Java Virtual Machine to use when running EspressChart. (Since it is a Java program, you will need a JVM to run it.)

Click to view larger image

Choose JVM Dialog

The dialog prompts you to select which Java Virtual Machine you would like to use. A list of compatible JVMs on the system are displayed, allowing you to pick one. If the JVM you would like to use is not listed, you can click the Choose Another button to browse to it. When using the windows installer, you can also choose to install the JVM bundled with the installer, if a compatible JVM has not been found.

[Note]Note

The JVM that is bundled with the installer only provides a Java Runtime Environment. In order to develop and execute Java code using the EspressChart API, you will need to have a Java Development Kit, and/or compiler/IDE. Also, if you're using the pure Java, or Mac OS X version of the installer, this option will not appear. Make sure that you're running the installer with the JVM you wish to run the program.

The last option in the installer is for the Windows or Mac OS X version of the installer. It allows you to specify where to create the program shortcuts in the Start Menu, on the Desktop, or both. By default shortcuts are added to a program group called EspressChart in the Start Menu.

For Mac OS X you can create aliases on the Desktop, in the dock, or in a folder of your choosing.

After you complete the last option you will be shown a summary of the options you've selected. Next, the program will install.