All platforms require a Java installation, with JDK 1.8 or more recent version.
Set the JAVA_HOME environment variable. For example:
Platform | Command |
---|---|
Unix | export JAVA_HOME=/usr/java/jdk1.8.0_121 |
OSX | export JAVA_HOME=`/usr/libexec/java_home -v 1.8` |
Windows | set JAVA_HOME="C:\Program Files\Java\jdk1.8.0_121" |
Download the project source from the Releases page at Apache Geode, and unpack the source code.
Within the directory containing the unpacked source code, run the gradle build:
$ ./gradlew build
Once the build completes, the project files will be installed at geode-assembly/build/install/apache-geode
. The distribution archives will be created in geode-assembly/build/distributions/
.
Verify the installation by invoking the gfsh
shell command to print version information:
$ ./geode-assembly/build/install/apache-geode/bin/gfsh version v1.1.0
Note: on Windows invoke the gfsh.bat
script to print the version string.
The following steps have been tested with:
Run ./gradlew --parallel generate
from Geode repository root to create compiler generated source.
Alternatively (and to ensure these sources stay up-to-date):
Import project into IntelliJ IDEA.
From the Welcome to IntelliJ IDEA window:
Change Code Style Scheme to GeodeStyle.
Navigate to IntelliJ IDEA -> Preferences... -> Editor -> Code Style. Select GeodeStyle in Scheme drop-down box if it already exists.
To define the GeodeStyle in Scheme, select the gear icon next to the drop-down box, click Import Scheme -> and select IntelliJ IDEA code style XML. Select etc/intellij-java-modified-google-style.xml from Geode repository root, enter To: GeodeStyle, check Current scheme and press OK.
Make Apache the default Copyright.
Navigate to IntelliJ IDEA -> Preferences... -> Editor -> Copyright. Select Apache in drop-down box Default project copyright.
To define Apache in Copyright, navigate to IntelliJ IDEA -> Preferences... -> Editor -> Copyright -> Copyright Profiles. Click + to add a new project. Enter Apache as the Name and enter the following block without asterisks or leading spaces:
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
...then return to Copyright and select Apache in drop-down box Default project copyright.
Navigate to IntelliJ IDEA -> Preferences... -> Editor -> Copyright -> Formatting. Uncheck Add blank line after and press OK.
Rebuild the Project.
Navigate to Build -> Rebuild Project and the full project should compile without errors.
Some optional sanity tests to make sure things are working properly: