Setting up the product extensions directory
The final step in the installation of the IBM z/OS Connect native server, is to run the zconsetup script to create the product extensions directory.
Before you begin
- The /var/zosconnect directory to create the /var/zosconnect/v3r0/extensions directory.
- The <installation_path>/wlp/etc directory to create the symlink to the /var/zosconnect/v3r0/extensions directory.
About this task
A product extension is a structured directory on disk that stores Liberty features. Each product extension must be configured by a properties file and stored under the product extensions directory so that the extension can be detected by the server. For z/OS Connect, the product extensions directory is /var/zosconnect/v3r0/extensions. For more information, see Liberty product extension in the WebSphere® Application Server Liberty base documentation.
The zconsetup utility must be used at least once per LPAR because /var is not a shared file system. You cannot configure the specific path for the z/OS Connect product extensions. However, you can share your z/OS Connect native server configuration across LPARs by mounting a shared zFS as /var/zosconnect on each LPAR.
The zconsetup utility must also be run from each server installation to create the symlink from the server's wlp/etc directory to the /var/zosconnect/v3r0/extensions directory.
Running the zosconnect install command more than once does not cause a problem.
The /var/zosconnect/extensions directory and its contents can be used by IBM z/OS Connect Servers at any maintenance level.
The /var/zosconnect/v3r0/extensions directory and its contents can be used by IBM z/OS Connect Servers at any maintenance level.
Procedure
Results
- Creates the release-specific product extensions directory in the
/var/zosconnect directory, for
example:/var/zosconnect/v3r0/extensions
- Creates a symbolic link of the extensions directory in the product z/OS
UNIX installation path. For example:
/usr/lpp/IBM/zosconnect/v3r0/wlp/etc/extensions
- Install the z/OS Connect product extension properties file in the product extensions directory.
Path | Contents |
---|---|
/usr/lpp/IBM/zosconnect/v3r0/bin | Product code |
/usr/lpp/IBM/zosconnect/v3r0/runtime/lib/ | zosconnect feature files |
/usr/lpp/IBM/zosconnect/v3r0/wlp/etc/extensions | Symlink to /var/zosconnect/v3r0/extensions |
/var/zosconnect/v3r0/extensions | Product extension properties files that contain the absolute path to the service providers. |