Chapter 19. Installing and starting the employee rostering starter application on OpenShift

Procedure

1. Download the rhpam-7.10.0-maven-repository.zip file from the Software Downloads page of the Red Hat Customer Portal.
2. Expand the downloaded archive.
3. Copy the contents of the jboss-rhba-7.10.0.GA-maven-repository/maven-repository subdirectory into the ~/.m2/repository directory.
4. Download the rhpam-7.10.0-reference-implementation.zip file from the Software Downloads page of the Red Hat Customer Portal.
5. Expand the downloaded archive.
6. Unzip the rhpam-7.10.0-optaweb-employee-rostering.zip file that is extracted from the reference implementation archive.
7. Using the command line, change to the optaweb-employee-rostering-distribution-7.48.0.Final-redhat-00004/sources folder.

8. To build the Employee Rostering application, run the following command:

   mvn clean install -DskipTests -DskipITs

   Copy to Clipboard Toggle word wrap

9. Log in to an OpenShift account or a Red Hat Code Ready Container instance. In the following example, <account-url> is the URL for an OpenShift account or Red Hat Code Ready Container instance and <login-token> is the login token for that account:

   oc login <account-url> --token <login-token>

   Copy to Clipboard Toggle word wrap

10. Create a new project to host Employee Rostering:

    oc new-project optaweb-employee-rostering

    Copy to Clipboard Toggle word wrap

11. Run the provision script to build and deploy the application:

    ./provision.sh

    Copy to Clipboard Toggle word wrap

    Compilation and packaging might take up to 10 minutes to complete. These processes continually show progress on the command line output.

    When the operation completes, the following message is displayed, where <URL> is the URL for the deployment:

    You can access the application at <URL> once the deployment is done.

    Copy to Clipboard Toggle word wrap

12. Enter the URL that you used earlier in the procedure, for either an OpenShift account or Red Hat Code Ready Container instance, to access the deployed application. The first startup can take up to a minute because additional building is completed on the OpenShift platform.

    Note

    If the application does not open a minute after clicking the link, perform a hard refresh of your browser page.