Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

The recommended way of deploying Aspire 5 is by containers. See Quickstart Guide with Docker or Kubernetes Deployments for more information.

The current guide describes how to deploy Aspire 5 directly into a VM (Linux or Windows).

Prerequisites


Table of Contents
typeflat


Setup Aspire's Maven Repository

Follow the steps at Configuring Aspire Maven Repository using your registered credentials for maven to be able to download the Aspire artifacts.

Download and build Aspire Distribution - with Maven Archetype

The Aspire Distribution Maven Archetype allows for building aspire distributions consistently and easily.

Steps

  1. Create the distribution archetype project with maven

    Code Block
    languagebash
    themeRDark
    mvn archetype:generate -DarchetypeGroupId=com.accenture.aspire -DarchetypeArtifactId=aspire-distribution-archetype -DarchetypeVersion=5.0-SNAPSHOT -DrepositoryId=stPublic

    You will be prompted with the following parameters (sample configuration):

    Code Block
    themeRDark
    Define value for property 'groupId': com.accenture.aspire
    Define value for property 'artifactId': aspire5
    Define value for property 'version' 1.0-SNAPSHOT: : [use default just hit ENTER]
    [INFO] Using property: package = pom
    [INFO] Using property: aspire.bootloader = aspire-elasticsearch-bootloader
    [INFO] Using property: aspireAdminPort = 50505
    Confirm properties configuration:
    groupId: com.accenture.aspire
    artifactId: aspire5
    version: 1.0-SNAPSHOT
    package: pom
    aspire.bootloader: aspire-elasticsearch-bootloader
    aspireAdminPort: 50505
     Y: : y
  2. You will see a folder with the name entered in the 'artifactId' parameter, change your current directory into it

    Code Block
    languagebash
    themeRDark
    cd aspire5
  3. Build the distribution

    Code Block
    languagebash
    themeRDark
    mvn clean package

    This generates the distribution into the 'target' folder

  4. Copy your distribution to where you want it to be installed

    Code Block
    languagebash
    themeRDark
    cp -r target/aspire5 /your/installation/path
  5. If installing on Linux, give execution permissions to the bin/aspire.sh file:

    Code Block
    languagebash
    themeRDark
    cd /your/installation/path/aspire5
    chmod +x bin/aspire.sh