Before You Begin

This 30-minute tutorial shows you how to automate system administration tasks by using an administrative orchestration. You will learn how to use an administrative orchestration to automatically bring up the EnterpriseOne HTML and Enterprise Servers and update the EnterpriseOne HTML Server components without any dependency on the core EnterpriseOne servers.

Background

An administrative orchestration that contains only these components: Open API-type connectors connecting to a Server Manager Console Open API endpoint, rules, or child orchestrations with a similar structure as the parent orchestration. As a system administrator, you can use an administrative orchestration to automate system administration tasks, with only the Server Manager Console and AIS Servers running and without any dependency on other core EnterpriseOne servers such as the Enterprise, HTML, and Database Servers. For example, you can automatically bring up the EnterpriseOne servers and update the Tools releases or the EnterpriseOne server configuration by running administrative orchestrations even when the HTML, Database, and Enterprise Servers are down.

For this tutorial, the administrative orchestration, StartInstance-Orchestration, will be used to bring up the EnterpriseOne HTML and Enterprise Servers:

The administrative orchestration, ChangeComponent-Connector, will be used to update the EnterpriseOne HTML Server component:

What Do You Need?

• A minimum of EnterpriseOne Tools Release 9.2.6 deployed in a JD Edwards EnterpriseOne test environment with an EnterpriseOne Application Interface Services (AIS) Server.
• Orchestrator Studio 9.2.6 or later.

Before performing the tasks in this tutorial, you must ensure that:

• The EnterpriseOne HTML and Enterprise Servers are not running.
• The Server Manager Console and the AIS Server are running.
• The administrative orchestrations, designed to bring up the EnterpriseOne HTML Server and to update the Tools release, have been created and exported along with all its components. (You must export the orchestration components by selecting the All option in the Export Orchestration dialog box in the Orchestrator Studio.)

  The administrative orchestrations, StartInstance-Orchestration and ChangeComponent-Connector, have been created for the purpose of this tutorial.

  For information about how to create and export orchestrations, see "Creating Orchestrations" and "Exporting Orchestration Components from the Orchestrator Studio" in the JD Edwards EnterpriseOne Tools Orchestrator Guide.

• The Orchestrator Monitor is installed and the Orchestrator health and exception tracking is enabled in Server Manager. See "Setting Up Orchestrator Health and Exception Monitoring" in the JD Edwards EnterpriseOne Tools Orchestrator Guide.

Upload System Administrative Orchestrations

In this task, you will learn how to upload system administrative orchestrations to the Server Manager Console. For this tutorial, you will upload two system administrative orchestrations, one that is specifically designed to bring up the EnterpriseOne HTML and Enterprise Servers and the other to update the Tools release of the EnterpriseOne HTML Server.

1. Log in to Server Manager Console as the jde_admin user.
2. Click the Offline Orchestration link in the What do you want to do? section under the INSTALL sub-section.
3. Click Browse to search for and select the system administrative orchestration .zip file that contains the files for the orchestration that has been created to bring up the servers.
4. Click Upload.
5. Repeat Steps 3 and 4 to upload the system administrative orchestration for updating the EnterpriseOne HTML Server component version.

   The Server Manager Offline Orchestration page should look like this:

   

Run System Administrative Orchestration to Start HTML and Enterprise Servers

In this task, you will run the system administrative orchestration designed to start the EnterpriseOne HTML and Enterprise Servers that you uploaded to the Server Manager Console in the previous task.

1. Log in to Server Manager Console as the jde_admin user, if you are not already logged in, and verify that the EnterpriseOne HTML and Enterprise Servers are in the Stopped state.

   

   

2. Log in to the JD Edwards EnterpriseOne Orchestrator Studio as the jde_admin user.
3. On the Orchestrator Studio Home page, click the Run Orchestrations icon.
4. On the Run Orchestrations page, search for the StartInstance-Orchestration orchestration, and then select the orchestration. This orchestration will bring up the EnterpriseOne HTML server.
5. Enter the orchestration input values. In the Value field for the InstanceName input, for this tutorial, enter the HTML server instance name, for example, tqa_924_lnx_jas_den60202jems_31031.
6. Click Run.

   The Run Orchestrations page displays a green check mark to indicate that the orchestration completed successfully.

   The Run Orchestrations page should look like this:

   

7. Click the Run Orchestrations link and repeat Steps 4 through 6 to bring up the EnterpriseOne Enterprise Server. 
8. Log in to the Server Manager Console as the jde_admin user, if you are not already logged in, and verify that the EnterpriseOne HTML and Enterprise Servers are in the Running state:

   

   

Run System Administrative Orchestration to Update Tools Release Version of EnterpriseOne HTML Server

In this task, you will run the system administrative orchestration to update the EnterpriseOne HTML Server component to a later version. For this tutorial, the EnterpriseOne HTML Server component version will be updated from E1_HTMLServer_9.2.6.0_08-05-2021_01_31 to E1_HTMLServer_9.2.6.0_09-16-2021_02_07.

1. Log in to the Server Manager Console as the jde_admin user, if you are not already logged in, and check the version of the EnterpriseOne HTML Server component.

   

2. Log in to the JD Edwards EnterpriseOne Orchestrator Studio as the jde_admin user if you are not already logged in.
3. On the Orchestrator Studio Home page, click the Run Orchestrations icon.
4. On the Run Orchestrations page, search for the ChangeComponent-Connector orchestration, and then select the orchestration. This orchestration will update the Tools Release version of the EnterpriseOne HTML Server to a later version based on the input values.
5. Enter the orchestration input values. The following image shows an example of the orchestration input values:
   

   

6. Click Run.

   The Run Orchestrations page displays a green check mark to indicate that the orchestration completed successfully.

   The Run Orchestrations page should look like this:

   

7. Log in to the Server Manager Console as the jde_admin user if you are not already logged in and verify on the EnterpriseOne HTML Server window that the component change is successful:

   

8. Log out of the Orchestrator Studio.

View Health and Exception Details in Orchestrator Monitor

1. Log in to the JD Edwards EnterpriseOne Orchestrator Studio as an EnterpriseOne user.
2. On the Orchestrator Studio Home page, click the Orchestrator Monitor icon.
3. On the Orchestrator Monitor page, review the health and exception details of the orchestrations that you ran in the previous tasks. Notice that the user name in the User column is displayed as jde_admin or the system administrator who ran the orchestrations in the previous tasks.

Want to Learn More?

• JD Edwards EnterpriseOne Tools Server Manager Guide
• JD Edwards EnterpriseOne Tools Orchestrator Guide