Stopping and starting Engineering Lifecycle Management application pods by using ELM Operation instance

When you update an existing Engineering Lifecycle Management instance configuration, you must stop and start the Engineering Lifecycle Management application pods to reflect the changes. Use the following procedure to stop or start the application pod by using the ELMOperation instance. It helps you to stop or start the application pods of selected Engineering Lifecycle Management applications or all applications in the Engineering Lifecycle Management instance. You can create the ELMOperation instance according to your requirement and run that on an existing Engineering Lifecycle Management instance.

Before you begin

• Verify that the Engineering Lifecycle Management instance exists in the project where you want to run the ELMOperation instance.
• Ensure that you log in with the appropriate user role, which has the privilege to create the ELM Operation instance. For more information about the roles used in the Red Hat® OpenShift®, see User roles mapping in Engineering Lifecycle Management on Hybrid Cloud.

About this task

• The ELMOperation instance supports the following scenarios that are related to stop or start the Engineering Lifecycle Management applications.

  Table 1. ELM applications stop or start scenarios supported in the ELMOperation instance

  Stop or start scenario	Description
  Start all applications.	All applications in the Engineering Lifecycle Management instance are started.
  Stop all applications.	All applications in the Engineering Lifecycle Management instance are stopped.
  Start selected applications.	Selected applications in the Engineering Lifecycle Management instance are started.
  Stop selected applications.	Selected applications in the Engineering Lifecycle Management instance are stopped.

• The following inputs are required to create the ELMOperation instance. Ensure that all the information is available to you.

  Table 2. Required inputs to create the ELMOperation instance

  Field name	Description
  Name	Provide the name of the ELMOperation instance.
  Operation type	Select the type of operation from the list. You can choose to start or stop the application pod.
  All ELM applications	Select this field if you want to run the operation for all applications in the Engineering Lifecycle Management instance.
  ELM applications	Select the Engineering Lifecycle Management applications in which you want to run the operation.

• You cannot create the ELMOperation instance when the upgrade or rollback process is in progress for the existing Engineering Lifecycle Management instance.
• When you create an ELMOperation instance to stop an Engineering Lifecycle Management application, it stops the application pod, and the terminal to access the application is not available.
• You cannot update an existing ELMOperation instance.
• You can delete the ELMOperation instance before it is run on the Engineering Lifecycle Management instance.

1. Log in to the Red Hat OpenShift Container Platform web console.
2. Clio, Operators > Installed Operators.
3. On the Installed Operators page, select the project where you installed the Engineering Lifecycle Management operator from the Project list.
4. Click IBM Engineering Lifecycle Management (ELM) from the Name column to open the Engineering Lifecycle Management operator.
5. On the Details tab, click Create instance link for ELMOperation. Alternatively, you can click Create ELMOperation on the ELMOperation tab.
6. Complete the ELMOperation instance creation by using one of the following approaches.
   • By using Form view
   1. On the 'Create ELMOperation' page, provide the input for the fields by using the information that you collected.
   2. Click Create to create the ELMOperation instance. You can see the ELMOperation instance that is listed on the ELMOperation tab.
   • By using YAML view
   1. Populate the ELMOperation instance details in the ELMOperation custom resource specification YAML.

      apiVersion: elm.ibm.com/v1
      kind: ELMOperation
      metadata:
        name: <elmoperation-instance-name>
        labels:
          app.kubernetes.io/instance: ibm-elm-operator
          app.kubernetes.io/managed-by: Go
          app.kubernetes.io/name: ibm-elm-operator
          release: 1.0.0
        namespace: <project-name>
      spec:
        allApplications: false
        operationType: Start
        selectedApplications:
          ldx: false
          lqe: false
          dcc: false
          jts: true
          rb: false
          ccm: false
          eni: false
          rm: false
          gc: false
          qm: false
          jas: true

   2. Click Create to create the ELMOperation instance. You can see the ELMOperation instance that is listed on the ELMOperation tab.
7. The ELMOperation instance is automatically run immediately after the creation on the existing Engineering Lifecycle Management instance in the project. When more than one ELMOperation instance is created, they are run in the same sequence as they are created. You can see the ELMOperation instance execution status in the Conditions table on the Details tab of the ELMOperation instance. The Engineering Lifecycle Management applications status is shown in the Applications Events table on the Details tab of the Engineering Lifecycle Management instance.