Express Designer
Version 1.3.1
Installation Procedure
Contents

     a. Conventions

     1. Note

    2.  Pre Installation
           2.1 Java RTE
           2.2 Unzip

    3.  PC Installation
           3.1 Installation Steps
           3.2 Launching Express Designer
                 3.2.1 Launching from the Desktop
                 3.2.2 Launching from the CLI
           3.3 Install Issues
                 3.3.1 Manual Shortcut Creation
                 3.3.2 Manual Icon Application
                 3.3.3 Manual Shortcut Copy to Desktop
                 3.3.4 Manual Shortcut Move to Start Menu
                 3.3.5 Register the File Type Extensions
                 3.3.6 Associate the File Types with Express Designer
                 3.3.7 Associate the Custom Icon with Express Designer

   4. Generic Installation


a. Conventions
BDI  refers to the Basic Designer Interface
CDI  refers to the Complex Designer Interface
CLI  refers to your platform's Command Line Interface
Text in This Type refers to on screen buttons
Text in This Type refers to top level menu items
Text in This Type refers to specific menu selections, or input field labels
Text in This Type refers to file names
Text in This Type refers to text you enter into the CLI
Text in This Type refers to text generated by entering a CLI command
1. Note
Java installations are platform specific. The installation procedures try to be as accommodating as possible, but some platforms may require additional, custom steps to get them to launch Express Designer like a native application. As new methods of installation are tested on different platforms they will be incorporated whenever possible. In addition, the FAQ's page will be updated with install issues as they are discovered.

The following discussion describes 2 methods of installation for the PC world and another, generic one, for all other platforms. The end result will be an application that can be run from a CLI and in many cases an application that behaves just like a native one.

2. Pre Installation
You should have been e-mailed a userID and password to obtain the product. If you don't have them, email us immediately. Otherwise, set your browser to http://alphse.com/aex/ready.html and enter the information. You must agree to the license. enter the UserID and password your were e-mailed and click the Log-in button. The page you get back will look like the one below and have a link to the Express.zip file.

Regardless of platform, you will need a suitable Java Runtime Environment (JRE) installed on your system. Depending on your platform, you may also need an unzip utility - see below. It's likely you already have both on your system now.

2.1 Java RTE
Most likely, you already have a JRE of at least version 1.3.0 or above. If not, they are easy to get and are free. To see if have one open a command line window, like MS/DOS in the PC world, and enter
java -version.
If you get an error, try,
jre -version.
If you still get an error, you'll need to install a JRE. Where you go to get it depends on your platform. For PC users, try CNet Download.com . For Sun Unix & Linux: Sun Download Center. Apple Mac users go to Apple®.  Alpha users, now go to HP® . There are many, other sites as well.

2.2 Unzip
If you are doing a PC installation and do not have a zip/unzip utility, you can avoid installing one now by downloading the self-extracting executable, instead of the zip file, then download the license file separately after the install is completed.
If you would like to have a zip/unzip utility, go to the WinZip® web site and download and install an evaluation copy. Or, go to Google® or  ZDnet® and search for unzip. There are many sellers. None are expensive and some are free.

Important: For production-related reasons, the Express.exe file contains a pre-expired license file (aex.key), while the Express.zip file contains your valid, personal license file, created when you ordered the product.
 

3.3.5 Register the File Type Extensions
  1. Go to the target directory and enter :

  2. associate .aex=ExpressDesigner.Basic
  3. If your licensed for Standard Edition, or above, enter :

  4. associate .aex=ExpressDesigner.Complex
  5. If your licensed for Enterprise Edition, enter :

  6. associate .aex=ExpressDesigner.Complex2
3.3.6 Associate the File Types with the Express Designer
  1. Go to the target directory and enter :

  2. associate ExpressDesigner.Basic(ExpressDesigner) Open="target-directory\bdi.bat" "%1"
  3. If your licensed for Standard Edition, or above, enter :

  4. associate ExpressDesigner.Complex(ExpressDesigner) Open="target-directory\cdi.bat" "%1"
  5. If your licensed for Enterprise Edition, enter :

  6. associate ExpressDesigner.Complex2(ExpressDesigner) Open="target-directory\cdi.bat" "%1" -type global
3.3.7 Associate the Custom Icon with Express Designer
  1. Go to the target directory and enter :

  2. associate ExpressDesigner.Basic(ExpressDesigner) :ICON="target-directory\PCIcon.ico,0"
  3. If your licensed for Standard Edition, or above, enter :

  4. associate ExpressDesigner.Complex(ExpressDesigner) :ICON="target-directory\PCIcon.ico,0"
  5. If your licensed for Enterprise Edition, enter :

  6. associate ExpressDesigner.Complex2(ExpressDesigner) :ICON="target-directory\PCIcon.ico,0"
4 Generic Installation
Express Designer must be installed and run from a Command Line Interface (CLI) or similar facility that allows the main java program to be called with at least one parameter value - i.e. java com.alphase.aex.bdi.
The following steps assume an intermediate level of knowledge about your platform.
  1. Identify, or create, a directory to use as a temporary holding area (an empty one is best).
  2. Download and unzip the Express.zip file into the directory above.
  3. Open a CLI window and set your current, working directory to the directory above ( e.g. cd /root/MyTemp )
  4. Enter:  java install
  5. When the File Selection box appears, select the directory you want to install the product in. The installer will create an aex  subdirectory under it, which is known as the Target Directory.

  6. Note: If java cannot find the install class, include the current working directory in the classpath argument (e.g.  java -cp ./ install ). The exact syntax of the classpath argument will depend on your platform. Entering java with no arguments will usually display the accepted choices. Typically it's something like -cp or -classpath.
To run Express Designer's basic design interface (BDI), the Java Virtual Machine (JVM) must know the fully qualified name of the class (i.e. com.alphase.aex.bdi) and where it can find the Target Directory which contains the Express.jar file. The qualified class name is always a required argument, but identifying the Target Directory can be done either directly, within the command line, or indirectly by assigning a symbol, or logical name to point to the file beforehand.

To include the Target Directory directly, within the command line, invoke java from your CLI with the Target Directory followed by Express.jar followed by a space and the qualified class name  - e.g.

java -cp /Root/bin/aex/Express.jar com.alphase.aex.bdi.


When the path to the Express.jar file is specified indirectly, you assign a specific symbol or logical name before invoking java - e.g. setenv CLASSPATH /root/bin/aex/Express.jar. Again, the exact syntax will depend on your platform. When done this way you just have to enter:

java com.alphase.aex.bdi
to invoke the BDI. Some platforms, like VMS, will require you to specify the class name as a quoted string to preserve lower case - e.g.:
java "com.alphase.aex.bdi"
At this point it's best to create a symbol to invoke Express Designer in the future.
Unix example:
alias exbdi java com.alphase.aex.bdi
VMS example:
exbdi == "java ""com.alphase.aex.bdi"""
The CDI is setup and run in the same way as the BDI.
 


© 2002, 2003 Alpha Software Express, LLC. All rights reserved.