Working with Constellation source code requires both a development environment and a runtime environment. The development environment will require a Java Developers Kit (JDK) which provides the compiler, the Maven build tool, and a network connection to download all dependencies. The runtime environment will need either only a Java runtime environment for the standalone version, a Servlet container to run the server only, or an Application Container to run both the server and configuration interface.
Development Environment
Constellation development requires a Java Development Kit (JDK), version 6 or newer. Currently, everyone building Constellation is using the JDK provided by Sun Microsystems which can be downloaded here:
http://java.sun.com/javase/downloads/index.jsp
The download will provide both the Development Kit, with its compilers and other utilities, and a Runtime Environment which we can use in subsequent sections. Users of modern operating systems should be able to obtain the JDK from their software package management system.
The JRE must be extended with the JAI and JAI Image-IO extensions.
The build also requires the Maven 2 build tool.
Setup
The PATH environmental variable should be set to provide access to the javac compiler, to the java runtime command, and to the mvn command.
The MAVEN_OPTS environmental variable should be set to provide more memory for the javac compiler
The EPSG database must be setup, if this does not yet exist.
Oracle
Constellation can be run using an Oracle database as the backend. For now, we require all users to obtain the Oracle JDBC driver and install it themselves. Unfortunately, this piece of software is not free software and, while distributed with few restrictions, falls under the scope of the United States government which is inflexible on certain issues.
Constellation currently uses the Oracle JAR file ojdbc14.jar which can be downloaded from:
http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/htdocs/jdbc9201.html
Once that file is obtained, it should be loaded into the developer's own repository with the command:
Runtime Environment
Constellation requires a Java Runtime Environment (JRE), version 6 or newer. The JRE will be available in the JDK for users who have downloaded the software development kit. Otherwise, the runtime environment will need to be obtained. Currently, everyone using Constellation is using the JRE provided by Sun Microsystems which can be downloaded here:
http://java.sun.com/javase/downloads/index.jsp
For users who wish to deploy Constellation into a Servlet Engine or into an Application Server, that resource will have to be downloaded and configured.
Labels