Before you install the IBM System Storage DS Storage Manager, verify that the
prerequisite software and hardware are installed on your system. The
installation program checks for prerequisites and stops if any prerequisites
are missing.
- Log on as a user with administrator authority.
- Insert the IBM System Storage DS Storage Manager CD into the CD-ROM
drive. The IBM System Storage DS Storage Manager program starts within 15
- 30 seconds if you have autorun mode set on your system. The LaunchPad
window is displayed.
If the LaunchPad window does not display, go to the CD-ROM drive using
Windows Explorer or a command prompt and perform one of the following
steps:
- Type LaunchPad at the command prompt and press
Enter. The LaunchPad window is displayed.
- Locate and double-click the LaunchPad.bat reference in
Windows Explorer.
- Note:
- If you are viewing the folder with Windows Explorer with the option selected
to hide the extensions for unknown file types, find the LaunchPad file with
the file type of MS-DOS Batch file.
- The following options are available in the Launchpad window:
- DS8000 Storage Manager overview
- Provides information about the IBM System Storage DS Storage Manager
software.
- Readme file (recommended selection)
- Provides last minute product information that was not provided in these
installation instructions.
- User's guide
- Provides specific installation instructions.
- DS8000 Storage Manager Web site
- Provides information from the product Web site.
- Installation wizard
- Starts the IBM System Storage DS Storage Manager installation
program.
- Post installation tasks
- Provides information about configuring the IBM System Storage DS Storage
Manager.
- Exit
- Exits the IBM System Storage DS Storage Manager LaunchPad program.
- Click the Readme file selection on the LaunchPad to check for
information that might supersede the information in this guide.
- Click the Installation wizard selection on the LaunchPad to
start the installation program.
- Note:
- The LaunchPad window remains open behind the installation wizard so that you
can access product information during the installation process.
There might be a slight delay while the software loads on your
system. After the software loads, a DOS prompt window opens to display
the following message:
+--------------------------------------------------------------------------------+
|Initializing InstallShield Wizard... |
|Preparing Java (tm) Virtual Machine ............................. |
|. ...................................................... |
+--------------------------------------------------------------------------------+
The Welcome window of the IBM System Storage DS Storage Manager installation
program displays if no problems are discovered during the initial system
check. If an error is discovered (for example, the operating system
does not match the prerequisite), an error message is displayed and the
installation program exits.
- Click Next to continue, or click Cancel to exit the
installation. When you click Next, the License Agreement
window displays.
- Note:
- Anytime you click Cancel on any of the installation windows, a
message asking for you to confirm that you want to exit is displayed.
- Read the license agreement and click your acceptance or nonacceptance of
the agreement. If you accept, the Next button is
highlighted. Click Next to continue or click
Cancel to exit the installation. When you click
Next, the Destination Directory window is displayed.
- Choose the directory on the Destination Directory window where you want to
install the application by using one of the following options. Clicking Next
causes the server installation checking window (a
window for each server) to display if the DS Storage Manager Server or the
DS Network Interface Server is installed on your system. If the two servers
are not installed on your system, then the Server Parameters window is displayed.
- Click the Next button to accept the default (recommended)
directory that is shown in the window.
- Type a fully qualified directory path into the Directory Name path to
designate your own directory. Then click the Next
button.
- Click the Browse button and a directory window is
displayed. Scroll to the directory that you want to use for the
application. Click it and click OK. The directory
path is displayed in the Directory Name field. Click Next to
continue.
- Click Cancel to exit the installation process.
- Observe the message on each of the next two Installation Checking
windows and click Next on each window to continue. If the
servers have not been installed, the Server Parameters window is displayed
with default values in the input fields. Go to Step 10 to proceed with the Server Parameters window. For a typical installation, default server parameters can be used.
The DS Storage Manager Server Installation Checking window is displayed if
the DS Storage Manager server is already installed on your system. A
message is displayed on the window that indicates which version of the server
is installed and whether the installation process will install a newer version
of the server. To continue the installation process, you must click
Next or click Cancel to exit the installation
process.
When you click Next, the DS Network Interface Server
Installation Checking window is displayed with a message. This message
indicates the version of the DS Network Interface server that is installed on
your system and whether the installation process will install a newer version
of the server. To continue the installation process, you must click
Next or click Cancel to exit the installation
process.
When you click Next, the Installation Confirmation window is
displayed if the two servers are already installed on your system. If your installation
process has taken you through these two
checking windows, go to Step 16.
- Click Next to accept the default values that are
displayed on the Server Parameters window. All fields must contain a
value before you can proceed to the next step.
You can change the default values by supplying the following
information:
- Host Name -- The host name of the physical machine where
the DS Storage Manager Server is installed. The host name must resolve
to a physical network node on the server. When multiple network cards
exist in the server, the host name or IP address must resolve to one of the
network cards. The value that you specify for the host name is used as
the value of the hostName property in WebSphere Application Server
configuration files. Specify the host name value in one of the
following formats:
- The fully qualified domain name servers (DNS) host name string; for
example, xmachine.manhattan.ibm.com.
- The default short DNS host name string; for example,
xmachine.
- The numeric IP address; for example,
9.127.255.3.
- The generic name localhost or its equivalent IP address;
for example, 127.0.0.1.
- Note:
- The specified value for the host name is stored by WebSphere Application
Server into its internal configuration files. If you specified the host
name in the fully qualified form or the short host name string, do not change
the host name after the DS Storage Manager Server installation. If you
do, the host name and the name that you specified for the configuration file
no longer match. If you do change the host name, you must manually edit
all the WebSphere Application Server configuration files that contain
references to the old name to reflect the new name. If you specified
the host name in the form of the numeric IP address, you must use a fixed IP
address for the computer (you cannot use DHCP to obtain a dynamic IP address
for it). The above restrictions do not exist if you specified the host
name in the form as localhost.
- HTTP Port -- The port number that the DS Storage Manager
Server uses. The port number must be a port that is not being used by
another process on the system. After the DS Storage Manager Server is
installed, you must include this port number in the URL to access the
console. That URL is the protocol name, plus the fully qualified host
name, plus the port, plus DS8000/console; for example,
http://myhost.com:8451/DS8000/console.
- HTTPS Port -- The port that the DS Storage Manager Server
uses for secure HTTP transport (HTTPS).
- Bootstrap/RMI Port -- The port that the DS Storage Manager
Server uses for the bootstrap port.
- SOAP Port -- The port that the DS Storage Manager Server
uses for Simple Object Access Protocol (SOAP).
- Server help Port -- The port for the Eclipse help
Server. This port is the one that the help system (based on Eclipse
technology) uses to receive requests for help files.
- Note:
- The values that are used in the Server Parameters window fields must not
conflict with existing port assignments that are already on the system or
reserved for use by another application.
- Click Next after you have ensured that all the input fields on
the Server Parameters window are complete. The SSL Configuration window
is displayed. This window allows you to supply the fully qualified name
of the two server key files generated before or during the DS8000 Storage
Manager installation.
- Follow the instructions on the window.
- First, designate whether you want to generate a new SSL certificate by
selecting Generate the self-signed certificates during
installation. This is the most likely selection when you are
installing DS8000 Storage Manager for the first time. You can also
select Use existing SSL certificates. This choice is most
likely made when the key files already exist and you do not want to generate
new key files.
- Complete the rest of the fields on the window. Provide the fully
qualified path to the key file and trust file by using the Browse
button. The key file and trust file are identified by an extension of
.jks.
- If you are creating new certificates, create a password for each file. The password must be a minimum of six characters and it cannot contain any blanks.
Allowable characters are letters A-Z and a-z, digits 1-9, and special characters - and _ (hyphen and underscore). Supply the existing password if you are using an existing SSL certificate.
Record the location and passwords for the SSL certificates so that you can refer to them in the future if necessary.
- Click Next to continue the installation process. If you
have selected Generate the self-signed certificates during
installation, the Generate Self-Signed Certificate window is
displayed. If you selected Use existing SSL certificates,
the Installation Confirmation window is displayed.
- Note:
- When you select Generate self-signed certificates during installation
and the key files already exist on the system at the specified
location, clicking Next causes a message to display. It asks
you to designate whether you want to have the system keep existing application server certificates
if they exist on the location. The default is YES which keeps the existing
application server certificates.
- Complete each of the input fields with the required information.
Use the following as a guide to provide the needed information.
- Keystore alias
- This is the alias for the self-signed certificate. It uniquely
identifies the certificate within the keystore file. It is a good
practice to use a unique name related to the server name.
- Key size
- Two key sizes are available, 512 and 1024. 1024 is the
default.
- Common name
- This name is the primary, universal identity for the certificate.
If your system contains the secured WebSphere environment, this name must be
valid in the configured user registry.
- Organization name
- The name of your company
- Organization unit (optional)
- The name of a department or division within your company. Remember
that you are building a profile for the certificate. As a security
measure the more specific the information the more secure your system.
- Locality (optional)
- The city or location where your company resides.
- State (optional)
- The state or province where your company resides.
- Country or region
- The two-character designator that identifies the country where your
company is located. Use the pull-down menu to make this
selection.
- Validity period (days)
- Specifies the lifetime of the certificate in days.
The information that you provide is used to build a profile for the
certificate. This information is used during identity processing to
ensure validation of any processing that is occurring. It is part of
the security measures that are used during SSL connectivity.
Click Next to continue, or click Cancel to exit the
installation.
- Click Next. The Installation Confirmation window is
displayed. This window displays both the location where the product
will be installed and the total size needed for the installation.
- Note:
- The total size required for installation may vary, depending on your installation environment.
- Click the Install button on the Installation Confirmation
window to begin the installation process. There are several progress
windows that are displayed. There is no required interaction on your
part for each of the progress windows that are displayed. However, you
can choose to cancel (not recommended) the installation on any of the progress
windows with varying consequences.
The installation process performs the following actions:
- If the two servers (DS Storage Manager Server and DS Network Interface
Server) are already installed on your system, they are stopped in the
following order:
- The Embedded IBM WebSphere Application Server - Express server (part of
the DS Storage Manager Server)
- The DS Network Interface Server
- The WS Help System (part of the DS Storage Manager Server), if it was not stopped before by the Embedded IBM WebSphere
Application Server
- If one or both of the servers are not installed or have to be upgraded on
your system, they are installed or upgraded in the following order (the
progress of the installation is indicated on the associated progress
window):
- DS Storage Manager Server Installation Progress window
- DS Network Interface Server Installation Progress window
- Note:
- You can click Cancel (not recommended) during the DS Network
Interface Server installation process. The process does not stop
immediately when the Cancel button is clicked. Rather, the
process continues to install all the files that are associated with this part
of the installation. These files remain installed and are not
reinstalled upon reactivation of the installation process.
A confirmation message is displayed that asks you to confirm that you want
to cancel the installation.
- The Components Installation Progress (displaying the installation or
upgrade progress of the DS Storage Manager product applications) is displayed
after the servers have been installed or upgraded.
- Note:
- You can click Cancel (not recommended) during the components
installation process. The installation process stops immediately when
the Cancel button is clicked. A window with a confirmation
message is displayed. For a new installation, when you confirm that you
want to stop the process, all the files that have been copied up to the point
that the Cancel button was clicked are uninstalled. You then
are exited from the installation process.
When this part of the installation is completed, if no system restart is required,
the system starts both servers: first the DS Network Interface Server and then the DS Storage
Manager Server. Wait for the servers to be started before going to the
next step. When the servers have been started, the Installer Finish
window is displayed with the result of the installation
process (successful or unsuccessful).
If a system
restart is required, the Installer Finish window is displayed, asking you to
restart the system. Click Next on the Finish window.
The Installer Reboot window is displayed. Choose the default selection Yes,
restart my computer on the Reboot window and then click Finish.
Both servers, first the DS Network Interface Server and then the DS Storage
Manager Server, will start automatically after the restart.
- Click Finish to exit the installation process.
When the installation process exits, a file (postinstallation.txt) is
displayed, containing the postinstallation tasks. Use these instructions to complete the setup tasks.
- If the Finish window indicates that the installation fails, you must exit the installation process and check the installation log for error messages. The installation log is located in xxx\logs\install.log, where xxx is the
destination directory where the IBM System Storage DS Storage Manager is
installed (for example, c:\Program Files\IBM\DS8000 Storage Manager).
Errors fall into two categories: system or incorrect values that are
designated during the installation process. Use the following
guidelines to correct these errors.
- If the error is due to a system problem, correct it and reinstall the
DS8000 Storage manager using either the interactive or unattended (silent) mode of
installation.
- If the error is due to a wrong installation parameter value, restart the
installation using the steps that are described in this procedure or the steps
that are described in the unattended (silent) mode of installation. Navigate to the
Server Parameters window and insert the correct values. Then finish the
installation process.
-
Start the DS Storage Manager.
- Complete the postinstallation tasks. If, when exiting the
installation wizard, the postinstallation.txt file does not
automatically open, manually open it from the LaunchPad window, and follow the
instructions to complete the postinstallation tasks.
- Exit the LaunchPad program by clicking Exit on the LaunchPad
window.