The z/OS® Connect feature runs in a WebSphere® Application Server for z/OS, Liberty environment and is installed from the Liberty
Repository.
Before you begin
Use IBM®
Installation Manager to install Liberty for WebSphere
Application Server Version 8.5.5.2, along with the following interim fixes:
- 8.5.5.2-WS-WLP-OS390-IFPI18279
- 8.5.5.2-WS-WLP-OS390-IFPI18379
Download the interim fixes from IBM Fix Central, or install the interim fixes
directly from the service repository.
Use IBM Installation Manager to install Liberty for WebSphere
Application Server version 8.5.5.3 or later.
Use the featureManager command for Liberty to install the z/OS Connect feature from the Liberty Repository. This command requires that
the file system for Liberty have read/write access. You can either enable the Liberty file system as
read/write, or copy the contents into a read/write file system so new features can be added from the
Liberty Repository.
About this task
You can use the featureManager command for Liberty to install the z/OS Connect feature from the Liberty Repository. This command
requires that the file system for Liberty have read/write access. You can either enable the Liberty
file system as read/write, or copy the contents into a read/write file system so new features can be
added from the Liberty Repository.
Procedure
- Change to the bin subdirectory under the directory where Liberty is
installed. The directory must be enabled for read/write access.
cd ${wlp.install.dir}/bin
- Use the featureManager command to install
the z/OS Connect feature:
featureManager install zosConnect-1.0
The
feature is downloaded from the online Liberty Repository and installed.
You must have Internet access to retrieve the feature from the Liberty
Repository.
- If you are installing this feature on to Liberty version 8.5.5.2, set the required file
permissions by issuing the following commands from the WebSphere Liberty installation
directory: chmod ugo+rx bin/zosConnect/bbgls2js and chmod ugo+rx
bin/zosConnect/bbgjs2ls
- You are now ready to add the z/OS Connect feature to the
feature manager list in the server.xml file of the Liberty server where you
want to enable this support.
<server description="z/OS Connect Liberty Server">
<featureManager>
<feature> zosConnect-1.0</feature>
</featureManager>
</server>
- (Optional)
- If you are using WebSphere optimized
local adapters (WOLA), use the featureManager command
to install the Optimized Local Adapters feature:
featureManager install zosLocalAdapters-1.0
For
more information, see Installing Liberty Repository assets.
The
feature is downloaded from the Liberty Repository and installed. You
must have Internet access to retrieve the feature from the Liberty
Repository.
- Update the server.xml file to enable WOLA for outbound calls from your
Liberty server to your applications with an external address space.
Add a zosLocalAdapters element that defines the three-part WOLA group name that
is used by clients to connect to the Liberty server.
Add a connection factory element and provide a JNDI name. For more information, see the
documentation on enabling the Liberty server environment to use optimized local adapters.
<server>
<featureManager>
<feature>zosConnect-1.0</feature>
<feature>zosLocalAdapters-1.0</feature>
</featureManager>
<!-- Local adapters connection factory definition -->
<authData id="cauth1" user="user1" password="{xor}LDo8Ki02KyY="/>
<connectionFactory id="wolaCF" jndiName="eis/ola" containerAuthDataRef="cauth1" >
<properties.ola/>
</connectionFactory>
<!-- Provide WOLA server identity -->
<zosLocalAdapters wolaGroup="LIB1" wolaName2="LIB2" wolaName3="LIB3" />
</server>
Results
You are now ready to add z/OS Connect
service elements to your server.xml configuration.