Installing the Web Server Plug-ins on IBM i operating systems using the command line
You can install the Web Server Plug-ins using the Installation Manager command line.
Before you begin
Before you install the Web Server Plug-ins, ensure that your user profile has *ALLOBJ and *SECADM special authorities.
- If you want to use the Installation Manager that comes with this
product, perform the following actions:
- Obtain the necessary files.There are three basic options for obtaining and installing Installation Manager and the product.
- Access the physical media, and use local installation You can access the product repositories on the product media.
- Install Installation Manager on your system.
You can install Installation Manager using the product media, using a file obtained from the Passport Advantage® site, or using a file containing the most current version of Installation Manager from the IBM® Installation Manager download website.
- Use Installation Manager to install the product from the product repositories on the media.
- Install Installation Manager on your system.
- Download the files from the Passport Advantage site, and use
local installation Licensed customers with a Passport Advantage ID and password can download the necessary product repositories from the Passport Advantage site.
- Download the files from the Passport Advantage site.
- Install Installation Manager on your system.
You can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.
- Use Installation Manager to install the product from the downloaded repositories.
- Access the live repositories, and use web-based installation If you have a Passport Advantage ID and password, you can install the product from the web-based repositories.
- Install Installation Manager on your system.
You can install Installation Manager using the product media, using a file obtained from the Passport Advantage site, or using a file containing the most current version of Installation Manager from the IBM Installation Manager download website.
- Use Installation Manager to install the product from the web-based repository located
at
https://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v85
Note: This location does not contain a web page that you can access using a web browser. This is a remote web-based repository location that you must specify for the value of the -repositories parameter so that the imcl command can access the files in this repository to install the product.
Whenever possible, you should use the remote web-based repositories so that you are accessing the most up-to-date installation files.
- Install Installation Manager on your system.
Note: If you do not have a Passport Advantage ID and password, you must install the product from the product repositories on the media or local repositories. - Access the physical media, and use local installation
- Install Installation Manager.
- Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
- On a CL command line, run the STRQSH command to start the Qshell command shell.
- Make sure that the umask is set to 022.To verify the umask setting, issue the following command:
To set the umask setting to 022, issue the following command:umask
umask 022
- Change to the temporary directory where you unpacked the Installation Manager files.
- Run the following command in the temporary folder:
installc -acceptLicense -log log_file_path_and_name
Notes:- For more information on installing Installation Manager, see the IBM Installation Manager documentation.
- When installing the product on IBM i operating systems, use only the installc command to install Installation Manager.
- If you are using local repositories to install and maintain the product, unpack the compressed file containing the repository to a directory on your system.
- Obtain the necessary files.
- If you already have a version of Installation Manager installed
on your system and you want to use it to install and maintain the
product, obtain the necessary product files.There are three basic options for installing the product.
- Access the physical media, and use local installation
You can access the product repositories on the product media. Use Installation Manager to install the product from the product repositories on the media.
- Download the files from the Passport Advantage site, and use
local installation Licensed customers with a Passport Advantage ID and password can download the necessary product repositories from the Passport Advantage site.
- Download the product repositories from the Passport Advantage site.
- Use Installation Manager to install the product from the downloaded repositories.
- Access the live repositories, and use web-based installation If you have a Passport Advantage ID and password, you can use Installation Manager to install the product from the web-based repositories. Use Installation Manager to install the product from the web-based repository located at
https://www.ibm.com/software/repositorymanager/com.ibm.websphere.PLG.v85
Note: This location does not contain a web page that you can access using a web browser. This is a remote web-based repository location that you must specify for the value of the -repositories parameter so that the imcl command can access the files in this repository to install the product.Whenever possible, you should use the remote web-based repositories so that you are accessing the most up-to-date installation files.
Note: If you do not have a Passport Advantage ID and password, you must install the product from the product repositories on the media or local repositories. - Access the physical media, and use local installation
Procedure
- Optional: If the repository requires a username
and password, create a keyring file to access this repository.
Tip: When creating a keyring file, append /repository.config at the end of the repository URL location if the imutilsc command is unable to find the URL that is specified.Supported configurations:
Starting in Installation Manager Version 1.6.2, the -keyring and -password options that were used to access credentials in a key ring file are deprecated. For Installation Manager Version 1.6.2 and later, use the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file.
In Version 1.7, the format of the secure storage file is revised, and is no longer compatible with versions of Installation Manager before version 1.7. Update Installation Manager to version 1.7 or higher and then re-create and replace any secure storage files that you created with earlier versions.
There is no migration path from key ring files to storage files because of the differences in the file structures. You must create a storage file to replace a key ring file. For more information about using the -secureStorageFile and -masterPasswordFile options to store credentials in a credential storage file, see the IBM Installation Manager documentation.
- Sign on to the IBM i system with a user profile that has *ALLOBJ and *SECADM special authorities.
- On a CL command line, run the STRQSH command to start the Qshell command shell.
- Make sure that the umask is set to 022. To verify the umask setting, issue the following command:
To set the umask setting to 022, issue the following command:umask
umask 022
- Change to the eclipse/tools subdirectory in the directory where you installed Installation Manager.
- Use the imcl command to install the
product.
./imcl install com.ibm.websphere.PLG.v85_offering_version -repositories source_repository -installationDirectory installation_directory -sharedResourcesDirectory shared_directory -accessRights access_mode -preferences preference_key=value -properties property_key=value -keyring keyring_file -password password -acceptLicense
Tips:- The offering_version, which optionally can
be attached to the offering ID with an underscore, is a specific version
of the offering to install (
8.5.0.20110503_0200
for example).- If offering_version is not specified, the latest version of the offering and all interim fixes for that version are installed.
- If offering_version is specified, the specified version of the offering and no interim fixes for that version are installed.
The offering version can be found attached to the end of the offering ID with an underscore when you run the following command against the repository:./imcl listAvailablePackages -repositories source_repository
- You can also specify
none
,recommended
orall
with the-installFixes
argument to indicate which interim fixes you want installed with the offering.- If the offering version is not specified, the
-installFixes
option defaults toall
. - If the offering version is specified, the
-installFixes
option defaults tonone
.
- If the offering version is not specified, the
- For initial installations, it is a good practice to specify the plugins_user_data_root;
otherwise, the default value for the plugins_user_data_root, /QIBM/UserData/WebSphere/Plugins/V85/webserver,
is used. Use the was.install.os400.profile.location property to specify
the plugins_user_data_root. If the plugins_user_data_root is
to be /QIBM/UserData/WebSphere/Plugins/V85/webserver,
for example, specify
-properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Plugins/V85/webserver
on the imcl installation command. - The relevant terms and conditions, notices, and other information are provided in the license-agreement files in the lafiles or product_name/lafiles subdirectory of the installation image or repository for this product.
- The program might write important post-installation instructions to standard output.
For more information on using the imcl command to install the product, see the IBM Installation Manager documentation.
- The offering_version, which optionally can
be attached to the offering ID with an underscore, is a specific version
of the offering to install (
What to do next
You can create a plug-ins profile using the manageprofiles command.
manageprofiles -create
-templatePath /QIBM/ProdData/WebSphere/Plugins/V85/webserver/profileTemplates/http
-profileName PluginsSrv01
manageprofiles -setDefaultName -profileName PluginsSrv01