Prerequisites

To get started, you will need:

1. Java - see Install Java JDK
2. A computer with a connection to the internet
   • Note: See Setting Aspire with No Internet Access (Offline) if this is not the case.

We also strongly recommend:

• Maven command-line - see Install Maven Command Line

Downloads

There are two ways you can download Aspire:

1. Downloading a pre-built distribution.
2. Using the Aspire Maven Distribution Archetype

Method 1: Basic Method Download with Pre-Built Binaries

A pre-built distribution of Aspire can be downloaded from https://wiki.searchtechnologies.com/binaries/

This distribution contains pre-built binaries for a functioning Aspire installation which works for both Windows and Linux.

Once you have downloaded Aspire, do the following:

1. Extract the contents of the zip or tar file into a directory
2. Edit and save the setting.xml file in the /Conf directory to change the default settings for username and password

   1. <remoteRepositories>
      	<remoteRepository>
      		<id>stPublic</id>
      		<url>http://repository.searchtechnologies.com/artifactory/simple/community-public/</url>
      		<user>YOUR ASPIRE ACCOUNT USERNAME</user>
      		<password>YOUR PASSWORD</password>d>
      	</remoteRepository>
      </remoteRepositories>

3. Open a command prompt and set your current directory to the directory where you put the Aspire Software
4. Launch Aspire
5. Windows: bin\aspire.bat      Linux: bin\aspire.sh
6. Go to http://localhost:50505 in a web browser to get started

See Launch Control for more details.

Method 2: Advanced Method with Maven and the Aspire Distribution Archetype

We understand that it requires a little more effort (it requires the Maven command-line tool, and there are a couple of extra steps), however it has added flexibility including:

• The ability to build distributions for computers without an internet connection
• The ability to build multiple distributions for multiple environments (e.g. development, staging, QA, and production environments)
• The ability to bundle your applications

For complete instructions, see Quick Start with Distribution Archetype.

Upgrade to a Later Version

If you've chosen to upgrade to a later version, the instructions for changing your distribution to use it are here.

Method 2: Advanced Method with Maven and the Aspire Distribution Archetype

We understand that it requires a little more effort (it requires the Maven command-line tool, and there are a couple of extra steps), however it has added flexibility including:

• The ability to build distributions for computers without an internet connection
• The ability to build multiple distributions for multiple environments (e.g. development, staging, QA, and production environments)
• The ability to bundle your applications

For complete instructions, see Quick Start with Distribution Archetype.

Upgrading to a later version

If you've chosen to upgrade to a later version, the instructions for changing your distribution to use it are here.