Brine Gridding and Mapping
Download Website to your PC

This web page are instructions to download the BRINE_MAP-WebSite Directory with all the files necessary in building the Brine Gridding and Mapping WebSite on the Kansas Geological Survey (KGS) server.

You will also need PuTTY on your PC to move the Website to the KGS Server, see next section PuTTY, or some other software. The release.bat and release_help.bat are PC Batch Files that specifically use PuTTY to move the files & directories to the KGS Server. If you use the script you will need to replace PC to the full path, i.e. c:\users\{your PC name}\Documents\{your path}\BRINE_MAP-WebSite. It is also stated at the top of both Batch files.

The Brine Gridding and Mapping Application Website is bundled by 2 methods as a ZIP file and as a JAR File. Both will create the BRINE_MAP-WebSite directory with all the files to build the Brine Gridding and Mapping Website on the KGS Server. The sign_jar.bat is a PC Batch File designed for the Windows Environment, but it shows the procedure for signing the jar file so the JAR file can be used as a Trusted Applet. If you use the script you will need to replace the call "C:\jdk1.7.0_25\bin\" in the script to the JDK directory that you downloaded to your PC in the download.html instructions.


PuTTY

"PuTTY is a free implementation of SSH and Telnet for Windows and Unix platforms, along with an xterm terminal emulator. It is written and maintained primarily by Simon Tatham.

LEGAL WARNING: Use of PuTTY, PSCP, PSFTP and Plink is illegal in countries where encryption is outlawed. We believe it is legal to use PuTTY, PSCP, PSFTP and Plink in England and Wales and in many other countries, but we are not lawyers, and so if in doubt you should seek legal advice before downloading it. You may find useful information at cryptolaw.org, which collects information on cryptography laws in many countries, but we can't vouch for its correctness.

Use of the Telnet-only binary (PuTTYtel) is unrestricted by any cryptography laws."

To download PuTTY go to, http://www.chiark.greenend.org.uk/~sgtatham/putty/

To log into Kansas Geological Server (KGS) - Gondor, you well need to set up the PuTTY configuration to look at Gondor server Host Name (or IP address) 129.237.140.42 Port 22 as SSH connection type. When you select the "Open" button you will get a "Command Prompt" like window with "login as:", enter webadmin, the password you will need to get from KGS computer services.


Directory Structure of BRINE_MAP-WebSite

/GRID - directory holds the /lib directory, PDF Help document and the Run.bat PC Batch File for running as an application. This is the working directory for building a GRID.zip file so the user can download the file to their PC and run the Brine Gridding and Mapping as an application.

/WebSite - directory is the Brine Gridding and Mapping Website
   release.bat - Windows Batch file for moving the Brine Gridding and Mapping Website to the KGS Server.
   sign_jar.bat - Windows Batch file for signing the JAR file so it can be used as a Trusted Source.
   GRID_Help.docx Brine Gridding and Mapping Help File


REMEMBER:
To replace the "C:\jdk1.7.0_25\bin\" with the JDK directory path you downloaded to your PC in the sign_jar.bat file.

Before you run the script you will need the keystore for the Kansas Geological Survey (KGS) web site.

You will need to get the storepass & keypass passwords from the KGS computer services and then replace {password1} and {password2} in the sign_jar.bat file at the jarsigner call.

sign_jar.bat

Sign JAR File so the Brine Gridding and Mapping Applet will be considered as a Trusted Source.

   Procedure

  1. Copy the Grid.jar file from the /BRINE_MAP/lib directory to the top level of the directory, i.e. at the same level as the sign_jar.bat file.
  2. Open a Command Prompt window. In a Command Prompt window enter: sign_jar. This will run the jarsigner script.

    C:\jdk1.7.0_25\bin\jarsigner -tsa http://timestamp.digicert.com -keystore "C:\Documents and Settings\{your PC name}\a_kgs_ku_edu.jks" -storepass {password1} -keypass {password2} Grid.jar server

    If any errors, you will see it in the Command Prompt Window.

  3. The script will automatically copy Grid.jar to the WebSite Directory.
  4. The script will automatically move the Grid.jar to the \GRID\lib directory.

release.bat

The PC Batch file release.bat will move the contents of the /WebSite Directory to the KGS Server.

  1. Place your mouse on the \GRID directory. Then right click with your mouse. Select the WinZip menu item. Which will display another list, choose the GRID.zip sub menu item. This will create a GRID.zip file in the top directory. Move the GRID.zip to the \WebSite directory.
  2. Double click on release.bat, which will immediately display a "Command Prompt" Window requesting the password, enter the password for webadmin, the password you will need to get from KGS computer services. The program will move the contents of WebSite up to the KGS Server.
  3. Verify your changes by going to the Brine Gridding and Mapping Web Site, http://www.kgs.ku.edu/PRS/Ozark/Software/Grid.

Author: John R. Victorine jvictor@kgs.ku.edu

The URL for this page is http://www.kgs.ku.edu/PRS/Ozark/JAVA_SRC/BRINE_MAP/upload.html