IBM Support

IBM Pre-Upgrade Verification Tool for IBM i

Troubleshooting


Problem

This document describes the IBM pre-upgrade verification tool and provides the link to download it.

Resolving The Problem

The IBM pre-upgrade verification tool for IBM i was developed to help ensure a successful upgrade. The tool ensures that the required pre-upgrade steps have been successfully completed and flags the steps that were missed or completed incorrectly. The person performing the upgrade then has the opportunity to successfully complete the required steps. The tool does not automatically perform the corrective actions.

Notes:
1. The PRUV tool is capable of running on both unsupported releases (as low as V5R2M0) up to the current supported releases.
2. This tool is provided "as is" and on an unsupported basis. It is the customer's responsibility to install the tool. If there are usage issues with the PRUV tool itself, do not contact IBM technical support. Instead, you should use the feedback button for your comments or questions.

Installing the Tool
To install the tool, you should do the following:

1. Download the tool to your Windows platform from:

https://www-01.ibm.com/marketing/iwm/iwm/web/dispatcher.do?source=ipvt
2. Extract the pruv_x.x.x.xxxxxxxx.exe file.
3. Double-click on run_pruv.bat
Important Note: The IBM pre-upgrade verification tool for IBM i is an as is and is not supported by IBM. The tool runs on a Microsoft Windows-based client. General requirements for the tool include the following:
o IBM i (i5/OS, OS/400)
o 57xxSS1 Option 12
o Windows client
o Java 1.5 or higher (included with tool)


Below is a screenshot of the PRUV tool after the items have been checked:

Screenshot after items have been checked


Check descriptions
The pre-upgrade verification tool has the ability to check the following items:

Allocate LIC Space
Checks to make sure that the additional licensed internal code space has been properly allocated for the target release.

Disk capacity
Checks to make sure there is enough System ASP available to upgrade to the target release.

Analyze Object Conversion PTFs
Checks to make sure that the ANZOBJCVN PTFs are applied to the system and if the command has been run. (Check is only if target system is V6R1M0 or above)

Acceptance of software agreements
Checks to make sure that the software agreements have been restored and accepted.

Damaged system profiles
Ensures that the QSECOFR, QLPINSTALL, and the user profile running the tool are not damaged.

Required PTFs
Checks to make sure that the Prepare for Install PTFs are applied on the system. It also checks if the latest
supersedes are applied. Additional PTFs are checked if Virtual Media Install (Image Catalog) and/or Central Site Distribution (DSLO) advanced install options were previously selected.

Library lists
Verifies that only QSYS, QUSRSYS, and QSYS2 are in the System library list and no libraries are above QSYS.
Verifies that QGPL and QTEMP are in the User library list.

System values
QALWOBJRST = *ALL
QVFYOBJRST = 3 or less

Database cross reference files
Checks to make sure that the Database cross-reference files are not in *ERROR. (Tool is only capable of running this check if source system is V5R4M0 or higher)

External Storage
Checks for type 2107 (DS8000) external hard drives. If exist, then flag to upgrade DS8000 to compatible firmware. (Dependent on Target release)

System Firmware level
Checks the system firmware level to ensure that it is compatible with the target release (Check is only available if the source system is V5R4M0 or above)

Hardware Model
Determines if the current type and model of the server will be supported at the selected target release (Check is only available if the source system is V5R4M0 or above)

Licensed Programs
Checks the currently installed licensed programs and determines if they are supported on the target release

RIO/HSL Loop and IOP based hardware
Checks for RIO/HSL and IOP based hardware which is not supported at IBM i 7.2 and above.

IBM libraries not in ASP 1
Ensures that there are not any IBM libraries in basic user ASPs that may conflict with the upgrade.

Duplicate files in IBM libraries
Checks QSYS2 and QUSRSYS for "duplicate" or "extension" files. Example, QALZAL0001.

Active Domino servers
Checks to see if there are Domino servers present and, if so, are they varied off.

Performance data collected
Checks if performance data is set to be collected for 7 or more days.

Cluster environment
Checks to see if the server is part of a cluster points the user to review the cluster Web site.

System i Access for Windows compatibility
Makes sure that the client access connections are compatible with the target release

Active integrated servers
Checks to make sure that there aren't any integrated servers varied on.

PTFs Permanently applied
Suggests to permanently apply all Licensed Internal Code PTFs.

Tool Recommended Actions
After the selected items have been checked, the user can review the status and recommended actions:

Screenshot of status and recommendations

After clicking the Next button, if you previously selected to Collect Historical data, you may now choose the items to collect, similar to the screen below:

Screenshot of Collect Historical Data

Historical Data Collection
Select which data should be collected and stored in the QPRUV library:
o BRMS recovery report
o System Values
o SQL Plan Cache
o PTF Information
o Hardware Information

After clicking Finish, the output is generated in an HTML document that can be reviewed and printed.


Pre-Upgrade Verification Tool Video
In this video, Brian Bohner introduces the Pre-Upgrade Verification Tool:

The Pre-Upgrade Verification Tool

In this video Brian Bohner introduces the Pre-Upgrade Verification Tool.



Documented tool updates
pruv_7.4.0.20190625
(June 25, 2019)

  • 7.4 version made available to public
     

pruv_7.4.0.20190529 (May 29, 2019)

pruv_7.3.0.20180410 (April 10, 2019)

pruv_7.3.0.20181023 (October, 23, 2018)

pruv_7.3.0.20180912 (September 12, 2018)

pruv_7.3.0.20180622 (June 22, 2018)

pruv_7.3.0.20180604 (June 4th, 2018)

pruv_7.3.0.20170510 (May 10th, 2017)

  • - Tool installation and java correct/updated
    - Required PTFs check updated
    - Hardware model check updated
    - Multiple systems data collection enhanced
    - Structures for future enhancements


pruv_7.3.0.20160413 (April 13th, 2016)

  • - Target release IBM i 7.3.0 added
    - Required PTFs check updated
    - Firmware level check updated
    - Hardware model check updated
    - Licensed Programs check updated


pruv_7.2.0.20151216 (December 16th, 2015)

  • - Duplicate files check enhanced to be language independent
    - Fixed hang issue when collecting PTF information
    - Hardware model check updated with additional models
    - Required PTFs check updated


pruv_7.2.0.20150828 (August 28th, 2015)

  • - Java error issue fixed
    - Required PTFs check updated


pruv_7.2.0.20150312 (March 12th, 2015)

  • - HSL/RIO check added
    - Required PTFs check updated
    - Hardware model check updated
    - Supported IOP hardware check enhanced
    - Added RTVSYSINF option in Historical data collection


pruv_7.2.0.20140512 (May 12th, 2014)

  • - Target release IBM i 7.2.0 added
    - Allocate LIC Space check updated
    - Required PTFs check updated
    - Firmware level check updated
    - Hardware model check updated
    - Licensed Programs check updated
    - Supported IOP hardware check added
    - IBM i Access for Windows version check updated


pruv_7.1.0.20131211 (December 11th, 2013)

  • - Multiple systems supported to run simultaneously
    - Required PTFs check updated
    - JV1 7.1 licensed program check corrected (5761JV1 at 7.1 and not 5770JV1)
    - Updated packaged Java with PRUV tool
    - Minor updates to interface usability

pruv_7.1.0.20120220 (February 20th, 2012)

  • - Licensed Programs check added
    - Feedback button added
    - Major updates to PTFs
    - Hyperlink capabilities
    - Text/HTML updates
    - Window is now sizeable


pruv_7.1.0.20101202 (December 2nd, 2010)

  • - Fixed minor bug in system firmware check


pruv_7.1.0.20101119 (October 19th, 2010)

  • - System Firmware check added
    - Hardware Model check added
    - External Storage check updated


pruv_7.1.0.20100805 (August 5th, 2010)

  • - Minor changes to documentation and messages


pruv_7.1.0.20100603 (June 3rd, 2010)

  • - Historical Data Collection added


pruv_1.07.0821 (August 18, 2007)

  • - IBM pre-upgrade verification tool created


For feedback on desired enhancements and tool usefulness, you should e-mail pruv@us.ibm.com.

Note: This tool is provided at no additional charge, so we would like to receive as much feedback as possible because it will be used for tool improvements as well as the justification for the continued updates, enhancements, and future existence.

Internal Use Only

I5/OS 5761SS1IN

IBM i 5770SS1IN

[{"Product":{"code":"SGYQGH","label":"IBM i"},"Business Unit":{"code":"BU009","label":"Systems - Server"},"Component":"Save/Restore","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.3;7.2.0;7.2;7.1.0;7.1;6.1.1;6.1.0;6.1;5.4.5;5.4.0;5.3.5;5.3.0;5.2.0","Edition":""},{"Product":{"code":"SSC5L9","label":"IBM i 7.2"},"Business Unit":{"code":"BU009","label":"Systems - Server"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":""},{"Product":{"code":"SSC52E","label":"IBM i 7.1"},"Business Unit":{"code":"BU009","label":"Systems - Server"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":""},{"Product":{"code":"SSC3X7","label":"IBM i 6.1"},"Business Unit":{"code":"BU009","label":"Systems - Server"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":""},{"Product":{"code":"SSTS2D","label":"IBM i 7.3"},"Business Unit":{"code":"BU009","label":"Systems - Server"},"Component":" ","Platform":[{"code":"","label":null}],"Version":"","Edition":""},{"Business Unit":{"code":"BU009","label":"Systems - Server"},"Product":{"code":"SS9QQS","label":"IBM i 7.4"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions","Edition":""}]

Historical Number

465353483

Document Information

Modified date:
27 August 2019

UID

nas8N1014074