AimAdt Installation Instructions Version 1.0.2, 6/2005 Copyright @2004 Halegate Software www.halegatesoftware.com AIMADT INSTALLATION ------------------- CONTENTS: -------- OVERVIEW PRE-REQUISITES INSTALLING AIMADT UNINSTALLING AIMADT OVERVIEW -------- This file contains the installation instructions for AimAdt. It is applicable to both the Trial and Full editions. PRE-REQUISITES -------------- Before installing AimAdt on your system, you must have an appropriate Java runtime installed on your system, version 1.4.2 or later. If you do not have a JRE installed, either alone or as part of the Java SDK, you may download either the JRE or SDK from http://java.sun.com. The SDK is required if you intend to use AimAdt for Java or C/C++ development, but should not be necessary for stand-alone use. Other JRE/SDK's such as the Blackdown and IBM distributions might also work, but Microsoft's will not. If you are going to use AimAdt for C/C++ development, be sure that the SDK supports the Java Native Interface (JNI). Not all SDK's do. You will of course also need the AimAdt download file. You can put this file in any directory that is convenient. You should make a backup copy of this file just in case anything happens to your system. INSTALLING AIMADT ----------------- The installation instructions given here are the most basic approach. Your system administration policies might require certain files to be put in specific directories. If this is necessary, simply copy the files to the desired location. These files will have to be maintained manually when the application is upgraded or removed. To Install AimAdt: 1. Ensure that the "JavaHome/bin" directory is in the PATH variable (both Windows and Linux). A quick way to check that this is properly set up is to open a command window, go somewhere outside of the java installation directory path, and enter "javac". You should get the javac Usage information. If you get an error indicating that javac was not found, you need to fix the PATH variable. 2. Decide which directory will hold the AimAdt application. You do not need to create the directory, because the installer will do that for you if it does not already exist. A typical Windows installation might use, for example, the directory "C:\Program Files\aimadt". On a Linux or other Unix-like system, the directory might be "/usr/local/aimadt". 3. In a command (console) window, set your current directory to the location of the AimAdt download file. Start the installation process using the Java command: java -jar aimadtpkgx_x_x.jar Where x_x_x is the version number with a 't' or 'f' flag to indicate the trial or full edition. The installer will start; follow the instructions to complete the installation. It is possible that the file you downloaded has a .zip suffix instead of the .jar suffix. No matter; just use the exact name of your file. 4. Your AimAdt application directory should now contain the files specified in the Readme file under "DISTRIBUTION CONTENTS". 5. Setup the Java environment so that the aimadt.jar library file can be found. Do this by adding the directory and jar file name to the system CLASSPATH variable. For example, if you installed AimAdt into the Windows "C:\Program Files\aimadt" directory, then add the following to CLASSPATH: C:\Program Files\aimadt\lib\aimadt.jar Use the same basic approach for a Linux installation. 6. To use AimAdt with your Windows C/C++ programs, you must set your development environment to access the AimAdt library files, as well as the Java VM runtime. There is more than one way to handle this process. The following is an example of one approach for Microsoft Visual Studio .NET; other IDE's should be similar. For this example, we assume that AimAdt is located in "C:\Program Files\aimadt\", and the Java SDK is located in "C:\j2sdk1.4.2\": o. add the following directories to the system PATH variable: C:\Program Files\aimadt\lib (the location of aimadtintf.dll) C:\j2sdk1.4.2_05\jre\bin\client (the location of jvm.dll) o. add to the IDE properties "C/C++ | General | Additional Include Directories" section: C:\j2sdk1.4.2_05\include (the location of jni.h) C:\j2sdk1.4.2_05\include\win32 (the location of jni_md.h) C:\Program Files\aimadt\include (the location of aimadtintf.h) o. add to the IDE properties "Linker | Input | Additional Dependencies" section: jvm.lib aimadtintf.lib o. add to the IDE properties "Linker | General | Additional Library Directories" section: C:\j2sdk1.4.2_05\lib (the location of jvm.lib) C:\Program Files\aimadt\lib (the location of aimadtintf.lib) 7. To use AimAdt with your Linux C/C++ programs, you must set your development environment to access the AimAdt library files, as well as the Java VM runtime. The following is one approach. For this example, we assume that AimAdt is located in "/usr/local/aimadt", and the Java SDK is located in "/usr/java/j2sdk1.4.2": o. add the following directories to the system LD_LIBRARY_PATH variable: /usr/local/aimadt/lib (the location of libaimadtintf.so) /usr/java/j2sdk1.4.2/jre/lib/i386/client (the location of libjvm.so) /usr/java/j2sdk1.4.2/jre/lib/i386 (the location of various java libraries) o. when you create the Makefile for your projects, set them up like the example Makefile in "/usr/local/aimadt/cproject/linux". Keep in mind that this Makefile is intended to be moved up one directory level (to the directory containing the example C++ source file) before being used to compile the example. o. If you are going to use the standalone program by running it from its shell script (SaAimViewer.sh) you will need to change the permissions on the file to allow it to be executed: chmod a+x SaAimViewer.sh This concludes the installation instructions. If you have problems with the installation of AimAdt, you can get support through the AimAdt support site. Check the "Support" page at "www.halegatesoftware.com". UNINSTALLING AIMADT ------------------- Uninstall AimAdt by simply removing all of the files from the AimAdt application directory, except any files that you have put there that you want to keep.