Obtaining Pivotal GemFire from a Maven Repository

You can use Maven to add Pivotal GemFire to your Java project build.

1. Access to the Pivotal Commercial Maven Repository requires a one-time registration step to obtain an account. The URL for both registration and subsequent logins after registration is https://commercial-repo.pivotal.io/. Click on the Create Account link to register. You will receive a confirmation email; follow the directions in this email to activate your account.

2. After account activation, log in at https://commercial-repo.pivotal.io/ to access the configuration information in the Pivotal GemFire Release Repository.

3. To add GemFire to your Java project, you need to modify your project’s pom.xml file. Add the following repository definition to your pom.xml file:

      <repository>
          <id>gemfire-release-repo</id>
          <name>Pivotal GemFire Release Repository</name>
          <url>https://commercial-repo.pivotal.io/data3/gemfire-release-repo/gemfire</url>
      </repository>
   

4. Add the following dependencies to your pom.xml file.

   <dependencies>
      <dependency>
         <groupId>com.vmware.gemfire</groupId>
         <artifactId>gemfire-core</artifactId>
         <version>9.15.0</version>
      </dependency>
      <dependency>
         <groupId>com.vmware.gemfire</groupId>
         <artifactId>gemfire-wan</artifactId>
         <version>9.15.0</version>
      </dependency>
      <dependency>
         <groupId>com.vmware.gemfire</groupId>
         <artifactId>gemfire-cq</artifactId>
         <version>9.15.0</version>
      </dependency>
   </dependencies>
   

5. To access these artifacts, you must add an entry to your .m2/settings.xml file:

      <settings>
          <servers>
              <server>
                  <id>gemfire-release-repo</id>
                  <username>[e-mail]</username>
                  <password>MY-PLAINTEXT-PASSWORD</password>
              </server>
          </servers>
      </settings>
   

where you provide the values for [e-mail] and MY-PLAINTEXT-PASSWORD. As of Maven version 2.1.0, encrypted passwords are supported in this settings.xml file. See https://maven.apache.org/guides/mini/guide-encryption.html for details on the encryption.