Installing and Running the SARTopo Offline App - Windows

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 File Explorer, go to the Downloads folder and right-click "sartopo-offline.zip" and click "Extract All".

    extractall_v2_sar.png

    Specify the drive where you want to install SARTopo (e.g. "C:\") and click "Extract"

    unzip_location_V3.png

  2. Download the map data.

    SARTopo Offline is installed without any map tiles. To download the map tiles for your desired area, go to https://sartopo.com/offline/data.

    The red-shaded areas indicate areas where offline maps and data are available. Hover the mouse over a portion of the red-shaded areas and a solid-red, one degree square will appear.

    data_39_122_selected_v2_sar.png

    Click on the solid-red square of the block that you would like to download. On the right side of the page, a list of available data for that one degree square appears.

    Download the data files by clicking on the size of each file. Its important that you download all of the files.

    data_download_list.png

    Move the files from your Downloads folder into the sartopo > data > tiles folder (e.g. C:\sartopo\data\tiles).

    win-data_copy_mbtiles_sar.png

    Repeat the above steps for additional one degree blocks as needed.

  3. Install Java Standard Edition JDK

    Go to http://www.oracle.com/technetwork/java/javase/downloads/index.html. If your computer is running Windows 64 bit, click on "Download" under "JDK" in the Java SE 9 box. If your computer is 32 bit, click on "Download" under "JDK" in the Java SE 8 box. If you are unsure whether you have a 32 bit or 64 bit computer, the 32 bit will run on either type.

    java_jdk_win.png

    To download the installation file, cllick "Accept License Agreement" and choose the appropriate JDK for your Windows Operating System ("Windows x64" for a 64 bit computer, "Windows i586" for a 32 bit computer).

    java_jdk_2_win.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 File Explorer, open the "sartopo" folder (eg c:/sartopo). If you have Java version 9 installed, double-click on the "SARTopo-Offline-Java-9" file, otherwise double-click on the "SARTopo-Offiline" file.

    win-sartopo-batch-both.png

    You should see a black command window open.

    start_offline_sartopo.png

    You can minimize this window, but don't close it. 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.

    The first time you bring up the SARTopo Offline server, or after updating Java, you may get a Windows Firewall message.

    java_access.png

    Click "Private networks" and "Allow Access" to allow the SARTopo Offline webpage to talk to the SARTopo Offline server on private networks (to include on your own computer).

Stopping the SARTopo Offline server

When you are finished using SARTopo Offline:

  1. Close the SARTopo Offline tab in your browser
  2. Click on the black command window that opened when you started the SARTopo Offline server and click the "X" to close it.

stop_offline_sartopo.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 goes to the Server Address displayed in the black command window (eg. http://mycomputer:8080) for the SARTopo Offline Server.

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.