Installing the Check Crystal Reports sample reports

Use the following information to install the sample reports:

Ensure that the database installation was done.
Get the report files for the sample Crystal reports. The files that you need are provided in the FTM artifacts pod and must be downloaded from the pod. For more information about getting files from the artifacts container for your offering, see Getting the files from the artifacts container for your FTM offering. For more information, see Getting the files from the artifacts container for your FTM offering.
Install and configure the reports on the Crystal Reports server to meet your business requirements. For more information about installing and configuring the reports, see the Crystal Reports documentation. For more information about the supported version of Crystal Reports, see FTM Hardware and Software requirements.
Configure the external host information for the Crystal Reports server in Red Hat® OpenShift® so that the Services Framework Crystal reporting task can run. You need to use the value for the hostname on the task configuration page.
If you want to run the Crystal reports as a Services Framework task, you need to provide Red Hat OpenShift with user credentials for your Crystal Reports server. If you have more than one server, you need to provide the credentials for each one that your Services Framework report tasks need to access. For more information, see Configure Red Hat OpenShift with your report user credentials.

Configure the external host for the Crystal Reports server in Red Hat OpenShift

You need to configure the external host information for your Crystal Reports server in your Red Hat OpenShift cluster so that the server can be accessed from the cluster. You can use the Red Hat OpenShift Container Platform or the Red Hat OpenShift Container Platform command-line interface to access your Red Hat OpenShift cluster.

Go to the workload deployments. Find and open the Services Framework deployment.
Use the YAML tab to add the following statements after the hostname:YourHostName statement in the YAML for the deployment.
```
hostAliases:
  - ip:IP address of your Crystal Reports server
  hostnames:
    - crystalreports1
```
Save the YAML and then reload it.
Go to the pods for the workload. Restart the Services Framework pod, <ftm-instance>-services-engine.
After the new Services Framework pod is running, you can verify that the host alias was added. Go to the terminal and look for the crystalreports1 entry in the /etc/hosts file.

The hostname that you just defined must be specified in the field for the name of the Central Management Server in the task configuration.

Configure Red Hat OpenShift with your report user credentials

Before you configure the reporting task, the user authentication credentials to use to access your Crystal Reports server for the report must be added to Red Hat OpenShift. These credential values are provided in the following parameters that must be added as key and value pairs to the ftm-serviceengine-tasks-secret secret in Red Hat OpenShift.

Username used to log on to the Crystal Reports server. This user must have the rights to set report parameters and schedule report instances.
User password used to log on to the Crystal Reports server.

If these values were already added to the secret, you do not need to add them again.

To add parameters to the Red Hat OpenShift secret, do the following steps:

Determine what names you want to use for the keys for the report parameters. You can use any word with alphanumeric characters for a key. For example, you might use the following key and value pairs for the report parameters.
```
crystalusername=admin
crystaluserpass=pass
```
If you have more than one report server that you are using to run the Services Framework report tasks, you need a unique set of user credential keys for each server. For example, you can add an identifier as part the key names, such as crystalusernameserv1 and crystalusernameserv2.
Use the Red Hat OpenShift Container Platform to open the ftm-serviceengine-tasks-secret secret.
Edit the secret to add your key and value pairs in the Value field for the key secret.properties. The format for the key and value pairs is key=value.
The key names that you added to the secret must be specified in the configuration for report tasks that use the Crystal Reports server.