Chapter 1. Installing and running the employee rostering demonstration on OpenShift

Procedure

1. Running the script

   1. Using the command line, change to the optashift-employee-rostering-7.7.0.Final-redhat-7/sources folder.

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

      ./provision.sh setup employee-rostering --binary

      Copy to Clipboard Toggle word wrap
      Note

      If the current OpenShift user name contains characters that are not letters or numbers, the deployment might fail. This can be fixed by providing an additional parameter: ./provision.sh setup employee-rostering --binary --project-suffix optashift. This example uses "optashift", but the actual value has no impact on the deployment.

2. Verify the compilation status

   1. Compilation and packaging may take several minutes to complete, and should continually show progress on the command line output.
   2. Once completed, the following message is displayed: Uploading file "target/ROOT.war" as binary input for the build …​.

3. Use the OpenShift web UI to view the details for the deployed application. Click the link in the Routes section to open the starter application.

   The build can take up to 30 seconds to complete. The application container can take an additional 30 seconds to start up completely.

   Note

   Perform a hard refresh of your browser page if the web app does not open after clicking the link.

   Figure 1.1. OpenShift web console with deployed Employee Rostering starter application

   

   View larger image

   

4. Optionally, you can use other actions provided by the provision script:

   1. Deploy updates to the code to an existing deployment: ./provision.sh deploy employee-rostering --binary
   2. Remove the application: ./provision.sh delete employee-rostering

Procedure

1. Log in to the OpenShift web console and click Import YAML/JSON in the upper right corner.
2. Select the project to add to from the Add to Project drop down menu, or select Create Project to create a new one. If creating a new project, enter a new project name, display name, and description.
3. Click the Browse button and navigate to the optashift-employee-rostering-template.yaml file. Starting from the optashift-employee-rostering-7.7.0.Final-redhat-7 folder, access the file by clicking sources > openshift > templates.

4. Click Create.

   Figure 1.2. Upload template window

   

   View larger image

   

5. In the Add Template dialog box, click Continue to accept the default settings.

   Figure 1.3. Add template window

   

   View larger image

   

6. In the Import YAML/JSON dialog box, click Create to accept the default settings.

   Figure 1.4. Configure template window

   

   View larger image

   
7. In the Success dialog box, click Close.

8. Wait for the build and deployment to complete. This might take several minutes. When the deployment completes, click the link in the upper right corner above the shaded bar to open the application.

   Figure 1.5. Completed deployment and resulting link

   

   View larger image

   
   Note

   Perform a hard refresh of your browser page if the web app does not open after clicking the link.