5 Deployment Env Info File Editor

The Oracle Retail Integration Bus (RIB) Deployment Configuration File Editor is an application for configuring the rib-deployment-env-info.xml file. The editor simplifies the alteration of the XML file by hiding the raw text form of XML. It provides an interface for adding, removing, and rearranging XML elements. It also provides an interface for editing the contents of elements.

Installation

The tool is located in the RDMT package and installed with RDMT in the <rib-home>/tools-home/RDMT directory. It is available as a menu selection from the ribadmin sub menu.

Note: The editor is a GUI application. To execute it on a host other than the one on which RDMT is installed, use an X server, such as Exceed, and set the DISPLAY environment variable.

Important Installation Warning

All rib-app-builder tools use the rib-deployment-env-info.xml as the single source of truth about the deployment configuration.

All tools use the values in this file. Editing the file directly affects the compilation, configuration, and deployment of the rib-apps. Use extreme caution and understand the ramifications of the values being manipulated.

Note: Fore more information, see the Oracle Retail Integration Bus Implementation Guide.

Before editing the source file in rib-home, make a backup of the file and place it securely outside of rib-home. Do not create a backup in the rib-home.

Key Rule

The rib-app-builder tools scan and check versions of all files within rib-home (except for tools-home). The processes do not allow files to have the same name with only an additional extension.

Operation

This section describes the steps you should take to edit the rib-deployment-env-info.xml.

Editing a File

1. From the menu bar, select File.

2. Click Open.

3. Navigate to the directory containing rib-deployment-env-info.xml.

4. Select the rib-deployment-env-info.xml file to open it.

Adding an Application

Take the following step to add an application:

1. Right-click the WLS instance to which you want to add the application. Select Add. Alternatively, select the WLS instance to which you want to add the application and click Add in the Document window.

Moving an Application

Take the following step to move an application:

1. Right-click the WLS instance that you want to move. Select Move. Alternatively, select the WLS instance you want to move and click Move in the Document window.

Deleting an Application

Take the following step to delete an application:

1. Right-click the application you want to delete. Select Delete. Click Yes to confirm. Alternatively, select the application you want to delete and click Delete in the Document window. Click Yes to confirm.

Adding a WLS Instance

Take the following step to add a WLS instance:

1. Right-click the WLS domain to which you want to add a WLS instance. Select Add. Alternatively, select the WLS domain to which you want to add a WLS instance and click Add in the Document window.

Deleting a WLS Instance

Take the following step to delete a WLS instance:

1. Right-click the WLS instance you want to delete. Select Delete and click Yes to confirm. Alterbatively, select the WLS instance you want to delete and click Delete in the Document window. Click on Yes to confirm.

   
   

Adding an Application Server Instance

Take the following step to add an application server instance:

1. Right-click on the Application Servers node. Select Add. Alternatively, select the application servers node and click Add in the Document window.

Adding a JMS Server Instance

Take the following step to add a JMS server instance:

1. Right-click in the JMS Servers Configuration Panel. Select Add. Alternatively, click the Add button in the Document window.

Copying a JMS Server Instance

Take the following step to copy a JMS server instance:

1. Right-click in the JMS Servers Configuration Panel. Select Copy. Alternatively, click Copy in the Document window.

Viewing the XML Source File

The source file containing the raw text of the XML document also can be viewed and edited from the Source tab. The following is an illustration of the source file editor interface: