Skip to main content

The most recent patch for this version is 7.0.1.  Learn more  

Version: 7.0

Installation

ASM is a Java web application that is installed via a Docker container package.

Installing the application​

Note: This assumes that Docker is already installed, and that the ASM distribution .zip file has been downloaded.

  1. Extract the ASM distribution .zip file to the folder from where you want to run ASM.
  2. Navigate to the docker/ folder of the extracted distribution.
  3. Open the file credentials.txt in a text editor.
  4. Update the placeholder values for Access key ID and Secret access key with the values provided by Axiomatics. (These are the same values that were use in setting up AWS CLI.)
  5. Save and close credentials.txt.
  6. Copy a valid ASM license file to the docker/ folder. (This file is provided separately by Axiomatics.)
  7. Run docker-compose up --build on the same folder. This starts the installation process.

Note: This step of the installation requires an Internet connection as some components will be downloaded from a secure Axiomatics repository during the process.

Stopping the application​

The application will run in the foreground, thus using CTRL+C will stop the Docker container and the application will shut down.

Restarting the application​

To restart the application, navigate to the docker/ folder inside of the distribution and run:

docker-compose up

Data persistence using volumes​

ASM implements volumes for externalizing the data state, that is, ensuring the persistence of data generated by and used by Docker containers.

No further configuration is necessary. If more information is needed, please refer to the section Use volumes of the Docker documentation for more information.

Note: Volumes do not create a folder on the host machine, but are managed by Docker commands. See the section Backup, restore, or migrate data volumes of the Docker documentation for more information about all the possible user actions like deletion, backups, restore, migration, etc.

Logging in to ASM​

After the installation has finished, open a web browser window and go to https://localhost/asm.

This will access the login page for ASM.

  • Default username: asm-admin

  • Default password: password

You will immediately be prompted to change the password, and when that is done you are logged in to ASM for the first time.

Next steps​

Adding users​

During the installation, a Keycloak service is also installed, to serve as an authentication module for the users of ASM.

Only a default administrative user is created automatically at this time. All other users must be created and assigned a role in Keycloak, before they can log in to ASM. (See Access Control for more information about roles).

To add more users, the system administrator must use Keycloak to create that user and map the user to a role. For more information, see Appendix: Managing users in Keycloak and Users.

Additional configuration​

Once the installation of ASM has been verified as successful, there are additional configurations you may want to consider for your implementation of ASM.