IBM Information Archive Version 2.1.0.1.efix_2 Readme
Readme file for: IBM® Information Archive®
Product/Component Release: 2.1.0.1.efix_2
Update Name: Not applicable
Fix ID: ia-2.1.0.1.efix_2_upgrade
Publication Date: 13 May 2011
Last modified date: 13 May 2011
Considerations
for Enhanced Remote Mirroring
Downloading
the upgrade package
Completing
necessary tasks after upgrade
Information
Archive Administrative interface
Known
problems and workarounds
Copyright
and trademark information
Before you start the Information Archive 2.1 upgrade, complete the following steps:
1) 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)
Enter the following command at the xterm window of the management console::
ia_service.py -r verify -c hardware
d)
Wait 10 minutes for the command to complete and
review the command output in the following file:
/opt/tivoli/tiam/log/verify_wellness.datestamp
e) Depending on the command output, take one of the following actions:
i)
The system has passed the wellness verification:
The installation of the hardware component is successful. Continue with this
upgrade procedure.
ii)
Failed: The system did not pass wellness verification!:
Contact the next level of support.
2) Current IA version: Ensure that your appliance is running Information Archive version 2.1.0.1. To view the appliance code level:
a) Log onto 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 shows the code version. Write down this version number for use in later sections of this upgrade readme.
3) Initial
Configuration Wizard (ICW): The ICW
must have been run before you can upgrade the appliance. For instructions, see
the Installing and Configuring IBM
Information Archive publication. To check whether you need to run the ICW,
complete the following steps in the Information Archive administrative interface:
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.
If you
configure the appliance for file archive collections, you might see the
following message in the ICW:
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 this technote in case additional details have been added to it since this README
was published:
https://www-304.ibm.com/support/docview.wss?uid=swg21470833
4)
Domain name and Primary Domain Name Server (DNS)
fields:
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.
d)
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.
e)
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.
f) If
you changed the Domain name or Primary DNS Server fields, click OK or Apply to save the changes.
The following message might be shown:
CTJIM1000E: An unidentified error occurred: ‘the
host name, iarsm1 was not found in /etc/hosts ‘.
If this message is shown, click OK or Apply again to save the
configuration changes.
This information is also described in IBM
Technote 1444585.
Review this technote in case additional
details have been added to it 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
Ensure that values are configured correctly in the Connection
Information page:
1) To verify or add these values, log on to the RSM for Storage GUI in one of the following ways:
a) 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) Using a direct connection:
i) Access the IBM Information Archive keyboard video mouse (KVM) console.
ii) Press the PrtSc key 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.
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”.
i)
If the value of the field is “DIRECT” continue
to the “Remote Access Connections” step.
ii) If
the field contains an IP address, verify that the IP address can be
successfully pinged. For example:
(1) Open
a Konsole session
(2) 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:
iarsm1:~ # ping –c 2 9.12.34.567
If the ping command is successful, it will include two lines that
look similar to this:
64 bytes
from <IP_address>: icmp_seq=1 ttl=126 time=0.354 ms
If the ping command is not successful, it might include a “Destination
Host Unreachable”, “100% packet loss”, or “unknown host” message:
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 contents to: DIRECT
d) Remote
Access Connections:
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 has been 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.
e) If you modified the contents
of any field in the Connection Information window, click the Update Configuration button at the
bottom of the Connection Information page
None
If you are using 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 file for the software upgrade:
1)
Open the IBM support website:
http://www.ibm.com/systems/support/storage/disk/InformationArchive
2) Download
the following compressed file from the IBM support website:
ia-2.1.0.1.efix_2_upgrade.zip
3) Verify the download by checking the MD5 sum of the compressed file against the value in the md5sum.txt file.
4) Burn the upgrade file to a DVD or transfer it 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 during the upgrade. The software upgrade takes up to an hour to complete.
2) Transfer the upgrade package to the management console server in the appliance 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 sum of the compressed file against the value in the md5sum.txt file.
b) Extract
the contents of the upgrade package to the / tmp directory. You must be logged
on with the iaadmin user ID to extract the files. For
example:
iaadmin@iamconsole1:/tmp>
unzip ia-2.1.0.1.efix_2_upgrade.zip
c)
If no collections have been created, turn off
all tracing by using the ia_service.py command on the management console
server. For example:
iaadmin@iamconsole1:/tmp>
/opt/ tivoli/tiam/bin/ia_service.py -r
trace -c gpfs -l disable
If any collections exist, skip this step.
To start the upgrade, run 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:
iaadmin@iamconsole1:~>
cd /tmp/ia-2.1.0.1.efix_2
2) Run the iaupgrade.sh script from this
directory. For example:
iaadmin@iamconsole1:/tmp/ia-2.1.0.1.efix_2>
/opt/tivoli/tiam/bin/iaupgrade.sh
3) When prompted, enter the iscadmin password.
4) You
will be prompted to continue the upgrade. If any warnings are shown during the
prerequisite check, consider resolving these issues before you proceed. When
you are ready to proceed , type "Y"
and press Enter.
Tips:
· If a message is shown that says 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 the upgrade by repeating step 2.
5)
When the upgrade is complete, the following
message is shown:
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. For example:
iaadmin@iamconsole1:~>
iaversion
d) Ensure
that the correct version number is shown in the command output: 2.1.0.1.efix_2
After the software upgrade and firmware update are installed, you must complete several actions on different components in the appliance after 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, it must be
cleared before resuming collections.
Complete the following steps to clear the DNS server value:
Important:
You only
need to clear the DNS value if you
modified the DNS setting before the 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 Information Archive 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 System Director reports
that all servers show an Access status of “OK”. Access the IBM Systems Director
logon by using one of the following methods:
1) Using the 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:
i)
If you are prompted to restore the last session
or start a new session because the browser closed unexpectedly, click Start
New Session.
ii)
If the following message is shown, select Accept this certificate temporarily for this
session and click OK:
Website Certified by an Unknown Authority
iii)
If the following error message is returned,
ignore the error and click OK:
Security Error: Domain Mismatch
2)
Using
a direct connection:
i) Open a web browser.
ii)
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.
3)
Log on using the iaadmin user ID and password.
4)
Select the Navigate
Resources link in the left navigator
5)
Select the All Systems
group in the Navigate Resources panel
6)
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, this will cause a hardware
warning to be shown in the Information Archive administrative interface’s
Health Monitor window.
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:
iaadmin@iamconsole1:~> ia_service.py -r director -c agent -a config -n <server_name>
where <server_name> is one of:
iamconsole1
ianode1
ianode2
ianode3
iarsm1
Note that this command takes a couple of minutes to finish running and will
display a message similar to this when it completes:
CTJIB1023I Command to config IBM Director
completed successfully.
Restore any values in the RSM for Storage
application that were changed before the upgrade:
If you changed the “IP address
of SMTP server, or DIRECT” before the upgrade on the RSM for Storage
application’s Connection information page:
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 its original contents, and save the
configuration
1. 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
a) Log on to the Information Archive administrative interface
b) Resume all collections.
c) Take each cluster node out of maintenance mode.
2)
Open an xterm prompt on the management console server
and delete the directories where the upgrade files were unzipped. For example:
iaadmin@iamconsole1:~> rm - rf /tmp/ia-2.1.0.1.efix_2
3)
Run the verify_wellness
command from an xterm prompt on the management console server. For example:
iaadmin@iamconsole1:~> verify_wellness
To troubleshoot any errors, see the IBM Information Archive
Service Guide.
There are no additional known problems or workarounds.
This
upgrade does not include any APAR fixes. It includes the following code fixes:
18386/18534/18556/18313:
Modified the default index divisor setting to reduce the number of indexed
words that are stored in memory at startup.
18594:
Resolved an issue that caused the indexing process to intermittently time out
and fail when indexing documents in an existing collection.
18632:
Enabled IBM Remote Support Manager for Storage call-home support for the DS3950
and EXP395 disk storage components.
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 : 13 May 2011
Original
publication: 13 May 2011