Installing and Running the SARTopo Desktop App - macOS

Note: SARTopo users can assume that any instructions for CalTopo also apply to SARTopo.

To install the SARTopo Offline App you will need:

  • SARTopo App
  • SARTopo map data for your desired area
  • Java Standard Edition JDK

Installation Instructions

  1. Download and install the SARTopo app

    Decide whether you want to install SARTopo Offline on your computer's hard drive, a thumb drive or an external hard drive. Depending on how much map data you plan to download, it may not fit on your computer's hard drive. If you're not sure, start by installing it to your computer's hard drive now, it can be copied to another drive later if needed.

    Sign-in to your offline account on SARTopo.com.

    Click on your account name at the top of the left bar, then the "Offline Access" tab, or go directly to https://sartopo.com/offline/app.

    Click on "fresh install" and download the sartopo-offline.zip file to your computer.

    freshinstall_sar.png

    In Finder, go to the folder that contains the sartopo-offline.zip file (probably Downloads) on your computer. Double click "sartopo-offline.zip" to open it. The file is unzipped to a "sartopo" folder.

    mac_open_zip_file_-_sar.png

    For security reasons, MacOS requires you to move downloaded applications to a new location before running them. In Finder, open the "mac - read instructions" folder and drag the "SARTopo Offline" app into the "sartopo" folder above it.

    mac-data_move_SARTopo_Offline_to_sartopo.png

    Now delete the "mac - read instructions" folder.

    mac-data_delete_mac_-_read_instructions_folder_-_cropped_-_sar.png

  2. Install Java Standard Edition JDK
    Go to http://www.oracle.com/technetwork/java/javase/downloads/index.html, click on "Download" under "JDK".

    java_jdk_macos.png

    To download the installation file, click "Accept License Agreement" and the link for "Mac OS".

    java_jdk_2_macos.png

    Once the installation file is downloaded, open it to run it. Accept all of the default installation options.

Running SARTopo Offline

SARTopo Offline is essentially the same program as sartopo.com. Whereas sartopo.com is hosted by a web server in the Internet cloud, SARTopo Offline is hosted by a local web server on your computer. In both cases you use a web browser to interact with the server.

Therefore it takes two steps to run SARTopo Offline:

  1. Start the SARTopo Offline server:

    In Finder, open the "sartopo" folder and right-click on the "SARTopo-Offline" file and select "Open".

    run_sartopo_2_cropped.png

    Your computer will ask if you are sure you want to run an app from an "unidentified developer". Click "Open".

    sartopo_unidentified.png

    After the first time, you can run the app by just clicking on it.

    A SARTopo Offline console window will open. You can minimize this window, but don't close it.

    sartopo_console.png

    The server is now started and you can go to a browser to access the functionality.

  2. Open a web browser (Chrome is recommended). On a new tab, go to http://localhost:8080.

    new_tab_v2.png

    The server may take some time to get up and running. If initially you get a web page error (e.g. a “This webpage is not available” or "This site can’t be reached" message), then the local web server may need more time to get fully started. Wait for a few seconds and refresh the page.

Stopping the SARTopo Offline server

When you are finished using SARTopo Offline:

  1. Close the SARTopo Offline tab in your browser
  2. Click "Cancel" and then "Quit" in the SARTopo Offline Console

    cancel_sartopo_console.png

Accessing the SARTopo Offline server from another computer

If multiple computers are on the same Local Area Network (e.g. connected to the same router), each of the computers can connect to the SARTopo Offline server running on one of the computers. To do so, each computer opens an web browser and enters the Server Address displayed in the SARTopo Offline console (eg. http://My.Mac.local:8080).

Updating SARTopo Offline to a New Version

To update your version of SARTopo Offline, download a new version of the sar.jar file to your sartopo folder.

Sign-in to your offline account on SARTopo.com.

Click on your account name at the top of the left bar, then the "Offline Access" tab, or go directly to https://sartopo.com/offline/app.

jar_only_sar.png

Click on "JAR only" and move the sar.jar file from your Downloads folder to your sartopo folder.