...
Note |
---|
|
These instructions describe installation of the Universal Agent for SOA 6.x for the Linux x86_64 Debian package. |
Universal Agent for SOA 6.x is packaged as a Debian file (extension .deb). It is installed using the Linux dpkg command.
...
Step 1 | Create a directory (or select an existing directory) in which to save the package file. |
---|
Step 2 | Save the package file into that directory. |
---|
Step 3 | Uncompress and extract the installation files in the current working directory. The command to extract the files is:
Panel |
---|
Html bobswift |
<pre>
zcat sb-soa-6.4.1.0-linux-3-x86_64-deb.tar.Z | tar xvf -
</pre>
|
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 |
---|
Step 4 | After the extraction is complete, run the installation script, upsinst, which executes the dpkg command:
Panel |
---|
Html bobswift |
<pre>
./upsinst
</pre>
|
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. |
---|
Step 5 | From the license file that was sent to you by Stonebranch, Inc., add the license information to the /etc/universal/uacs.conf file. |
---|
Step 6 | Recycle Universal Broker using the following commands (cd to /opt/universal/ubroker ): First:
Panel |
---|
Html bobswift |
<pre>
./ubrokerd stop
</pre>
|
Then:
Panel |
---|
Html bobswift |
<pre>
./ubrokerd start
</pre>
|
|
---|
Step 7 | 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:
Panel |
---|
Html bobswift |
---|
<pre>
Component ID..............: 1360109684
Component Name............: uac (Server)
Component Description.....: Universal Application Container Server
Component Version.........: 6.4.x Level 1 Release Build 101
Component Type............: uac
Component Process ID......: 23331000
Component Start Time......: 18:14:42
Component Start Date......: 02/05/13
Component Command ID......: uac
Component State...........: REGISTERED
Component MGR UID.........:
Component MGR Work ID.....:
Component MGR Host Name...:
Component MGR IP Address..:
Component MGR Port........:
Component Comm State......: ESTABLISHED
Component Comm State Time.: 18:14:44
Component Comm State Date.: 02/05/13
Component MGR Restartable.: NO
Component Comment.........:
</pre>
|
|
---|
Validating the WebSphere XD Environment
...
Step 1 | Application Security After installing the XD environment application, security must be enabled (if it is not on by default). - Select Security / Secure administration, applications, and infrastructure in the Integrated Solutions Console menu.
- Check the Enable application security checkbox in the Application Security group.
![](https://stonebranchdocs.atlassian.net/wiki/download/attachments/3770166/ApplicationSecurity.JPG?version=2&modificationDate=1651516848000&cacheVersion=1&api=v2)
|
---|
Step 2 | 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. - Select System administration / Job scheduler in the Integrated Solutions Console menu.
- Click Security role to user/group mapping in the Addition Properties group to display the Security role to user/group mapping page.
![](https://stonebranchdocs.atlassian.net/wiki/download/attachments/3770166/UserMappingLink.JPG?version=1&modificationDate=1651516848000&cacheVersion=1&api=v2) 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.
![](https://stonebranchdocs.atlassian.net/wiki/download/attachments/3770166/UserMappingPage.JPG?version=2&modificationDate=1651516848000&cacheVersion=1&api=v2)
|
---|
Step 3 | 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.
![](https://stonebranchdocs.atlassian.net/wiki/download/attachments/3770166/InstalledSampleApplications.JPG?version=2&modificationDate=1651516847000&cacheVersion=1&api=v2) |
---|
Step 4 | 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. - The
lrcmd.sh utility is located in /opt/IBM/WebSphere/AppServer/bin or where your local WebSphere installation path points to the bin directory. The command syntax for submitting a job using lrcmd.sh is: Panel | html-bobswift |
---|
<pre>
./lrcmd.sh -cmd=submit -
xJCL=/opt/IBM/WebSphere/AppServer/longRuning/postingSampleXJCL.xml -
host=localhost -port=9080 -userid=yourusername -password=yourpassword
</pre>
|
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:
Image Modified - 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:
![](https://stonebranchdocs.atlassian.net/wiki/download/attachments/3770166/statusresponse.JPG?version=1&modificationDate=1651516847000&cacheVersion=1&api=v2)
|
---|
...
Step 1 | 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:
Panel |
---|
Html bobswift |
<pre>
//UACXD1A JOB CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID
//*
//***********************************************************
//*PostingsSampleEar
//*UCMD is the proc that calls UC Manager
//*LOGON is the DD with userid and passwd (can use encrypted)
//*SCR is the script that contains the XD Connector information //* to connect to Websphere job scheduler
//*UNVIN provides the payload for the script in SCR
//***********************************************************
//*
// JCLLIB ORDER=SBI.UNV.SUNVSAMP
//*
//UCMD EXEC UCMDPRC
//LOGON DD DISP=SHR,DSN=SUPPORT.UAC.LOGON(YOURUSER)
//SCR DD DISP=SHR,DSN=SUPPORT.UAC.SCRIPTS(SCRXD1)
//UNVIN DD DISP=SHR,DSN=SUPPORT.UAC.SCRIPTS(PYLXD1)
//SYSIN DD *
-s scr -script_type service
-i yourserver -G yes -f logon
</pre>
|
|
---|
Step 2 | 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:
Panel |
---|
Html bobswift |
<pre>
# protocol is what protocol you are choosing(XDSOAP)
# mep is the type of message (Request)
# xdcmd is the xd command you want to perform (submit,restart)
# cmdid is a unique identifier to match to jobid(websphere jobid)
# serviceurl is the websphere url to the job scheduler
# serviceusername is the websphere user
# servicepassword is the websphere user password
# timeoutms is the timeout in milliseconds for the job
#************************************************
-protocol XDSOAP
-mep Request
-xdcmd SUBMIT
-cmdid 10010
-serviceurl http://sup\-wasxd:9080/LongRunningJobSchedulerWebSvcRouter/services/JobScheduler
-serviceusername admin
-servicepassword admin
-timeoutms 120000000
</pre>
|
|
---|
Step 3 | 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.) |
---|
...