Java SE 6 (1.6.0) is required for the Landslide Tcl API. The 1.6.0 JRE can be downloaded from the Landslide Troubleshoot Java Web Start Problems page or from SUN's Java website. Once you have installed the Tcl API, go to the Using the Tcl API topic in the Landslide User Guide.
If do not already have Tcl installed on your system, you can use our provided version of Tcl 8.4 that is prepackaged to work with our Tcl API.
1. Download Linux Tcl Base Install (linuxtclblend.tar.gz) and Landslide Tcl API Packages/Files (landslidetclapi.zip) 2. Create a new directory on your computer, e.g. ~/landslidetclapi 3. Extract linuxtclblend.tar.gz to that directory a) cd to the directory b) gunzip c) tar xf 4. Extract landslidetclapi.zip to that directory a) cd to the directory b) jar xf or unzip (You will need either jar utility or unzip utility in your path) 5. Copy jtclsh to landslidetclapi 6. Edit landslidetclapi, setting the api_home and jre_home # Install location for tclblend and landslide Tcl API # Set these to the location of your tclblend and JRE api_home=/home/user/landslidetclapi <--- Path to your directory jre_home=/usr/jre1.6.0_10 <--- Path to your JRE install. if needed the Java memory can be increased with: export JAVA_MAX_MEMORY=256m 7. Make sure lansdlidetclapi is executable, then run it.
1. Download Windows Tcl Base Install (windowstclblend.zip) and Landslide Tcl API Packages/Files (landslidetclapi.zip) 2. Create a new directory on your computer, e.g. C:\landslidetclapi 3. Extract windowstclblend.zip to that directory 4. Extract landslidetclapi.zip to that directory (you can use a zip utility like Winzip or the jar tool that comes with Java JDK) 5. Copy jtclsh.bat to landslidetclapi.bat 6. Edit landslidetclapi.bat, setting the API_HOME and JRE_HOME rem Set this to where you installed Landslide API set API_HOME=D:/COTS/tclapi rem Set this to where Java/JRE is installed set JRE_HOME=c:/Programs/Java/jdk1.6.0_10/jre if needed the Java memory can be increased with: set JAVA_MAX_MEMORY=256m 7. Run landaslidetclapi.bat
If you already have your own Tcl installation, then you can install our Tcl API as a package to your Tcl configuration. Your Tcl must be version 8.4 or later and be compiled to support threading.
First follow the Standalone Installation instructions. If you want to use our startup script, just change the JTCLSH variable to point to your own jtclsh/tclsh executable. The script will take care of all the setups. Otherwise, if you need to use your own startup script, three things must be configured. 1. LD_LIBRARY_PATH must include the following paths: $JRE_HOME/lib/i386/client $JRE_HOME/lib/i386/native_threads $JRE_HOME/lib/i386 $API_HOME/lib/tcljava1.4.1 2. CLASSPATH must be set and include the following paths: $API_HOME/sp_product.jar $API_HOME/coast_shared.jar $API_HOME/coast_client.jar $API_HOME/landslidetclclient.jar 3. TCLLIBPATH must include the following path AFTER your default paths: $API_HOME/lib Where JRE_HOME is the path to the Java/JRE installation and API_HOME is the path to the Landslide Tcl API installation (i.e. from step 2 in standalone install) Note: Our jtclsh script includes all of these variables, so you can see how we did it.
First follow the Standalone Installation instructions. If you want to use our startup script, just change the TCLSH variable to point to your own jtclsh/tclsh executable. The script will take care of all the setups. Otherwise, if you need to use your own startup script, three things must be configured. 1. PATH must include the following paths: %JRE_HOME%\bin\client %API_HOME%\lib\tcljava1.4.0 2. CLASSPATH must be set and include the following paths: %API_HOME%/sp_product.jar %API_HOME%/coast_shared.jar %API_HOME%/coast_client.jar %API_HOME%/landslidetclclient.jar 3. TCLLIBPATH must include the following path AFTER your default paths: %API_HOME%/lib Where JRE_HOME is the path to the Java/JRE installation and API_HOME is the path to the Landslide Tcl API installation (i.e. from step 2 in standalone install) Note: Our jtclsh script includes all of these variables, so you can see how we did it.
You must upgrade your Landslide Tcl API any time you upgrade your TAS! Just follow this simple procedure: 1. Download and extract Landslide Tcl API Packages/Files (landslidetclapi.zip) to your api directory 2. If upgrading from pre 6.5 release using JRE 1.5, you will need to change your JRE variables accordingly and possibly install JRE 6. Required Linux Libraries (ldd output): $ ldd tclsh8.4 libtcl8.4.so => /home/tester/tclapi/lib/libtcl8.4.so (0x40017000) libdl.so.2 => /lib/libdl.so.2 (0x400d7000) libpthread.so.0 => /lib/i686/libpthread.so.0 (0x400da000) libm.so.6 => /lib/i686/libm.so.6 (0x4012a000) libc.so.6 => /lib/i686/libc.so.6 (0x4014c000) /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) $ ldd libtclblend.so libjava.so => /usr/jre1.6.0_10/lib/i386/libjava.so (0x4000c000) libverify.so => /usr/jre1.6.0_10/lib/i386/libverify.so (0x40031000) libjvm.so => /usr/jre1.6.0_10/lib/i386/client/libjvm.so (0x06000000) libhpi.so => /usr/jre1.6.0_10/lib/i386/native_threads/libhpi.so (0x4003d000) libtcl8.4.so => /home/tester/tclapi/lib/libtcl8.4.so (0x407dc000) libdl.so.2 => /lib/libdl.so.2 (0x4089c000) libpthread.so.0 => /lib/i686/libpthread.so.0 (0x4089f000) libm.so.6 => /lib/i686/libm.so.6 (0x408ef000) libc.so.6 => /lib/i686/libc.so.6 (0x40911000) libnsl.so.1 => /lib/libnsl.so.1 (0x40a48000) /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x80000000)