Versions Compared

Old Version 5

changes.mady.by.user user-1b188

Saved on

compared with

New Version Current

changes.mady.by.user user-1b188

Saved on

Key

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

Aspire requires Java 1.6 and a machine with an internet connection. We also strongly recommend installing the Maven command-line client for additional, very useful functionality (see below).

 

On this page:

Table of Contents

Install Java JDK 1.6 or 1.7

The version of Java you should use depends on the Aspire version you are targeting to:

  • Aspire 2.1.2 and earlier runs on Java 1.6 or Java 1.7
  • Aspire 2.2 and up later requires to run at Java 1.7

Note: We recommend installing the Java JDK (Java Development Kit), just in case you want to create your own Aspire components/applications in the future. But However, only the JRE (Java Runtime Environment) is absolutely required.

 

1. Download and install the latest version of the Java 1.6 or 1.7 JDK as

aprropiate

appropriate: http://java.com/en/download/manual.jsp

  • If you have a 64 bit machine, we recommend installing the 64-bit version of Java. That will Thiswill allow you to create large-memory instances of Aspire.
  • The Aspire framework itself does not use up that much memory (100mb or so). But However, some applications may store big large hash tables to improve performance, so it's best to have the 64-bit
     JVM JVM (Java Virtual Machine), just in case you need it someday.

 

      2. Test that you can access the "java" command from your console.

    1. Open
    2. up
    1. a new DOS command-shell
    3. (go to the start
      1. Start menu,
    4. and
      1. enter
    5. "
      1. cmd
    6. " where it says "
      1. at Run
    7. "
      1. or
    8. "
      1. Search for Programs
    9. ", and then execute
      1. .
      2. Run the cmd.exe program
    10. )
      1. .
    2. Enter:  java -version

Java 1.6 can be used up to Aspire 2.1.2

Java 1.7 must be use as of Aspire  (2.2 Release) 

3. Add the "JAVA_HOME" environment variable.

This is needed by the Maven command-line tool described below.

    1. Open up
    2. your control panelGo
    1. the Control panel and go to the
    3. "
    1. System
    4. "
    1. control panel (may be inside the
    5. '
    1. System and Security
    6. '
    1. category).
    2. Open
    7. up
    1. the
    8. "
    1. Advanced System Settings
    9. "Go
    1. and go to the
    10. "
    1. Advanced
    11. "
    1. tab (may already be selected).
    2. Click on
    12. "
    1. Environment Variables
    13. "Click on "
    1. and New
    14. .
    1. .
    15. ."
    2. Enter
    16. "
    1. JAVA_HOME
    17. "
    1. as the
    18. "
    1. Variable name
    19. :"
    1. .
    2. Locate the directory
    20. within
    1. in your Program files where java was installed
    21. . Enter this
    1. and enter the directory name
    22. as
    1. in the
    23. "
    1. Variable value
    24. :"
    1. .

Java 1.6 can be used up to Aspire 2.1.2

Java 1.7 must be use as of Aspire  (2.2 Release) 

Install the Maven Command-Line Tool

Installing the Maven command-line tool is strongly recommended, but not required.

With Maven command-line, you will be able to automatically build a wider range of Aspire distribution projects, including:

  • Distributions that work without an internet connection
  • Separate distributions for development, staging, QA, and production environments
  • Distributions that are bundled as "App Bundles" and can be re-used inside of other Aspire server instances.

In addition, the Maven command-line tool will be useful for creating new Aspire components and deploying these components to Maven repositories for use in other Aspire installations.

If you do not wish to install Maven command-line, you may download a pre-packaged set of Aspire binaries .instead,

Detailed Instructions

 

1. Download and install Apache Maven: http://maven.apache.org/download.html

    1. Download and unpack the latest version
      1. Suggestion: Create a "C:\dev" directory and store it in there.
      2. "C:\dev" is a good place to store open source tools like Apache Maven, since (on rare occasions) they will not work with path names that have spaces in them.

2. Add the "bin" directory from Apache Maven to your environment path.

Windows Instructions:

    1. Open up your control Control panel.
    2. Go to the "System" control panel (may be inside the 'System and Security' category).
    3. Open up the "Advanced System Settings" settings.
    4. Go to the "Advanced" tab (may already be selected) .Click on "and select Environment Variables".
      1. Add the bin directory on to the end of the PATH variable in the
      "
      1. System Variables
      "
      1. section.
      1. Note that it needs to be preceded by a semi-colon.
      2. For example
    :
      1. ,  ;C:\dev\apache-maven-3.0.4\bin

    3. Test that you can access mavenMaven.

    1. Open
    2. up
    1. a new command-shell (in Windows, go to
    3. the start menu
    1. Start, and enter
    4. "
    1. cmd
    5. "
    1. where it says
    6. "
    1. Run
    7. "
    1. or
    8. "
    1. Search for Programs
    9. "
    1. , and then execute the cmd.exe program).
    2. Enter: mvn -version

You should see roughly the same response as shown in the image to the right.

-->

 →

 

SettingPath.png

MavenVersion.png