CHAPTER 2
Installation

This chapter provides the minimum and recommended platforms for SIMPROCESS and the installation instructions for those platforms. If assistance is needed with installation, instructions are provided for getting technical support from CACI.

Hardware and Software Requirements

One of the unique features of SIMPROCESS is that it runs on multiple platforms. Before installing SIMPROCESS, review the hardware and software requirements and make sure that the system meets the minimum requirements.

System Requirements

Operating System	Minimum Requirements	Recommended
Windows 2000, XP, Vista, or Server 2003	512 MB RAM	1024 MB RAM
Linux (Red Hat 6.x through 8.x, or compatible)	Intel x86 or compatible processors only. More RAM is always better. The Gnome and KDE desktop environments should work.	Try in the Linux environment to be sure it works correctly.

Note for Windows Users: Administrator privileges may be needed to install SIMPROCESS. The default install location of C:\Program Files may require special privileges, or the installed program may encounter difficulties writing to the program's directories.

Note for Linux Users: The licensing software employed by SIMPROCESS is only designed to operate on systems designated as "compatible" with Red Hat 6.x through 8.x. Not all Linux distributions meeting this criteria are guaranteed to work. SIMPROCESS has been installed and tested on several Linux distributions, but SIMPROCESS will need to be tested to ensure compatibility with a specific Linux system. SIMPROCESS technical support may be able to help get SIMPROCESS operational.

Software Requirements

Software	Minimum Requirements	Recommended
Database software (on Windows only)	Microsoft Access 2000
Microsoft Data Access Components	Version 2.5	Version 3.525 or higher

Please review these requirements carefully before installing SIMPROCESS.

Installing SIMPROCESS

SIMPROCESS can be download via the World Wide Web at www.simprocess.com. CD-ROM versions are available upon request. The installation process is only slightly different between the two methods. To install SIMPROCESS:

· If installing from a CD, insert it into the CD-ROM drive. Linux users should mount the CD. The installation program should start automatically in Windows. If it does not, double click the starthere.htm file to continue. Linux users should open this file in a web browser.

· If installing from a CD, there is an installer for Adobe Reader, as well as some documentation and some of the other files that will be installed by the installer program. To continue with the installation, select SIMPROCESS Installer.

· This step opens a web page in a browser. This is the same page presented on the web. When the page loads, there are several options. If the browser is Java-enabled, a Java applet will load that may be able to perform the installation. This applet requires permission to read and write files on the system, so a window might be displayed asking whether or not to run the applet. To use the applet installation method, click Grant to allow it necessary access. Click Deny to not use the applet.

· There will be a button for the platform (though it may not work if the applet privileges were denied). Click the button to start the installation. (If the browser's Java is not Sun's Java, installation using the button may encounter errors. If errors occur, proceed to the next step.) SIMPROCESS will install its own Java Runtime Environment (JRE). This will not conflict with any other Java software (Java Runtime Environment, Java Plugin, etc.) otherwise installed on the system.

· If not using the button (applet) or there are errors using the button, download the installer via one of the links for the platform. The links give the approximate size of each installer file and how to run it once downloaded. (The button will perform the installation, but it will leave the installer file on the system. It will have the same name as the one in the links, so that it can be found and saved.)

· Click the applet's button or follow the instructions to start the installer downloaded. The installer program steps through the installation process.

· The first step in the installer will be to display a License Agreement. Read the text and, assuming agreement, select the appropriate button, then click Next to continue with installation.

· The next panel will ask where to install SIMPROCESS and provide a default location. Choose an appropriate location or accept the default, then click Next.

· The next panel displayed will be entitled Choose Install Set. The SIMPROCESS install set is the default selection and should be used by most users. The SIMPROCESS and Dispatcher install set includes all the components for operating SIMPROCESS as a desktop application, plus a directory named dispatcher as well as a new Dispatcher application in the installation directory. The Dispatcher components are licensed separately from the SIMPROCESS, so choosing this install set unnecessarily will only consume disk space.

· The next panel will offer options as to where to install program icon files, and finally a summary panel will then be shown. After all installation options have been selected, click the Install button to proceed with the installation process.

· After all items are installed, there will be a series of dialogs that set the locations of some programs referenced by the SIMPROCESS application. The values entered here (if any) will become part default values for use in the program preferences and can be changed at any time. So if the locations are unknown or perhaps those program are not installed, select Cancel in response to these dialogs. On Windows systems only, SIMPROCESS will install a Microsoft Access 2000 database. Linux users should note that their systems may not contain the "suggested" default programs for text editor, spreadsheet program, etc. In order to work, the selected programs must be able to operate in an X Window environment.

· Installation is now complete. The installer panel will show where the files were installed, and clicking "Done" will quit the installer program.

· Run the hostid batch file or script in the SIMPROCESS directory. On Windows, the hostid batch file can be run from the Start Menu. This will place licensing information in the file named hostid.txt. Send this file to CACI (simprocess@caci.com) or the local License Administrator to obtain a license file and instructions for activating SIMPROCESS.

· Once a license file (license.dat) has been obtained, place it in the SPSYSTEM directory and test the installation. (See "Starting SIMPROCESS" on page 32.)

· Setup the Data source (See "Connecting Database to SIMPROCESS" on page 33.).

SIMPROCESS Directory Structure

The installation program creates the following directory structure in the location selected. Appendix C of the User's Manual contains a more detailed listing of the files installed.

SPSYSTEM

This directory contains numerous SIMPROCESS "system" files required to run the program. In addition, when SIMPROCESS is run it will create simprocess.log and simprocess.err to report any messages or errors. When a license file is received from CACI or the local license administrator, that file needs to be placed into this directory in order for SIMPROCESS to run.

models

When opening or saving models, SIMPROCESS initially starts in this directory. The demo and reference models are located here in the Demos and ExpressionDemos subdirectories.

SPUser

This directory holds the Microsoft Access database file (SimProcDB.mdb) on Windows systems. The related properties file (sProcDB.properties) will be placed here on all systems and must be present (and correct) in order to use any database with SIMPROCESS. For those using Linux (or Windows users wishing to use another database environment), the file simprocessdb.sql contains DDL statements tested with MySQL to create a database named "simprocess" with the necessary tables and data for use with the Experiment Manager. This file can be used as a template for other database environments. There is also a file named mysql.sProcDB.properties to serve as a template for using a local copy of MySQL with SIMPROCESS. The "jdbc.drivers" property entry must refer to the name of a Java class which implements a Java driver for the database. JAR files containing the needed driver(s) should be placed in the installed JRE's extensions directory (jre/lib/ext) in order to be available at runtime. User preferences will be stored in this directory after SIMPROCESS runs. Importing graphics files for use as icons or backgrounds, or saving Libraries, will create a file here named UserFiles.jar.

endorsed

This directory contains numerous Java Archive (JAR) files supporting the features of SIMPROCESS.

jre

This directory contains Java Runtime Environment components referenced by SIMPROCESS.

ext

This directory is for user created compiled Java classes that can be used by the RemoteCall and ExternalCall features of SIMPROCESS. See Appendix K, "SIMPROCESS and External Java Classes," in the SIMPROCESS User's Manual for more information.

dashboardserver

This directory contains the files required to run Dashboard Server. See Chapter 16 of the User's Manual for information on using Dashboards.

metamodel

This is the required directory for SIMPROCESS metamodels. See the Metadata Manual for more information on metamodels.

dispatcher

This directory only exists if SIMPROCESS and Dispatcher was selected during the installation. The installed files are required to operate SIMPROCESS through a Web service.

timeserver

This directory contains the files required to run the SIMPROCESS TimeServer. See Chapter 3 of the User's Manual and SIMPROCESS TimeServer.pdf in this directory for more information on the TimeServer.

Starting SIMPROCESS

To start SIMPROCESS and test the installation:

1. A SIMPROCESS icon was placed on the desktop during installation, or find the SIMPROCESS executable in the location specified at installation time (in Windows, look in the program group on the Start Menu that was selected at installation; by default, it's named SIMPROCESS). Double-click the appropriate icon or start the program by means appropriate to the platform.

2. From the SIMPROCESS main menu, select the File/Open option.

3. Select one of the demonstration or reference models (located in the Demos subdirectory of the models directory) and open the file.

4. Click on the Runner icon in the tool bar to start running the demo model.

The installation and licensing process was successful if a demonstration model can be loaded and run. If there are problems installing SIMPROCESS, please contact CACI's SIMPROCESS Technical Support at: (877) 663-3746.

Connecting Database to SIMPROCESS

To connect SimProdDB.mdb to SIMPROCESS (Windows users only), double-click on the computer's ODBC Control Panel. (Look for Data Sources (ODBC) under Administrative Tools on Windows.) With the User DSN tab selected click on Add.

Select Microsoft Access Driver (*.mdb) and click Finish.

After the Microsoft Access Setup dialog appears, type in SimProcessDatabase (all one word with the letter case as shown) for Data Source Name.

Under the Database heading, click on Select and browse to find SimProcDB.mdb in the SPUser directory. Once selected the database should be listed above the Create and Repair buttons.

Click OK and SimProcessDatabase will be listed on the User DSN dialog.

Previous SIMPROCESS Databases

The Access database included with SIMPROCESS has changed over time. The latest change to the database was in SIMPROCESS 4.2. Support for Connector statistics was added. Earlier changes included the addition of the StatType table and the removal of the Experiment Manager tables.

IMPORTANT: The installer will query as to whether to install a new Access database file if one is already present when installing over a previous release of SIMPROCESS. To use an earlier version Access database or employ methods below which allow both, move or rename the file SimProcDB.mdb before installation in order to get both database files.

Installing SIMPROCESS on Local Area Networks

SIMPROCESS is designed as a single-user application intended to run on individual systems or workstations. Installing it on a server and providing access to multiple users simultaneously will create problems with concurrent file accesses. Each individual user should have a separately installed copy, although these may reside on a single server system.

Getting Technical Support

CACI provides worldwide technical support for its licensed users from its corporate offices in Virginia. Our office hours are from 8:00 a.m. to 5:00 p.m. Eastern time. When calling and faxing for technical support please address inquiries to: SIMPROCESS Technical Support. The numbers are

(877) 663-3746 - Voice

(703) 679-3354 - Fax

In order to expedite responses to technical problems or questions, please use e-mail to send questions to simprocess@caci.com. Refer to the release and build numbers that appear under the Help/About SIMPROCESS when reporting problems. If a model demonstrates the problem encountered, please attach the compressed model file (along with the simprocess.log and/or simprocess.err files if either is not empty) to the e-mail.

Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com