Create a directory (or select an existing directory) in which to save the package file.

Save the package file into that directory.

Uncompress and extract the installation files in the current working directory. The command to extract the files is:
 

 
If your operating system does not support the zcat command, use the following command:
gunzip sb-soa-6.4.1.0-linux-3-x86_64-deb.tar.Z
 
The output of the gunzip command provides the following tar file:
tar -xvf sb-soa-6.4.1.0-linux-3-x86_64-deb.tar

After the extraction is complete, run the installation script, upsinst, which executes the dpkg command:
 

 
An installation log is written to file install.log in the current directory. upsinst automatically restarts the Universal Broker daemon, ubrokerd, at the end of the install.

From the license file that was sent to you by Stonebranch, Inc., add the license information to the /etc/universal/uacs.conf file.

Recycle Universal Broker using the following commands (cd to /opt/universal/ubroker):
 
First:
 

 
Then:
 

Use Universal Query (cd to /opt/universal/bin) to validate that the Universal Application Container Server component of Universal Command Agent for SOA 6.4.x is running:
 
uquery -host localhost (or the name of your server)
 
The output should have the following format:
 

Application Security
After installing the XD environment application, security must be enabled (if it is not on by default).

1. Select Security / Secure administration, applications, and infrastructure in the Integrated Solutions Console menu.
2. Check the Enable application security checkbox in the Application Security group.
    
   

Map Users to Job Scheduler
 
Users that have been set up in WebSphere must be mapped to a user in the job scheduler before they can run operations in the job scheduler.

1. Select System administration / Job scheduler in the Integrated Solutions Console menu.
2. Click Security role to user/group mapping in the Addition Properties group to display the Security role to user/group mapping page.
    
   
    
   Assign WebSphere users to lrsubmitter or lradmin (or other job scheduler users if you have created them). Make sure the All authenticated? checkbox is checked.
    
   The following screen illustrates the results of mapping the WebSphere user admin to the lrsubmitter job scheduler user.
    
   

Install the Job Scheduler Sample Applications
 
You must install the SimpleCIEar and PostingsSampleEar applications if you want to validate the WebSphere XD installation and the Universal Command Agent for SOA: XD Connector operation.
 
Go to Applications / Install New Applications in the Integrated Solutions Console menu. Keep in mind that the PostingsSampleEar application requires the database to be set up before you install the application.
 
The following screen illustrates the two applications after they are installed.
 

Run Sample Applications using lrcmd.sh Utility
 
Now that you have successfully installed the sample applications, you can test that your WebSphere XD environment is set up correctly by running the applications using the lrcmd.sh utility.

1. The lrcmd.sh utility is located in /opt/IBM/WebSphere/AppServer/bin or where your local WebSphere installation path points to the bin directory.
2. The command syntax for submitting a job using lrcmd.sh is:
    
    

   Note

   For the SimpleCIEar application, the xJCL is named SimpleCIxJCL.xml and host can be the name of any server on which WebSphere is installed.

   The response to the submit command is:
    
   
    
3. When you have submitted the job, you can check its status by using the Job Management Console at https://yourservername:9443/jmc/console.jsp and running the status command.
    
   The syntax for using the status command is:
   ./lrcmd.sh -cmd=status -jobid=PostingsSampleEar:1 -host=localhost -port=9080 -userid=yourusername -password=yourpassword
    
   The response to the status command is shown below:
    
   

Create the UMCD Manager JCL.
 
This provides the UCMD Manager options, references to the XD Connector options, and the xJCL payload.
 
It has the following format:
 

Create the XD Connector Command Options Data Set Member.
 
This member contains the command options for the XD Connector that specify the required information to submit a job to the WebSphere XD environment.
 
It is referenced with the SCR ddname and has the following format:
 

Create the xJCL Payload Data Set Member.
 
This member contains the xJCL that WebSphere XD will use to run the job specified in the xJCL and is read via STDIN.
 
The xJCL length depends on the job it describes. Verify that your data set member record length can accommodate the maximum line length in your xJCL.
 
The xJCL is an XML document. It is referenced using the UNVIN ddname, and can be referenced in your WebSphere XD install by going to:
/opt/IBM/WebSphere/AppServer/longRunning/postingSampleXJCL.xml
 
(Your path may be different, depending on how you configured your WebSphere XD install.)