You can install the IBM System Storage DS Storage Manager in your Linux
environment using the graphical mode.
Perform the following steps to install the IBM System Storage DS Storage
Manager.
- Log on as a user with root authority.
- Create a mount point or choose an existing mount point.
- Determine where you want to mount the DS8000 Storage Manager CD.
For example, imagine you have decided to mount the CD in a CD-ROM drive known
as /dev/cdrom at mount point /mnt/cdrom. When the time comes for you to
mount the CD in this drive, you perform the following steps:
- Insert the CD in the CD-ROM drive.
- Type the following command at the command prompt: # mount -o ro
/dev/cdrom /mnt/cdrom
- Choose the destination paths for the DS8000 Storage Manager components and
be sure that you have enough space available on the chosen destination.
The installation program (installer) provides a default installation location
(/opt/IBM/DS8000StorageManager) for the component. You can
override this by using the installer browse function. When you click
Next, the installer analyzes the available space for the location
that you provide. If there is not enough space, you cannot proceed to
the next panel in the installation process.
- Change the current directory to the mount point for the CD-ROM
drive. For example, if the CD was mounted at the /mnt/cdrom mount
point, type the following command: # cd /mnt/cdrom
- Run the wizard launcher, launchpad_linux, by typing the following
command: # ./launchpad_linux. The installation
in graphical mode begins with a LaunchPad facility to launch the installation
program wizard.
The LaunchPad facility provides links for you to view various text files,
such as:
- 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 the instructions, in HTML format, associated with installing the
DS8000 Storage Manager.
- 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 selection on the LaunchPad window to ensure
that you have the latest installation information. The README file can
provide additional information that supersedes information in this
guide.
- Note:
- You can also access the README.txt file located in the doc
subdirectory on the IBM System Storage DS8000 Storage Manager CD.
- Click the Installation wizard selection on the LaunchPad to
start the installation.
- Note:
- The LaunchPad window remains open (behind the wizard) during the
installation. You can access product information after the installation
has started. The LaunchPad returns to the foreground when the
installation is complete. You can click Exit to close the
LaunchPad.
There might be a slight delay while the software loads on your
system. After the software loads, a Command 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.
- Click Next to continue, or click Cancel to exit the
installation. When you click Next, the License Agreement window is
displayed.
- 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 Linux Destination Directory 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 server 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
13 to proceed with the Server Parameters window.
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 installs 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 installs 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 19 to proceed with the installation.
- Click Next after you ensure that all the fields on the
Server Parameters window contain acceptable values. 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 as localhost.
- HTTP Port -- The port number that DS Storage Manager
Server uses. The port number must be a port that is not being used by
another process on the system. After DS Storage Manager Server is
installed, you must include this port number in the Web address for opening
the console. This Web address is the protocol name, plus the fully
qualified host name, plus the port, plus DS8000/Console. An example is
http://myhost.com:8451/DS8000/Console
- HTTPS Port -- The port that DS Storage Manager Server uses
for secure HTTP transport (HTTPS).
- Bootstrap/RMI Port -- The port that DS Storage Manager
Server uses for bootstrap port.
- SOAP Port -- The port that DS Storage Manager Server uses
for Simple Object Access Protocol (SOAP).
- Server help port -- The port for the Eclipse help
Server. This is the port that the help system (based on Eclipse
technology) uses to receive requests for help files.
- Note:
- The values 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 when the Server Parameters window is
complete. The SSL Configuration window is displayed. This window
allows you to supply the fully qualified name of the two server key that are
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 the 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. Also, provide a password for each file. The
password must be a minimum of six characters and cannot contain any
blanks. Allowable characters are letters A-Z and a-z, digits 1-9, and special characters - and _ (hyphen and underscore).
- 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 displays a message. The message 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 that is 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 pulldown 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 is 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 that is needed for the installation.
- 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) is stopped first.
- The DS Network Interface Server is stopped next.
- The WS Help System (part of the DS Storage Manager Server) is
stopped, 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 leave, 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 reboot 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
reboot is required, the Installer Finish window is displayed, asking you to
reboot the system. Click Next on the Finish window.
The Installer Reboot window is displayed. Click Finish on the Logout window.
- Click Finish to exit the installation process. When the
installation wizard exits, a file (postinstallation.txt) is displayed,
containing the postinstallation tasks. Follow the instructions in the
postinstallation text file to complete the postinstallation tasks. If
the installation failed, you must exit the installation process and check the
install log for error messages.
- If the Finish window indicates that the installation failed, 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.
Errors fall into two categories: system or incorrect values that are
designated during the install process. Use the following guidelines to
correct these errors:
- If the error is due to a system problem, correct it and reinstall the GUI
using either the graphical or unattended (silent) mode of install.
- 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 install. Navigate to the Console
Server Parameters window and insert the correct values. Then finish the
installation.
- Check the postinstallation instructions after the installation has
completed. The postinstallation.txt file is displayed
immediately after the installation of the DS Storage Manager finishes
processing. If the postallation.txt file does not display, click
the Post installation tasks link on the LaunchPad window to access
these instructions. These instructions provide reminders and the steps
to help you start using the DS Storage Manager.
- Exit the LaunchPad program by clicking Exit on the LaunchPad
window.
- Type the following command when you are finished using the IBM
System Storage DS Storage Manager CD and want to remove it from your
computer: # umount /mnt/cdrom where /mnt/cdrom is
where the CD is mounted.