How to Install ADSM - NAVADMC/ADSM GitHub Wiki

Installing ADSM As An End User

ADSM can be installed on either x86-64 Windows or x86-64 Debian based Linux Systems (Ubuntu preferred).
There is a Beta and Release channel available for installation.

Windows Release Channel

You can find the latest Release here: https://github.com/NAVADMC/ADSM/releases/latest

  1. On the latest release page, download the "ADSM_Installer.exe".
  2. Run the installer with admin privileges (ask your IT department for help if needed).
  3. Follow the on screen prompts until "Choose Install Location".
  4. Choose the folder in which to install ADSM. This is where the program will reside. It is generally best to put it in "Program Files".
  5. Next, choose the User Workspace Folder for ADSM. If you are the only user of the computer, you can choose where to store your Workspace Folder (folder of your scenarios). Note that you must have Read/Write access to the chosen folder.
    If ADSM is being installed on a shared computer and multiple users will use the program, leave this field BLANK so ADSM will find a suitable Workspace Folder that is writable and unique to each user.
  6. Continue following the on screen prompts.
  7. When installation is complete, find "ADSM.exe" (either a shortcut on your desktop or in the folder you installed ADSM) and run it.
  8. After launching the application, a black Terminal window with white text will appear. You can leave this window alone; some debug messages may appear in it.
  9. A Viewer window will then appear on top of the Terminal window. This is where you will interface with the ADSM program.
  10. To properly exit ADSM, close the Viewer window. Doing so will automatically close the Terminal window after saving and shutting down all processes.

Debian Linux Release Channel

You can find the latest Release here: https://github.com/NAVADMC/ADSM/releases/latest

An installation process does not yet exist for Linux, so it is best for each user on a machine to download their own local copy of the program.

  1. On the latest release page, download the "ADSM.tar.gz".
  2. Extract the package into the folder in which you want ADSM to be installed. It is best to do this somewhere in your User space.
  3. Run the "ADSM" executable in the extracted folder.
  4. After launching the application, a Terminal will appear. You can leave this Terminal alone; some debug messages may appear in it.
  5. A Viewer window will then appear on top of the Terminal window. This is where you will interface with the ADSM program.
  6. To properly exit ADSM, close the Viewer window. Doing so will automatically close the Terminal after saving and shutting down all processes.

Windows And Linux Beta Channel

You can find the latest Pre-release on the Releases page: https://github.com/NAVADMC/ADSM/releases

Beta builds do not come with an installer, so it is best for each user on a machine to download their own local copy of the program.

WARNING: If you have a Release installation on your computer, the Beta install MAY overwrite your scenarios from the Release version if you didn't specify a custom Workspace directory during Release install.
If ADSM is selecting the Workspace directory automatically both the Release and Beta channel will select the same folder.

  1. On the latest pre-release page, download either "ADSM_vx.x.x.x-beta_windows.zip" or "ADSM_vx.x.x.x-beta_linux.tar.gz"
  2. Extract the package into the folder in which you want ADSM Beta to be installed. It is best to do this somewhere in your User space (a directory your user owns).
  3. If you need to specify a different Workspace Folder to avoid a conflict with a Production Release, follow these steps.
    1. In your ADSM Beta folder, create a file called "settings.ini".
    2. Using your favorite text editor, add one of the following lines:
      1. Windows: WORKSPACE_PATH = 'DRIVE:\\desired\\path\\to\ADSM Beta Workspace'
      2. Linux: WORKSPACE_PATH = '/desired/path/to/ADSM Beta Workspace'
  4. Run the "ADSM_Beta.exe" or "ADSM_Beta" executable in the extracted folder.
  5. After launching the application, a Terminal will appear. You can leave this Terminal alone; runtime and debug messages will appear in it.
  6. A Viewer window will then appear on top of the Terminal window. This is where you will interface with the ADSM Beta program.
  7. To properly exit ADSM Beta, close the Viewer window. Doing so will automatically close the Terminal after saving and shutting down all processes.