Readme
file for: IBM®
Information Archive®
Product/Component Release: 2.1.1.0
Update Name: Not applicable
Fix ID: ia-2.1.1.0_upgrade
Publication Date: 03 June 2011
Last modified date: 03 June 2011
Description
Preparing for the software upgrade
Considerations for Enhanced Remote Mirroring environments
Downloading the upgrade packages
Installing the optional Index and Search feature
Installing the co-requisite firmware updates
Performing necessary tasks after the software upgrade
Information Archive Administrative interface
Management console server
Known problems and workarounds
Verifying that the storage logical drives are on the preferred path
Resolving the “Not on Preferred path” error
Copyright and trademark information
The
instructions in this document guide you through the upgrade of the Information
Archive software to version 2.1.1.
Important:
After you upgrade the software, an IBM service representative must
upgrade the firmware for the System x® servers that are installed in the
appliance. Arrange for the IBM service representative to arrive at your
location approximately four hours after you start the software upgrade
procedure.
Before you
start the upgrade of the Information Archive software to version 2.1.1, you
must complete these prerequisite tasks.
Complete the
following steps on the management console server:
1.
Check
the code level to ensure that your appliance is running Information Archive version
1.2 or later. Complete the following steps to view the appliance code level:
a)
Log
on to the Information Archive administrative interface.
b)
In
the Suite Name table on the Welcome page, click IBM Information Archive.
c) On the About
page, expand the Appliance Details section. The Release row in the table
lists the appliance software version. Make a note of the software version.
2.
Check
whether you need to run the Installation Configuration Wizard (ICW), by
completing the following steps:
a)
Expand
Information Archive Management in the navigation tree.
b)
Click
Getting Started. Continue as follows:
·
If
the “Welcome to the IBM Information Archive” panel is displayed in the Getting
Started pane, you do not need to run the ICW.
·
If
the Configure System button is displayed in the Getting Started pane,
you must run the ICW. For instructions about how to run the ICW, see the Installing
and Configuring IBM Information Archive publication.
If you configure the appliance for file archive
collections, the following message might be returned even though the IP
addresses are not currently in use:
CTJIW0151W
The following IP addresses are already in use:
<server_IP_addresses>. Specify different IP addresses and retry the
action.
If the error message is displayed, click Finish and continue as
follows:
|
Status |
Description |
Action |
|
No error message is displayed. |
The IP addresses are not in use. |
Ignore the initial error message. |
|
The error message is displayed. |
The IP addresses are in use. |
Specify different IP addresses. |
This information is also described in IBM Technote 1470833.
Review the technote in case additional details are included since the
publication of this readme document. You can access the technote at the
following website:
https://www-304.ibm.com/support/docview.wss?uid=swg21470833
3.
Ensure
that values are specified for the domain name and the primary domain name
server (DNS). To verify or add these values, complete the following steps in
the Information Archive administrative interface:
a)
In
the navigation tree, click System Management.
b)
In
the General Settings section of the Appliance Overview page, click Properties.
c)
In
the properties notebook, open the IP Settings page and ensure that a value is
specified in the Domain Name and Primary DNS Server fields.
If a domain name does not exist in the Domain Name field, enter a
domain name. If your network is not configured with a domain name, enter a
domain name in the following format: example.domain.com
d)
If
an IP address is not specified in the Primary DNS Server field, enter an
IP address for the primary DNS server. If your network does not use a DNS
server, specify the IP address of the management console server.
e)
If
you changed the Domain Name or Primary DNS Server fields, click OK
or Apply to save the changes.
The following message might be returned:
CTJIM1000E:
An unidentified error occurred: ‘the host name, iarsm1 was not found in
/etc/hosts ‘.
If the error message is displayed, click OK or Apply again
to save the configuration changes.
This information is also described in IBM Technote 1444585.
Review the technote in case additional details are included since the
publication of this readme document. You can access the technote at the
following website:
https://www-304.ibm.com/support/docview.wss?uid=swg21444585:
4.
Run
the Wellness check utility by completing the following steps:
a)
Log
on to the management console server with the iaadmin user ID and password.
b)
Right-click
the desktop and click xterm to open
a command prompt.
c)
From
the xterm command prompt, run the following command to check the hardware
status:
verify_wellness
d)
Wait
10 minutes for the command to complete.
e)
Depending
on the messages that are returned, take one of the following actions:
|
Message |
Description |
Action |
|
The system has passed the wellness
verification: |
Hardware components are correctly installed. |
Continue with this upgrade procedure. |
|
Failed: The system did not pass
wellness verification!: |
Hardware components are not correctly installed. |
Contact the next level of support |
Verify or add
values for the RSM for Storage server, by completing the following steps:
1.
Log
on to the RSM for Storage interface in one of the following ways:
a)
By
using the administrative interface:
i.
Log
on to the administrative interface.
ii.
Expand
Information Archive Management in the navigation tree.
iii.
Click
Service Tools.
iv.
Click
Open Remote Support Manager.
b)
By
using a direct connection:
i.
Access
the IBM Information Archive keyboard video mouse (KVM) console.
ii.
Press
PrtSc to open the KVM console menu. Select iarsm1 to connect to the RSM
for Storage server.
iii.
Log
on to the RSM for Storage server with the admin user ID and password.
iv.
Click
the Manage icon on the server desktop to open the RSM for Storage
interface.
v.
Click
any link to receive a logon prompt.
2.
Navigate
to the Connection Information page, by completing the following steps:
a)
Click
Update System Configuration.
b)
Click
Connection Information.
c)
The
first field in the Connection Information page is IP address of SMTP server,
or DIRECT. If the value of the field is DIRECT
continue to the Remote Access Connections step. If the field contains an IP
address, verify that the address can be successfully pinged. For example:
i.
Open
a Konsole terminal session.
ii.
Run
the following command:
ping –c 2 <IP_address>
Where <IP_address> is the address that is shown in the IP
address of SMTP server, or DIRECT field. For example:
# ping –c 2 9.12.34.567
If the ping command is successful, the command output includes two lines
that are similar to the following line:
64 bytes
from <IP_address>: icmp_seq=1 ttl=126 time=0.354 ms
If the ping command is not successful, the command output includes one
of the following messages:
Destination
Host Unreachable
100%
packet loss
unknown host
In this case, complete the following steps:
A.
Make
a note of the current IP address in the IP address of SMTP server, or DIRECT
field, so that you can restore the value after the upgrade.
B.
Change
the field value to: DIRECT
3.
In
the Remote Access Connections section, ensure that the “For a remote SSH”
connection table is completed. The External IP Address IBM should use:
field must contain a value. By default, the following address is configured: 172.31.3.250.
If remote access is enabled, this field might contain the external IP
address of the RSM for Storage server. If this field does not contain a value,
use the default value 172.31.3.250.
This IP address cannot be used for external SSH access, but enables you to run
the upgrade on the RSM for Storage server.
Although the External IP Address IBM should use: field is
optional for the RSM for Storage application, Information Archive requires a
value in this field so that the appliance can communicate with the RSM for
Storage server through the internal SSH network.
4.
If
you modify the contents of any field on the Connection Information page, select
the Update Configuration button at the bottom of the Connection
Information page.
You must
contact IBM to arrange for the co-requisite firmware updates for the System x
servers and Fibre Channel switches. These updates must be applied by an IBM
System Services Representative (SSR) after you upgrade the software and before
the appliance can be used at the 2.1.1 level.
Important:
When you contact IBM, request the installation of Machine Type 2231 ECA
002. Depending on the number of System x servers in the appliance, the
firmware update can take several hours to complete after the software is
upgraded. Plan for sufficient time to complete the firmware update before you
start the software upgrade, because the firmware update must be ordered and a
receipt date must be known before the IBM SSR can set a date for the firmware
update.
Complete
these to steps to prepare for the software upgrade.
For appliances in an Enhanced Remote Mirroring (ERM) configuration, you must
upgrade both of the mirrored appliances. Upgrade the secondary appliance first.
After the secondary appliance is successfully upgraded, upgrade the primary
appliance. The upgrade instructions apply for both the primary and secondary
appliances.
Complete the
following steps to download and verify the files for the software upgrade:
1.
Open
the IBM support website:
http://www.ibm.com/systems/support/storage/disk/InformationArchive
2.
From
the menu “Choose your page”, click Downloads.
3.
Select
View IBM Information Archive downloads.
4.
Select
the following archive packages:
·
ia-2.1.1.0_upgrade1.zip
·
ia-2.1.1.0_upgrade2.zip
5.
Click
Continue and follow the interface
instructions to download the upgrade packages.
6.
Verify
the validity of the upgrade files by checking the checksums of each of the
archive files against the value in the md5sum.txt file.
7.
If
you have purchased a license for the optional Index and Search feature,
download the license installation file from the IBM Passport Advantage website
or order an installation DVD from the website. You can install this feature
after running the 2.1.1 upgrade or at a later time.
8.
Burn
the upgrade files to a DVD or transfer them to another form of media that can
be mounted on the management console server. For example, you can use a USB
flash drive.
1.
Schedule
a time to stop all I/O activity to the appliance during the upgrade. The
software upgrade takes up to six hours, or approximately 1 hour per server.
2.
Transfer
the upgrade packages to the /tmp directory on the management console
server in the appliance, by using the method of your choice.
3.
Log
on to the Information Archive administrative interface with a user account that
is assigned the “IA System Administrator” role. Complete the following steps
from the System Management page.
Important:
Complete the following two steps only for a stand-alone
appliance or the primary appliance in an Enhanced Remote Mirroring environment.
Do not complete these steps for the secondary appliance in a mirroring
environment.
a)
Suspend
all collections.
b)
Put
each cluster node into maintenance mode.
4.
Log
on to the management console server with the iaadmin user ID and password.
5.
Right-click
the desktop and click xterm to open a command prompt.
6.
Complete
the following steps from an xterm command line:
a)
Verify
the file transfer by checking the MD5 checksum of each of the archive files
against the value in the md5sum.txt file.
b)
Extract
the contents of the upgrade packages to the /tmp directory.
You must be logged on with the iaadmin user ID to extract the files. For
example:
unzip ia-2.1.1.0_upgrade1.zip
unzip ia-2.1.1.0_upgrade2.zip
c)
If
no collections are created, disable tracing by running the ia_service.py
command on the management console server. For example:
/opt/tivoli/tiam/bin/ia_service.py -r trace -c gpfs -l disable
If any collections exist, go to the next step.
Upgrade the
software on the appliance, by running the following steps from an xterm command
line on the management console server.
1.
Change
to the directory that was created when you extracted the upgrade packages. For example:
cd/tmp/ia-2.1.1.0
2.
Run
the iaupgrade.sh script from this directory. For example: /opt/tivoli/tiam/bin/iaupgrade.sh
3.
When
the system prompts you, enter the iscadmin password.
4.
A
series of prerequisite checks are run for a few minutes before the system
prompts you to continue the upgrade. If any warnings are shown during the
consider resolving these issues before you continue. When you are ready to
continue, type "Y" and
press Enter.
Tips:
·
If
a message is returned which indicates that the upgrade process is unable to
restart one or more servers, follow the instructions in the message to manually
restart the servers.
·
Do
not press Enter more times than necessary during the upgrade or you can
inadvertently cancel the upgrade process. If you cancel the upgrade, restart by
repeating step 2.
5.
When
the upgrade is complete, the following message is returned:
Upgrade
completed successfully
After this message is shown, the management console server is
automatically restarted.
6.
After
the management console server restarts, check the software version by
completing the following steps:
a)
Log
on to the server with the iaadmin user ID and password.
b)
Open
an xterm window.
c)
Run
the following command from the xterm window:
iaversion
d)
Ensure
that the correct version number is displayed in the command output: 2.1.1.0
The Index and
Search feature is available as a separately licensed package. If you have
purchased the license and downloaded the installation package, use the Quick
Start Guide to install the feature after the software upgrade to 2.1.1.0 is
completed. You can also install the Index and Search feature at a later time.
The co-requisite firmware updates for the System x servers and Fibre
Channel switches (Machine Type 2231 ECA 002) must be installed by an IBM service
representative now. Ensure that the IBM service representative has updated the
firmware and started the appliance components before you continue to the next
section.
After the
software upgrade and firmware update are installed, you must complete several
actions on different components in the appliance to finalize the upgrade.
If the upgrade was installed on the primary appliance in a mirroring
environment and mirroring was suspended before the upgrade, the upgrade
automatically resumes the mirror. If you do not want mirroring to continue, you
must suspend mirroring again after the upgrade.
Important:
Suspend the mirror before collections are resumed in the following
steps.
If the primary DNS server value was “empty” in the appliance properties
“IP settings” panel before the upgrade and was reset to use the management
console server IP address in preparation for the upgrade, the value must be
cleared before collections are resumed.
Important:
You must clear the DNS value if you modified the DNS setting before the
software upgrade.
Clear the DNS server value by completing the following steps:
1.
Log
on to the management console server with the iaadmin user ID and password.
2.
Log
on to the administrative interface with a user account that is assigned the IA
System Administrator role.
3.
In
the navigation tree, click System Management.
4.
In
the General Settings section of the Appliance Overview page, click Properties.
5.
In
the properties notebook, open the IP Settings page.
6.
Clear
the Primary DNS server field and click OK or Apply.
Verify that
IBM Systems Director reports that all servers show an Access status of “OK”.
1.
Access
the IBM Systems Director logon by using one of the following methods:
By using the Information Archive administrative
interface:
a)
Log
on to the administrative interface.
b)
Expand
Information Archive Management in the navigation tree.
c)
Click
Service Tools.
d)
In
the IBM Systems Director section, click Open IBM Systems Director.
Tips:
·
If
you are prompted to restore the last session or start a new session because the
browser closed unexpectedly, click Start New Session.
·
If
the following message is returned, select Accept this certificate
temporarily for this session and click OK:
Website Certified by an Unknown Authority
·
If
the following error message is returned, ignore the error and click OK:
Security Error: Domain Mismatch
By using a direct connection:
a)
Open
an internet web browser.
b)
Enter
the following URL:
https://name_or_ip:8422/ibm/console
Where name_or_ip is the external host name or IP address of the
Information Archive management console server.
2.
Log
on with the iaadmin user ID and password.
3.
Select
the Navigate Resources link in the left navigator.
4.
Select
the All Systems group in the Navigate Resources panel.
5.
The
management console server, all cluster node servers and the RSM for Storage
server (Type: Operating System) should show an Access status of “OK”. If any of
these servers shows a status of Offline, a hardware warning is shown in the
Health Monitor window of the administrative interface.
If any servers show a status of Offline, run the following command from an
xterm session on the management console server for each server that is showing
offline:
ia_service.py -r director -c agent -a config -n
<server_name>
Where <server_name> is one of the following values:
iamconsole1
ianode1
ianode2
ianode3
iarsm1
This
command takes several minutes to execute. The command returns a message similar
to the following message on completion:
CTJIB1023I Command to config IBM Director
completed successfully.
Restore any
values in the RSM for Storage application that were changed before the software
upgrade.
If you changed the value in the IP address of SMTP server, or DIRECT field
before the upgrade on the Connection Information page, complete the following
steps:
1. Log back onto the RSM for Storage
application.
2. Change the value of the IP
address of SMTP server, or DIRECT field back to the original contents, and
save the configuration
Important:
The following steps only apply for a stand-alone appliance or a primary
appliance in an Enhanced Remote Mirroring environment. These steps do not apply
for the secondary appliance in a mirroring environment.
1.
Log
on to the Information Archive administrative interface with the iaadmin user ID
and password.
2.
Resume
all collections.
3.
Take
each cluster node out of maintenance mode.
4.
Open
an xterm prompt on the management console server and delete the directories
where the upgrade files were unzipped. For example:
rm -rf
/tmp/ia-2.1.1.0
The upgrade procedure is now complete.
To
troubleshoot any errors, see the IBM Information Archive Service Guide.
During the
upgrade to version 2.1.1, the Fibre Channel switch and Ethernet switch
configurations are updated, and the Fibre Channel switch firmware might be
updated and the switches restarted. The software might not switch a disk drive
back to the preferred path, which causes the 'Logical Drive Not On Preferred Path' error. This error can cause performance
issues and might prevent Fibre Channel switch firmware updates if the switch
detects the “Not on Preferred Path” error. Complete the following steps to
determine if the storage units have this condition:
1.
Log
on to the management console server with the iaadmin user ID and password.
2.
Open
the DS Storage Manager interface.
a)
Right-click
the desktop and click xterm.
b)
When
the xterm window opens, run the following command:
sudo SMclient
c)
If
a message is displayed that includes the text “unable to open display “:0.0”, complete the following steps:
i.
Start
an X Windows session by running the following command:
ssh –X iaadmin@iamconsole1
ii.
Run
the sudo SMclient command
again.
3.
When
the IBM System Storage DS Storage Manager window
opens, click the Devices tab.
4.
If
an X is listed for any of the storage controllers in the left pane, right-click
the X and select Manage Storage Subsystem.
Important:
If a
'Storage Subsystem Password Not Set' window opens, click No.
5.
At
the top of the 'iastoragex - IBM System Storage DS ES (Subsystem Management)'
window, click Storage Subsystem -> Recovery Guru.
6.
An
'iastoragex - Recovery Guru' page opens. Look under 'Summary' for the 'Logical
Drive Not On Preferred Path' errors.
7.
Repeat
step 4 to step 6 for each storage subsystem with an X, and make a note of which
subsystems show the error.
8.
If
any storage subsystems are listed with this problem, follow the steps in the
next section to troubleshoot the error.
Attention:
I/O errors can occur if the following procedure is not completed
correctly.
1.
After
you diagnose the error by using the steps in the section Verifying
that the storage logical drives are on the preferred path, close the 'Recovery Guru' and 'Subsystem Management' windows in the DS
Storage Manager interface.
Note:
Proceed with the following steps only if the 'Logical Drive Not On Preferred Path' error appears in the DS Storage Manager
interface for one or more storage subsystems.
2.
Verify
that both Fibre Channel switches are operational.
3.
Stop
all I/O activity on the affected storage subsystems.
4.
Log
onto the Information Archive administrative interface with the iscadmin user ID
and password.
5.
Click
Information Archive Management > System Management.
6.
Under
'Collections', suspend all collections that are associated with the affected
storage subsystems.
7.
Return
to the DS Storage Manager interface, select one of the affected disk storage
subsystems, right-click the subsystem, and select Manage Storage Subsystem.
Note:
If a 'Storage Subsystem Password Not Set' window opens, click No.
8.
At
the top of the 'Subsystem Management' window, click Advanced > Recovery
> Redistribute Logical Drives.
9.
When
the system prompts you, select OK. Note: A progress indicator is
shown as each logical drive is configured to the preferred path.
10.
Close
the 'Subsystem Management' window and repeat step 7 to step 9 for each affected
disk storage subsystem.
11.
After
the preferred-path errors are corrected on all of the affected disk storage subsystems,
close the DS Storage Manager interface.
12.
Resume
all collections that are suspended and begin I/O operations again.
13.
Close
all windows.
14.
Right-click
the desktop, click fluxbox menu > Exit.
http://www.ibm.com/legal/copytrade.shtml
Notices
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS
IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT
NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of
express or implied warranties in certain transactions, therefore, this
statement may not apply to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
IBM, the IBM logo, and ibm.com are trademarks of IBM Corp., registered in many
jurisdictions worldwide. Other product and service names might be trademarks of
IBM or other companies. A current list of IBM trademarks is available on the
web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml .
Other company, product, or service names may be trademarks or service marks of
others.
THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION
The license agreement for this product refers you to this file for details
concerning terms and conditions applicable to third party software code
included in this product, and for certain notices and other information IBM
must provide to you under its license to certain software code. The relevant
terms and conditions, notices and other information are provided or referenced
below. Please note that any non-English version of the licenses below is
unofficial and is provided to you for your convenience only. The English
version of the licenses below, provided as part of the English version of this
file, is the official version.
Notwithstanding the terms and conditions of any other agreement you may have
with IBM or any of its related or affiliated entities (collectively
"IBM"), the third party software code identified below are
"Excluded Components" and are subject to the following terms and
conditions:
·
The
Excluded Components are provided on an "AS IS" basis.
·
IBM
DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH
RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY
OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
·
IBM
will not be liable to you or indemnify you for any claims related to the
Excluded Components.
·
IBM
will not be liable for any direct, indirect, incidental, special, exemplary,
punitive or consequential damages with respect to the Excluded Components.
Last updated : 03 June 2011
Original publication: 03 June
2011