Skip to content

Latest commit

 

History

History
133 lines (122 loc) · 5.01 KB

install-server.md

File metadata and controls

133 lines (122 loc) · 5.01 KB

install-server

Installs Liberty runtime and optionally upgrades the runtime installation to a supported production edition.

To upgrade the runtime installation, the Liberty license jar file which is available to download from IBM Fix Central or the Passport Advantage website, must be installed to Maven local repository or an internal custom repository using the maven-install-plugin version 2.5 and up. See Installing an artifact with a custom POM

This goal only supports the common parameters, and is implicitly invoked by create, dump, java-dump, package, run, start, test-start and debug goals.

Examples:

  1. Install from a packaged server using runtimeArchive parameter.
  <plugin>
      <groupId>io.openliberty.tools</groupId>
      <artifactId>liberty-maven-plugin</artifactId>
      <executions>
          ...
          <execution>
              <id>install-server</id>
              <phase>pre-integration-test</phase>
              <goals>
                  <goal>install-server</goal>
              </goals>
              <configuration>
                  <runtimeArchive>/opt/ibm/wlp.zip</runtimeArchive>
              </configuration>
          </execution>
          ...
      </executions>
  </plugin>
  1. Install from a Maven artifact using runtimeArtifact parameter, and upgrade to production supported Core edition using the licenseArtifact parameter. See Using Maven artifact for more information.
  <plugin>
      <groupId>io.openliberty.tools</groupId>
      <artifactId>liberty-maven-plugin</artifactId>
      <executions>
          ...
          <execution>
              <id>install-server</id>
              <phase>pre-integration-test</phase>
              <goals>
                  <goal>install-server</goal>
              </goals>
              <configuration>
                  <runtimeArtifact>
                      <groupId>com.ibm.websphere.appserver.runtime</groupId>
                      <artifactId>wlp-webProfile7</artifactId>
                      <version>17.0.0.1</version>
                      <type>zip</type>
                  </runtimeArtifact>
                  <licenseArtifact>
                      <groupId>com.ibm.websphere.appserver.license</groupId>
                      <artifactId>wlp-core-license</artifactId>
                      <version>17.0.0.1</version>
                  </licenseArtifact>
              </configuration>
          </execution>
          ...
      </executions>
  </plugin>
  1. Install from a given location using install parameter. See Using a repository for more information.
  <plugin>
      <groupId>io.openliberty.tools</groupId>
      <artifactId>liberty-maven-plugin</artifactId>
      <executions>
          ...
          <execution>
              <id>install-server</id>
              <phase>pre-integration-test</phase>
              <goals>
                  <goal>install-server</goal>
              </goals>
              <configuration>
                  <install>
                      <runtimeUrl><url to .jar or .zip file></runtimeUrl>
                      <licenseCode><license code></licenseCode>
                  </install>
              </configuration>
          </execution>
          ...
      </executions>
  </plugin>
  1. This goal is implicitly invoked by create, dump, java-dump, package, run, start, test-start and debug goals.
  <plugin>
      <groupId>io.openliberty.tools</groupId>
      <artifactId>liberty-maven-plugin</artifactId>
      <configuration>
          <runtimeArtifact>
              <groupId>com.ibm.websphere.appserver.runtime</groupId>
              <artifactId>wlp-webProfile7</artifactId>
              <version>17.0.0.1</version>
              <type>zip</type>
          </runtimeArtifact>
          <licenseArtifact>
              <groupId>com.ibm.websphere.appserver.license</groupId>
               <artifactId>wlp-core-license</artifactId>
              <version>17.0.0.1</version>
          </licenseArtifact>
      </configuration>
      <executions>
          <execution>
              <id>start-server</id>
              <phase>pre-integration-test</phase>
              <goals>
                  <goal>start</goal>
              </goals>
              <configuration>
                  <serverName>test</serverName>
              </configuration>
          </execution>
          ...
      </executions>
  </plugin>
  1. Install the Websphere Application Server Liberty Core production license jar file.
  mvn org.apache.maven.plugins:maven-install-plugin:2.5.2:install-file -Dfile=wlp-core-license.jar