Start of changes for service refresh 8 fix pack 20

Installing from an RPM package (Linux only)

The RPM Package Manager installer packages are available as standard .rpm files, which can be installed interactively from the command line.

Before you begin

If you are upgrading the SDK from an earlier release, as a precaution, back up all the configuration files and security policy files before you start the upgrade.

On Linux®, check the following conditions before you begin the installation process:

If you are installing an installable package, you must have the rpm-build tool installed on your system, otherwise the installation program cannot register the new package in the RPM database. To find out if the rpm-build tool is installed, enter the following command:
```
rpm -q rpm-build
```
If you have previously installed the IBM® SDK from an RPM package, you must uninstall this package before proceeding.
If you have a SuSE Linux system, a different version of Java™ might already be installed under a different directory tree. Uninstall this package before proceeding.
You must have the following dependent libraries for your environment:
- IBM® POWER®® (Little Endian architecture):
  - GNU C Library: eglibc V2.19 or later
  - Standard C++ library: libstdc++.so.6
- All other architectures (x86, IBM POWER, and POWER Linux on IBM Z®®):
  - GNU C Library: glibc V2.3.4 or later
  - Standard C++ library: libstdc++.so.6

About this task

The RPM packages have a .rpm file extension and are installable (Linux only) packages.

Installing these packages also configures your system, for example by setting environment variables. You must use a user account with ROOT authority to install this type of package.

Procedure

If your system does not have the dependent libraries that are defined, obtain and install the library.
Change to a temporary directory.
Download the latest RPM package file to the temporary directory.
Install the RPM package with the following command:
```
rpm -ivh <file_name>.rpm
```
Verify the available package by running the following command:
```
rpm -q <file_name>.rpm
```

You can optionally check that an .rpm package has not been corrupted or altered by using the GPG-formatted public key to verify the RPM packages:

Download the GPG-formatted public key.
```
ibm-java-public-GPGkey-<yyyymmdd>.pgp
```

Manually import the key into the RPM database.

rpm --import ibm-java-public-GPGkey-<yyyymmdd>.pgp

Verify the signature of the .rpm package. Use the following command.

rpm -K <package name>

For example:

rpm -K ibm-java-s390x-sdk-8.0-8.20.s390x.rpm

The output should summarise that the signatures and digests are "OK".

ibm-java-s390x-sdk-8.0-8.20.s390x.rpm: digests signatures OK

You can see more detail by adding the verbose option.

rpm -Kv ibm-java-s390x-sdk-8.0-8.20.s390x.rpm

The output should show that all signatures and digests are "OK".

ibm-java-s390x-sdk-8.0-8.20.s390x.rpm:
    Header V4 RSA/SHA256 Signature, key ID 8a8d4582: OK
    Header SHA1 digest: OK (bd33837ccb9a2dc94f457cdcdd905ec9c74cb0fb)
    V4 RSA/SHA256 Signature, key ID 8a8d4582: OK
    MD5 digest: OK (4adcd25b3f69a2ca3d2be678e6ff85e8)

Results

The package is installed to the following directory:

/opt/ibm

Note:

Do not interrupt the installation process, for example by pressing Ctrl+C. If you interrupt the process, you might have to reinstall the product.
To uninstall the RPM package on the system, run the following command:
```
rpm -e <file_name>
```

If you are using an installable package on Linux, you might see messages advising that a problem has been found. Some of the messages that you might see when using an installable package are shown in the following list:

The installer cannot run on your configuration. It will now quit.: This error message occurs when your user ID is not authorized to run the installation process. Because it cannot continue, the installation program ends. To fix the problem, start the installation again but with a user ID that has root authority.
An RPM package is already installed. Uninstall the package before proceeding.: This message indicates that an RPM package is already installed. Because it cannot continue, the installation program ends. To fix the problem, uninstall the RPM package before proceeding.
Warning: there may be a version of this package already installed. If this version was supplied by SuSE, it will have been packaged so that it installs under a different directory tree. To avoid unexpected results, you should use YaST2 to remove the SuSE-supplied version.: This message appears when you attempt to install on a SuSE system. The reason is that there might be an SDK or runtime environment already installed. The installation program proceeds, but might encounter a problem during the process. If this situation occurs, uninstall any existing packages and try again.

End of changes for service refresh 8 fix pack 20