You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

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.
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.
  1. 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, we recommend installing the 64 bit version of Java. That will allow you to create large-memory instances of Aspire.
      1. The Aspire framework itself does not use up that much memory (100mb or so). But some applications may store big hash tables to improve performance, so it's best to have the 64 bit 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 up a new DOS command-shell (go to the 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 press the Enter key: java -version

    3. Success is indicated when version information is returned.

  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:"

 

> java -version
  java version "1.7.0_79"
  Java(TM) SE Runtime Environment (build 1.7.0_79-b15)
  Java HotSpot(TM) 64-Bit Server VM (build 24.79-b02, mixed mode)

Install Maven Command Line


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).

  1. Download and install the latest version of Apache Maven: http://maven.apache.org/download.html
    1. Download the compressed binary files.
    2. Suggestion: Create a "C:\dev" directory and unpack the files there.
    3. "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 M2_HOME and M2 environment variables in your System Properties and modify your Path variable:
    1. Please refer to Step 1 above for the instructions on accessing your Environment Variables via the Control Panel.
    2. Add the M2_HOME system variable:
      1. In the System Variables section, click on "New..."
      2. Enter the following in the "Variable name:" field: M2_HOME
      3. Locate the directory within your Program files where 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.
    3. Add the M2 system variable:
      1. In the System Variables section, again click on "New..."
      2. Enter the following in the "Variable name:" field: M2
      3. In the "Variable value:" field, enter the following, then click on the OK button:  %M2_HOME%\bin
    4. 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.

    5. Click on the OK button to close the Environment Variables window, then click on the OK button to close the System Properties window.

  3. 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.

      > 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"
  4. Configure your .m2/settings.xml file to point to the Search Technologies repository. See Connect to Search Technologies Maven Repository

 

 

 

  • No labels