2. Installation

2.1. Overview

1

There are several ways to install the montarre tool. Regardless of the installation method, the included command-line tool will present the same interface. The documentation is written in terms of executing a command-line tool named montarre. Some installation methods, however, won't result in an executable named montarre being installed. For example, the shaded jar is, unsurprisingly, a jar file. When using this installation method, one should mentally substitute "java -jar com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar" whenever the documentation mentions the montarre command.

2.2. Shaded Jar

1

The shaded jar distribution is simply a so-called onejar consisting of all of the application bytecode packed into a single jar file.

2

Download the jar file signature from Maven Central.

2.2.3. Shaded Jar Signature Download

$ wget https://repo1.maven.org/maven2/com/io7m/montarre/com.io7m.montarre.cmdline/1.0.0-beta0001/com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar.asc

4

Download the jar file from Maven Central.

2.2.5. Shaded Jar Download

$ wget https://repo1.maven.org/maven2/com/io7m/montarre/com.io7m.montarre.cmdline/1.0.0-beta0001/com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar

6

Verify the signature:

2.2.7. Shaded Jar Signature Verification

$ gpg --verify com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar.asc

8

Run the jar using an appropriate Java runtime:

2.2.9. Shaded Jar Execution

$ java -jar com.io7m.montarre.cmdline-1.0.0-beta0001-main.jar
montarre: usage: montarre [command] [arguments ...]

  The montarre command-line application.

  Use the "help" command to examine specific commands:

    $ montarre help help.

  Command-line arguments can be placed one per line into a file, and
  the file can be referenced using the @ symbol:

    $ echo help > file.txt
    $ echo help >> file.txt
    $ montarre @file.txt

  Commands:
    help             Show usage information for a command.
    maven-central    Maven Central commands.
    native           Native package commands.
    package          Package commands.
    version          Show the application version.
    wix              WiX commands.

  Documentation:
    https://www.io7m.com/software/montarre/