Installation

Table of contents

Advanced topics



Overview

Acelet-Scheduler comes with a GUI installation program, the installer. The installer is written entirely in Java. It is operating system neutral. It is an interactive program which guides the installation process.

The installer is user friendly:

You can get context sensitive help in the installer by pressing the F1 key. F1 shows context sensitive help about the GUI object that currently has focus. If there is no GUI component on focus, try to click on a focusable GUI component.

Prerequisite

Hardware

The requirement for hardware is very low. The smallest hardware configurations tested are: 

These are minimum requirement. You probably need better hardware. 

Disk space requirement is low: Client side is about 10M.

Software

General

JDK (Java) must be installed and ready to run.

We do not support Exceed or Cygwin. If you run installation on Unix environment, please do it on a native Unix machine. You do not really need Exceed/Cygwin: 

We encountered core dump when we used Exceed (7.0) with JDK 1.2. It seems okay when we use JDK 1.3 from Sun. Some users have reported problems using IBM JDK 1.4. You can try Exceed, but if you have problem, please go to a native Unix machine instead.

Privilege required

Sufficient privilege is required for installation and execution.

General

You need write privilege for the installed directory and sub directories.

For execution: You need write privilege for installed directory (default is acelet-scheduler) and sub directories.

Running the installation program

The installation process takes about 30 seconds.

This document assumes that <Acelet-Scheduler Home> (the default installation home directory) is acelet-scheduler.  It could be /usr/local/acelet-scheduler or c:\acelet-scheduler.

Do not install on top of a previously installed directory.

1. Extract software package
If you get the software from our web site, it is a zip file. The file name is either Acelet-Scheduler-eexxx.zip (xxx is a three digit string indicating the version number of Acelet-Scheduler-ee). For example acelet-scheduler-ee700.zip

Extract it to a temporary directory using either of the following:

  > jar xf acelet-scheduler-eexxx.zip
  > unzip acelet-scheduler-eexxx.zip

2. Run GUI installer:

    > install  (for Windows)
    $ . ./install.sh  (for Unix)
 

Follow the instructions to install. If you have any questions, please press F1 key for help. The GUI installer is written in Java (Swing). It is operating system neutral.
 

For upgrade from earlier versions

Running installed program

As the installed instructs you:

Go to <Acelet-Scheduler Home> (the installed directory, default acelet-scheduler) and run:

> as.bat  (Windows)
or
$ sh as.sh   (Unix)

Or click the installed shortcut (desktop icon) to start Acelet-Scheduler.

Uninstall

You can the following program to uninstall:

uninstall.bat (Windows)

uninstall.sh (Unix)
 

under <Acelet-Scheduler Home> (the installed directory, default is acelet-scheduler). 

If shortcuts are installed (for Windows), you can launch uninstall program from the shortcut as well.
 

Manually uninstall

1. Uninstall client: 

Delete the directory of <Acelet-Scheduler Home> (default is acelet-scheduler) and all sub-directories. If the demo database is running, you need to shutdown the database first.

2. Remove shortcut menu:

If you installed shortcut, right click them and delete them.

Note: If you do not uninstall any of them, there will be no harm for your system: they take relatively small amount of disk space. If you do not call, they just stay there doing nothing.

Tested platforms

Acelet-Scheduler is written entirely in Java. It runs on any platform which supports Java.

Tested platforms are:

Set your client environment

This is an advanced topic.

The following files are created by the installation program for setting your environment variables on the client side:
    setEnvironment.bat   (for Windows)
    setEnvironment.sh     (for Unix)

Those files are on Acelet-Scheduler Home (the installed directory).


Install, run and uninstall demo database

This is an advanced topic.

The Simple install option of the installer installs a local database as part of the installation on sub-directory database of Acelet-Scheduler Home (default is acelet-scheduler), as the demo database. The demo database is  open source Java database Hypersonic SQL.

The demo database is for many components, such as, SuperScheduler and SuperWatchdog. It is for evaluation and demo only. 

For production use, you can replace it with your favorite database in your network.

Run the demo database

When Acelet-Scheduler starts, it starts the local database (the demo one, if it exists). When Acelet-Scheduler is terminated, the local database will not be shutdown by Acelet-Scheduler automatically.

Stop the demo database

Run stopDatabase.bat (for Windows) or stopDatabase.sh (for Unix) under database directory.

Uninstall the demo database

Run uninstall program either:

Use other database as default database

This is an advanced topic.

You can use any SQL database as your database. You need database schema for creating tables for that database. Please contact us.

Install License

This is an advanced topic.

Your license file is an XML text file. It should be installed at the same location as the program files in question.

The license file contains installation instructions. Please read the instructions as well.

You need to install Acelet-Scheduler first. Then, go to the main menu > System Install License. A JFileChooser will pop up. Choose your license file to install. Acelet-Scheduler will install all applicable licenses. If the new license file contains a server side license, Acelet-Scheduler will prompt you before installing.

Do not modify your license file. If you accidentally modified it and corrupted it, you need delete it and re-install it.

Command line install

This is an advanced topic.

Command line install is for:

The difference between command line install and GUI install:

How to install:

  1. Go to a temporary directory.
  2. Unzip acelet-scheduler-eexxx.zip (xxx denotes for version number, for example acelet-scheduler-ee700.zip) to this temporary directory.
  3. Prepare a file named install.properties and put the file on the current directory.
  4. Run: 
java -cp superee.jar com.acelet.s.install.CommandLineInstall

The file install.properties must be on the temporary directory (the current directory). It must contains the following properties:

action
envoyName
serverHomeDir

It may contains the following optional properties, depends on the action:

superHomeDir
domainDir
otherLibraryFile

Available values for actions are:

installClient

It must be exact spelling. If the envoyName is not valid, a list of supported server name will be printed on your screen.

Example install.properties:

action=installSuperLoggingLibrary

Common installation errors

This is an advanced topic.

1. The installation never shows up.
The installation window is behind other windows. Please close or minimize other windows before installing.
2. You do not have written privilege under server directory.
Work with your administrators to install server side components.

   


   Copyright 1999-2014 Acelet Corporation. All rights reserved.