Note: If you're already running under Java 7, or you're running under Java 6 with no intention of moving to Java 7, then you can ignore this section.
To run Aspire under Java 7, you need to run Aspire in Apache Felix version 4.0.3 or later.
Felix> ps START LEVEL 1 ID State Level Name [ 0] [Active ] [ 0] System Bundle (4.3.0) [ 1] [Active ] [ 1] Apache Commons FileUpload Bundle (1.2.1) [ 2] [Active ] [ 1] Commons IO (2.4.0) [ 3] [Active ] [ 1] Apache Geronimo Bundles: json-20090211 (20090211.0.0.1) [ 4] [Active ] [ 1] Apache Felix Shell Service (1.4.3) [ 5] [Active ] [ 1] Apache Felix Configuration Admin Service (1.4.0) [ 6] [Active ] [ 1] Apache Felix Log Service (1.0.1) [ 7] [Active ] [ 1] Apache Felix Metatype Service (1.0.4) [ 8] [Active ] [ 1] Apache Felix Http Jetty (2.2.0) [ 9] [Active ] [ 1] Apache Felix Web Management Console (4.0.0) [ 11] [Active ] [ 1] Aspire Application (2.0.0.SNAPSHOT)
If your Aspire instance is configured to automatically load bundles from Maven via the network, follow the instructions below to update the version of Aspire you're running. If your server is not connected to the internet, instructions for updating can be found here.
If you're using an Aspire distribution project that was created using the distribution archetype version 1.2 or earlier and you want to change the version of Aspire it uses, you'll need to:
<repository type="maven"> <defaultVersion>AspireVersion</defaultVersion> <<<<<<<< Change this <remoteRepositories> <remoteRepository> <id>stPublic</id> <url>http://repository.searchtechnologies.com:8081/artifactory/simple/community-public/</url> <user>YOUR_MAVEN_USER</user> <password>YOUR_MAVEN_PASSWORD</password> </remoteRepository> </remoteRepositories> </repository>
felix.auto.start.1= \ file:bundles/system/org.apache.felix.shell.jar \ file:bundles/system/org.apache.felix.shell.tui.jar \ file:bundles/system/org.apache.felix.configadmin.jar \ file:bundles/system/org.apache.felix.log.jar \ file:bundles/system/org.apache.felix.metatype.jar \ file:bundles/system/org.apache.felix.http.jetty.jar \ file:bundles/system/org.apache.felix.webconsole.jar \ file:bundles/system/org.apache.felix.shell.remote.jar \ file:bundles/aspire/aspire-application-AspireVersion.jar <<<<<<<< Change this
<dependency> <groupId>com.searchtechnologies</groupId> <artifactId>aspire-application</artifactId> <version>AspireVersion</version> <<<<<<<< Change this <type>jar</type> </dependency>
mvn install
Warning: if you use the goal clean in the command above, any changes made to the distribution since the initial build will be lost
Note: in the above, AspireVersion refers to the version of Aspire you wish to use, and will be of the form #.#[.#][-SNAPSHOT]
e.g. 0.9-SNAPSHOT 0.9.1-SNAPSHOT 1.0 1.0.1
If your distribution was created from the distribution archetype version 1.3 or later, it will by default be using the Bootloader.
You can tell if it's using the Bootloader since when you start Aspire, you'll see a message (either to the console or felix.log file) similar to:
************************************************************************ * * ASPIRE BOOTLOADER * * Bundle id : 12 * * Location : file:bundles/boot/aspire-bootloader-1.3-SNAPSHOT.jar * Maven update policy: always
If this is the case, you only need to change the default version in your distribution's config/settings.xml file to the desired version:
<repository type="maven"> <defaultVersion>AspireVersion</defaultVersion> <<<<<<<< Change this <remoteRepositories> <remoteRepository> <id>stPublic</id> <url>http://repository.searchtechnologies.com:8081/artifactory/simple/community-public/</url> <user>YOUR_MAVEN_USER</user> <password>YOUR_MAVE_PASSWORD</password> </remoteRepository> </remoteRepositories> </repository>
Restarting Aspire will then download the configured version of Aspire.
If you're not using the bootloader, use the same process for versions before 1.3 (above).
In the case of a server that has no internet access, you will already have modified the pom file to add <dependency> tags for all of the bundles you're using.
To update the version of Aspire, update these to the desired version and follow the same process for the versions before 1.3 (above).
Important: You must remove the old versions of the bundles from the bundles/aspire directory either manually or by running a clean - but beware: using clean will remove any modifications you made to the configuration.