IBM Support

Download the ISALite for InfoSphere Information Server tool

Downloadable files


Abstract

The tool provides automatic data collection, diagnostic testing, symptom analysis, and pre-requisite checking for IBM InfoSphere Information Server installations.

Download Description

The IBM Support Assistant Lite for InfoSphere Information Server supports installations of:

  • InfoSphere Information Server, Version 11.3.x through Version 11.5.x on
      • AIX, Solaris, Linux (Red Hat, SUSE), and Windows.
  • InfoSphere Information Server, Version 8.5.x through Version 9.1.x on
      • AIX, Solaris, HP-UX, Linux (Red Hat, SUSE), and Windows.
  • InfoSphere Information Server, Version 8.5.x through Version 9.1.x on
      • Linux for IBM System z platforms.

In particular:
  • Use Version S11.5.0.2-B to support installations of InfoSphere Information Server Versions 11.3.x through 11.5.x.
  • Use Version S9.1.007.7 (also known as Version 7.7) to support installations of InfoSphere Information Server Versions 8.5.x through 9.1.x.
  • Use Version S9.1.007.4z (also known as Version 7.4z) to support installations of InfoSphere Information Server Version 8.5.x through 9.1.x on zLinux systems (IBM System z platforms).

The tool benefits customers by:
  • Providing diagnostic testing and health verifications of installations of any tiers of InfoSphere Information Server and its components
  • Providing automatic gathering and collection of diagnostic data and log files and FTP to IBM Customer Support
  • Graphically documenting the installation topology and highlighting communication channels
  • Performing symptom analysis and log analysis to help streamline the problem determination process
  • Validating the prerequisites of the installation
  • Repairing or removing broken InfoSphere DataStage projects

IBM Support Assistant Lite collects data transparently. All collected data and HTML analysis reports are available in a .zip file local to your disk, for your inspection. Use the tool to automatically FTP the zip files to IBM Customer Support, if your IBM Customer Support representative requests further analysis and diagnostics.



Where to install and run the tool:

Install the tool on any of the tiers of InfoSphere Information Server (Engine, Services, Repository or Client). The tool analyzes and collects artifacts from the InfoSphere Information Server installation on the local machine where the tool is running. Not all tasks and functions of the tool can run on all the tiers.

Install the tool on a system without an installation of InfoSphere Information Server to ensure that your (local) computer meets the system requirements, before an installation.
Check the User's Guide document attached below for more details on the installation procedure.

You can run the tool in either GUI windows mode or in console mode, on either Windows or UNIX systems. You need a X-Windows installation in order to run the GUI windows mode in UNIX.



What's new in Version S11.5.0.2-B (Release: 18-SEP-2017):

The following APAR and internal fixes are included in version S11.5.0.2-B:
  • 270875 HC: Add help link to Technote in DS test for files under &PH& folder
  • 267922 HC: Verify and report the configuration of WAS protocols SSL_TLS, TLSv2, etc
  • 267923 HC: Report the Initial and Max heap size for the WAS JVM process
  • 267924 HC: provide better formatting of URL links in HTML report, so that links can be clicked
  • 267984 HC: make sure file with credentials is removed after HC completion (even if in error)
  • 268009 HC: Include support of IGC rollup_RU25_IGC_* and others in IS 11.3.x IGC tests
  • 267806 HC: UVTEMP variable is not recognized by DS test when smat shows it with a '*'
  • 271477 HC: DS health check should check additional files for user ownership and access attributes and other fixes
  • 271160 HC: WAS test to list WAS profile JDK versions should report location of WAS JDKs
  • 269208 HC: Verify Security level of JDK in /security/local_policy.jar and US_export_policy.jar from IIS and WAS folders
  • 269215 Collector: apply date-filter to collection of \Server\DSODB\logs and \Server\DSWLM\logs files, as too many files are gathered
  • 267921 Collector: gather iis.client.site.properties and ssl.client.props from ASBServer/conf directory


Hide details for Fixes from previous versions S11.5.0.2, S11.5.0.11-G, and S11.5.0.1-E Fixes from previous versions S11.5.0.2, S11.5.0.11-G, and S11.5.0.1-E
  • 266655 HC: In QualityStage tests, add URL to documentation to help in configuration
  • 266007 HC: IMAM test on system tables should return the count() from SQL query
  • 265171 HC: Need new QualityStage diagnostic tests to verify SRDB and ESDB
  • 263834 HC: new test to verify connection of all IMAM connectors/bridges
  • 261512 HC: Create log with output of the "istools event listEvents" command
  • 265196 Collector: add new IGC log file error.log and new igc*.log to collection
  • 256806 Collector: ISCollector ZIP contains FileList.HeapDumpFiles.txt that lists unnecessary snap* files
  • 264322 SYSTEM SUMMARY shows USAC & QSAVI as installed products with no description
  • 264659 SYSTEM SUMMARY always shows IIS Java JDK to be at 1.6 level
  • 264421 SYSTEM SUMMARY test of presence of multiple WAS clusters is not applicable any more - remove
  • 262546 Prereq Check: 11.5.0.1 Prereq raises warning when WAS is at the bundled level of 8.5.5.5
  • 265424 PreReq Check: Update the ISoracle.jar to latest 11.5.0.2 version
  • 266475 DOC: user's Guide wrongly indicates that the Unbalanced reference Probe has the FIX option. Change to Abandoned Ref
  • 262823 HC: New test to verify creation and message transfer producer-to-consumer in Kafka
  • 263360 HC: The check for Solr collections should verify the Status data field ="healthy" for failure or success
  • 245432 HC: ReportingAdmin and others hung the HC because user needed to have run UpdateSignerCerts - HC Command timeout required
  • 262619 HC: in DS tests, add verification of the dsadm user read/write/execute permissions to folders UVTEMP et others
  • 262369 HC: DS new test to verify # of files in TMPDIR + /tmp and give warning if more than 7500 files
  • 262370 HC: Verify Server/DSEngine and Server/DSEngine/bin for orbtrc/javacore/heapdump files
  • 262362 HC: on 11.3.x IGC test fails if IGC RUP23 or RUP24 patch is installed
  • 261511 HC: Verify If any existing IA thin client data sets are indexed or not
  • 261510 HC: Verify and report the status/configuration of SOLR
  • 261509 HC: Verify the status/configuration of Zookeeper
  • 261546 HC: Verify SOLR collection (index) "da-datasets" and "dqecExceptionSets" created and operational
  • 261508 HC: Add verification and status of KAFKA+ SOLR + ZOOKEEPER services
  • 261549 HC: new IGC test to report the IGC config properties in the IS registry
  • 261986 IS-Collector: Add collection of files/logs for Kafka, Solr and Zookeeper
  • 261544 XMeta Diagnostic: allow in the UI the user choice of the JVM memory max heap size to avoid OOM
  • 261413 XMeta Diagnostic should allow the selection of which diagnostic probes to run
  • 262312 User Guide doc/PDF needs updates as per new changes provided in ver E

What's new in Version S9.1.007.7 (Release B - 1/15/2016):

Hide details for The following APAR and internal fixes are included in version S9.1.007.7 Release B:The following APAR and internal fixes are included in version S9.1.007.7 Release B:
  • APAR JR54719 Upgrade Apache Common Collections libraries to Vers 3.2.2
The following internal work item fixes are also included, as part of previous version S9.1.007.7:
  • WI 243619 HC: New HC test to report file listing/existence/permissions/user ownership of certain IS and OS files
  • WI 243548 HC additional test: Give warning if Oracle DB version is less than 11.2.0.2
  • WI 243582 HC: DB Configuration test shoud not report Warning when DB config values are set to AUTOMATIC
  • WI 231145 XMeta HC: Update the XMeta diagnostic engine for 9.1 and additional files to collect
  • WI 198908 Change the permissions of ZIP file created to r--r--r-- (Read-for all)
  • WI 152579 HC: Invalid msg given when IA database cannot be accessed. Metadata repository is mentioned instead
  • WI 243258 HC: Business Glossary is reported as not installed when WAS credentials provided are wrong
  • WI 227419 HC: Connector object test should not use case-sensitivity in DSNameSpace = hostname test
  • WI 239498 HC: Test results to verify agent port in use is unclear in Agent test group
  • WI 209374 Collector: Need to collect database.properties is in ASBServer/bin/sql
  • WI 208073 Collector: Add WAS workbench files to collection (IS 8.5-9.1.x)
  • WI 206109 Collector fails trying to collect ASBNode\bin when it does not exist on Services-tier only (IS 8.5-9.1 with FixPacks)




Functionality of the tool (Version S11.5.0.2) :

There are 22 menu options in the ISALite for Information Server tool menu, divided in 6 sub-menus. Some tasks and the Symptom Analysis menu have been removed, compared to the previous S9.1.007.7 version, but functionality is retained by the other tasks, with some enhancements.
Refer to the Functionality of the tool (Version S9.1.007.7) below for general details on the tasks, or check the User's Guide for version S11.5.0.2 attached below.

Functionality of the tool (Version S9.1.007.7) :

There are 25 menu options in the ISALite for Information Server tool menu, divided in 7 sub-menus.
Note that the tool for zLinux platforms has a reduced set of menu items and functionality. Check the User's Guide for zLinux document attached below for more details on the functionality available on that platform. Previous versions of the tool available for download may also offer slightly different menu items and functionality.

Common Functionality of the tool :

Depending on the diagnostic activity you need to do, invoke one or more of the options, as follows:

  1. Data Collection Options (Main menu): the top of the main menu has links to the recommended and most used tasks: the General Diagnostic Health Checker, the Information Server Collector, and the DataStage Job Logs Collector.
    The General Diagnostic Health Checker is the most comprehensive tool as it performs about 90 tests and verifications across all the tiers and Information Server components found on the local system. Run the General Diagnostic Health Checker in any situation, primarily on the Services and Engine tier machines, as it gives you a snapshot of the current health of the system.
    The InfoSphere Information Server Collector is comprehensive, and collects all Information Server logs and support files, including all the important WebSphere Application Server log and configuration files.
    The InfoSphere DataStage Job Logs Collector gathers debugging data, logs, FFDC logs, and additional information useful to debug DataStage jobs runs and environment.



  2. Additional Collectors: the collection tasks do not perform any diagnostic tests, they only collect files, log events, and configuration data. Use the collectors when you have a problem you need to debug and you need the support of log files and configuration data to debug the situation. If you know the problem is within a specific component (DB2, SAP, etc.) you may want to run that specific collector.
    If you have a clustered installation of IBM WebSphere Application Server, you can use the Collection of remote cluster nodes options to collect artifacts and logs when running the ISALite for InfoSphere Information Server tool on a machine hosting the remote cluster node.

    Note: the Basic System Summary report is created and included by any of the ISALite menu options, so you do not need to run the System Summary by itself if you already run some other ISA Lite task, as all the other tasks already include that report. The System Summary does not perform any diagnostic tests. It only reports what it finds installed.



  3. Additional Diagnostic Tools: use the diagnostic tools to find out about the health of the system or a specific InfoSphere Information Server component. They perform tests and configuration verifications, and report issues found. No log files or log events are collected by the diagnostic tools. Use the Collectors to gather those.



  4. Symptom Analysis: Provides the possibility to analyze logs from the WebSphere and Information Server installation and reports known errors and issues that may have occurred. A second option allows you to specify and provide a log file from an InfoSphere DataStage Job run, which is analyzed for errors. Known symptoms are reported with indications and links to documents that help fix the problem



  5. System Requirements: Provides the invocation of the prerequisite checkers. Invoke these tools before an installation of InfoSphere Information Server (11.3, 11.5), or before an upgrade of Information Server 11.3 to 11.5, to ensure that your (local) computer meets the system requirements. You can select the tiers and Information Server components to verify for prerequisites.
    Note: these prerequisite checkers are the same tools invoked by the InfoSphere Information Server Installer, Versions 11.5.



  6. Utilities: This utility lets you view issues and attempts to repair a corrupt DataStage project.



  7. Help: Includes quick links to the About-Box and Help contents for the tool




Use the tool in different situations:
  • Prior to a fresh installation:
    • Analyze system requirement using the Pre-requisite checkers under the System Requirements menu
  • For problem determination:
    • Use the General Diagnostics Health Checker and other health checkers tools under the top menu and Additional Diagnostic Tools menu
    • For analysis: collect and gather log files, log events and data, using the Collectors
    • Analyze log files using the Symptom Analysis tools
  • Prior to migrating from InfoSphere Information Server:
    • Verify the installation using the General Diagnostic Health Checker under the main menu.
    • Run other health checkers under the Additional Diagnostic Tools menu for specific InfoSphere Information Server components, if you have issues with those components.
    • Invoke the Collectors if you have issues to resolve and you need logs and other data for analysis
  • Prior to and after an append or a patch installation, or after a fresh installation:
    • Verify the installation using the General Diagnostic Health Checker under the main menu.

Note: An alternative to the automated data collection is a manual method which utilizes a MustGather document. Please refer to the following document for details on gathering this same data manually. http://www.ibm.com/support/docview.wss?rs=14&uid=swg21383312

Please contact your IBM Support representative for any assistance required.



User's Guide :

The User's Guide is included in the download package (under the ISALite\doc folder) and is also included here for convenience.
  • User's Guide (version S11.5.0.2): UserGuide.pdfUserGuide.pdf (Windows and UNIX platforms)
  • User's Guide (version S9.1.007.7): UserGuide.pdfUserGuide.pdf (Windows and UNIX platforms)
  • User's Guide for zLinux platforms: UserGuide.pdfUserGuide.pdf (zLinux platform only)

Prerequisites

Supports:

    • InfoSphere Information Server: Versions 8.5.x through Version 11.5.x.
    • Operating systems: AIX, Solaris, Linux (RedHat and Suse), HP-UX, Windows, and Linux on IBM System z platform, where the InfoSphere Information Server product is supported.
    • InfoSphere Information Server Versions 8.5 though Version 9.1.x is supported on zLinux systems.
    • Collectors and prerequisite checkers support DB2 and Oracle databases only.

Installation Instructions

This is a complete replacement for previously installed versions of the tool. Consult the User's Guide for information on how to verify the version currently installed, replace an older version, or download and install a new version and getting started and using the tool.

Note: You must have an IBM ID and password to download the packages. Register here if you do not have an IBM ID and password. Click the following link to go to the ISA Home Page. http://www.ibm.com/software/support/isa.


Download package



Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
ISALite 11 for InfoServer v. 11.3 - 11.5 18 Sep 2017 English 25605057 HTTPS
ISALite 7.7 for InfoServer v. 8.5 - 9.1 15 Jan 2016 English 36780697 HTTPS
ISALite 7.4z for InfoServer v. 8.1 - 9.1: zLinux 28 Mar 2013 English 33101156 HTTPS

Cross reference information
Segment Product Component Platform Version Edition
Information Management InfoSphere Information Server 9.1.2.0, 9.1.0.1, 9.1, 8.7.0.2, 8.7.0.1, 8.7, 8.5.0.3, 8.5.0.2, 8.5.0.1, 8.5, 11.5.0.2, 11.5.0.1, 11.5, 11.3.1.2, 11.3.1.1, 11.3.1.0, 11.3
Information Management InfoSphere DataStage 9.1.2.0, 9.1.0.1, 9.1, 8.7.0.2, 8.7.0.1, 8.7, 8.5.0.3, 8.5.0.2, 8.5.0.1, 8.5, 11.5, 11.3.1.2, 11.3.1.1, 11.3.1.0, 11.3, 11.5.0.1, 11.5.0.2
Information Management InfoSphere Business Glossary 9.1.0.1, 9.1, 8.7.0.2, 8.7.0.1, 8.7, 8.5.0.3, 8.5.0.2, 8.5.0.1, 8.5, 11.3
Information Management InfoSphere FastTrack 11.3, 11.3.1.0, 8.5, 8.5.0.1, 8.5.0.2, 8.5.0.3, 8.7, 8.7.0.1, 9.1, 9.1.0.1
Information Management InfoSphere Information Analyzer 11.3, 11.3.1.0, 11.3.1.1, 11.3.1.2, 11.5, 8.5, 8.5.0.1, 8.5.0.2, 8.5.0.3, 8.7, 8.7.0.1, 8.7.0.2, 9.1, 9.1.0.1, 9.1.2.0, 11.5.0.1, 11.5.0.2
Information Management InfoSphere Information Services Director 9.1.0.1, 9.1, 8.7.0.1, 8.7, 8.5.0.2, 8.5.0.1, 8.5, 11.3, 11.3.1, 11.5, 11.5.0.1
Information Management InfoSphere Metadata Workbench 9.1.2.0, 9.1.0.1, 9.1, 8.7.0.1, 8.7, 8.5.0.3, 8.5.0.2, 8.5.0.1, 8.5, 11.3
Information Management InfoSphere QualityStage 9.1.2.0, 9.1.0.1, 9.1, 8.7.0.1, 8.7, 8.5.0.3, 8.5.0.2, 8.5.0.1, 8.5, 11.3.1.2, 11.3.1.1, 11.3, 11.5, 11.5.0.1, 11.5.0.2


Document information

More support for: InfoSphere Information Server

Software version: 8.5, 8.5.0.1, 8.5.0.2, 8.5.0.3, 8.7, 8.7.0.1, 8.7.0.2, 9.1, 9.1.0.1, 9.1.2.0, 11.3, 11.3.1.0, 11.3.1.1, 11.3.1.2, 11.5, 11.5.0.1, 11.5.0.2

Operating system(s): AIX, HP-UX, Linux, Solaris, Windows

Reference #: 4022700

Modified date: 18 September 2017


Translate this page: