Versions Compared

Key

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

Aspire 4.0 runs on Java SE 11.

Panel
titleOn this page

Anchor
#javaComps
#javaComps
Install the Java Components


Download and install Java

This is the version that is

Install Java JDK

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

  • Aspire 3 and up requires to run at Java 1.7 and above.
Tip
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 only the JRE (Java Runtime Environment) is absolutely required for running Aspire.
Download and install the latest version of the Java JDK

appropriate for the system that will run Aspire:http://java.com/en/download/manual.jsp

  1. If you have a 64-bit machine,
  2. we recommend installing
  3. install the 64-bit version of Java. That will 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 hash tables to improve performance, so it's best to have the 64

bit JVM (Java Virtual Machine),

-bit JVM  just in case you need it someday.

Test

that you can

your access to the "java" command from your console

.

  1. Open

    up

    a new DOS command-shell. (

    go

    Go to the

    start

    Start menu, and enter "cmd" where it says

    "

    Run

    "

    or

    "

    Search for Programs

    "

    , and then execute the cmd.exe program).

  2. At the prompt, enter the following

    , then

    and press

    the

    Enter

    key

    : java -version.

    Success is indicated when version information is returned.

    Image Removed
  3. Add the "JAVA_HOME" environment variable.
    1. This is needed by the Maven command-line tool described below.
      1. Open up your control panel
      2. Go to the "System" control panel (may be inside the 'System and Security' category)
      3. Open up the "Advanced System Settings"
      4. Go to the "Advanced" tab (may already be selected)
      5. Click on "Environment Variables"
      6. Click on "New..."
      7. Enter "JAVA_HOME" as the "Variable name:"
      8. Locate the directory within your Program files where java was installed. Enter this directory name as the "Variable value:"

 

Code Block
languagetext
themeFadeToGrey
> java -version
   java version "111.70.0_79"2" 2019-01-15 LTS
   Java(TM) SE Runtime Environment 18.9 (build 111.7.0_79-b150.2+9-LTS)
   Java HotSpot(TM) 64-Bit Server VM 18.9 (build 24.79-b0211.0.2+9-LTS, mixed mode)

Install Maven Command Line

Info

If you are running Aspire with the Quick-Start Distribution from the aspire binaries, you can skip this part, otherwise If you are using the Maven Archetype for downloading Aspire you must follow this section.

 

Installing the Maven command line is a very useful way to work with Maven and projects, especially for distributions, or when you're having trouble with m2eclipse (which happens now and then).

Image Removed

Add the "JAVA_HOME" environment variable

This is needed by the Maven command-line tool. In Windows:

  1. Open the control panel.
  2. Go to SystemAdvanced System Settings > Advanced > Environment Variables.

  3. Under System variables, click New.

  4. Enter "JAVA_HOME" as the Variable name.

    Download and install the latest version of Apache Maven: http://maven.apache.org/download.html
  5. Download the compressed binary files.
  6. Suggestion: Create a "C:\dev" directory and unpack the files there.
  7. "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.
    Add the M2_HOME and M2 environment variables in your System Properties and modify your Path variable:
  8. Please refer to Step 1 above for the instructions on accessing your Environment Variables via the Control Panel.
  9. Add the M2_HOME system variable:
  10. In the System Variables section, click on "New..."
  11. Enter the following in the "Variable name:" field: M2_HOME

  12. Locate the directory within your Program files where java was installed.

  13. Enter

    you unpacked Maven, enter

    this directory name as the

    "

    Variable value

    :" (for example, C:\dev\apache-maven-4.0.9), then click on the OK button.
  14. Add the M2 system variable:
    1. In the System Variables section, again click on "New..."
    2. Enter the following in the "Variable name:" field: M2Image Removed
    3. In the "Variable value:" field, enter the following, then click on the OK button:  %M2_HOME%\bin
  15. Modify your Path variable:
    1. Scroll through the System Variables to locate the Path variable, select it, then click on the Edit button.
    2. Click in the "Variable Value" field to activate it, then press your End key to move your cursor to the end of the value.
    3.  

      Without typing any spaces, enter the the "bin" directory from Apache Maven to your environment path (for example, ;C:\dev\apache-maven-4.0.9\bin), then click on the OK button.

  16. Click on the OK button to close the Environment Variables window, then click on the OK button to close the System Properties window.
  17. Test that you can access Maven.
    1. Open up a new DOS command-shell (go to the Start menu, enter "cmd" in the "Run" or "Search for Programs" field, and then execute the cmd.exe program).
    2. At the prompt, enter the following, then press the Enter key: mvn -version

    3. Success is indicated when version information is returned, as shown in the image to the right.

      Code Block
      languagetext
      themeFadeToGrey
      > mvn -version
        Apache Maven 4.0.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-10T10:41:47-06:00)
        Maven home: C:\dev\apache-maven-4.0.9\bin\..
        Java version: 1.7.0_79
        Java home: C:\dev\jdk1.7.0_79\jre
        Default locale: en_US, platform encoding: Cp1252
        OS name: "windows 10", version: "10.0", arch: "amd64", family: "dos"
  18. Configure your .m2/settings.xml file to point to the Search Technologies repository. See Connect to Search Technologies Maven Repository
 
  1. .

For Linux systems:

  1. In Linux, open a terminal.
  2. Type "echo $JAVA_HOME" and press Enter. If nothing is displayed, we can set it at startup by doing step 3.
  3. Type "echo JAVA_HOME=/your/java/directory >> ~/.profile"
  4. Logout and login again, repeating steps 1 and 2 to check if JAVA_HOME was successfully set.