Applying Patch Update to q-Status™

Updated 25 September 2006
© 2006 Logiqwest, Inc. All rights reserved

Applying Patch Update to q-Status™

Description:

This procedures describes how to apply a maintenance patch update to q-Status™ Solaris.

Prerequisites:

Must be root.
Must have an installed a valid and applicatable version of q-Status™ Solaris for the upgrade. See "Identifying q-Status™ Version and Update".
Must have downloaded an applicable q-Status™ Solaris Update Release from the LogiQwest software maintenance site. Contact LogiQwest (http://www.logiqwest.com) to obtain location, user id and password.

Notes:

Applying a q-Status™ Solaris patch update will not affect any parameter file changes or data being used by the q-Status™ program. It will overwrite the existing patchdiag.xref file in the q-statusSolaris/conf/ directory and the LQWq-Status.pkg and q-StatusStandaloneExtraction.tar.gz files located in the q-statusSolaris/Goodies/ directory.
A new LQWq-Status.pkg and q-StatusStandaloneExtraction.tar.gz file is always delivered with a new a q-Status™ Solaris patch update and will overwrite any existing version located in the q-statusSolaris/Goodies/ directory. If the client has created extra collection scripts or change parameters, they must recreate these files using the scripts in the q-statusSolaris/Goodies/pkg_WorkArea directory. See "Creating a q-Status™ Package Add Module" and "Creating a q-Status™ Standalone Extraction Tar-Gzip file".
q-Status™ Patch Updates are delivered with a new version of the patchdiag.xref as of the date of its release. If the client is using a later or special version of the patchdiag.xref, the update process will overwrite this file located in the q-statusSolaris/conf/ directory. If the client wishes to save their installed version, it should be copied or duplicated to a saved names (e.g. patchdiag.xref.save). After the INSTALL script is run, simply replace the q-Status™ Patch Update version with the save version.
q-Status™ Solaris patch updates are applied to any base release version or an previous maintenance updated version. A base released is indentified by a version number such as Version 2.04. An updated version is indentified through the "About" dialog page access from any of the main GUI. See "Identifying q-Status™ Version and Update".
q-Status™ Solaris is initially issued as a base release version (e.g. 2.04). During the life cycle of a version, new releases are issued to the base release version maintaining the same base release version designation but with a Update number notation (e.g. Version 2.03 Update 5). A version release with an Update number notation not only implied that there an all encompassing full release, but there is also a maintenance patch release that can be applied to that base version with any previous Update number notation or base release that will update it to that new version without the need to replace the existing version with the new one.
As version without an Update number notation is called a base release.

Warning:

Never apply a previous q-Status™ Solaris patch update to a q-Status™ version.
There is no easy way to remove an installed patch.
Step Action Description

1 Download or obtain the
Update Patch

Obtain a maintenance update loging and userid. Contact information can be obtained from the "q-Status™ About" window accessed trhough any q-Status™ GUI.
Download load the appropriate update patch. Download is through a Web page and will be in the form:
"q-statusSolaris{base}Update{number}_patch.tar.gz"
where {base} is the base revision (e.g. 2.06) and {number} is the update number (e.g. 08).

Note:
You must be root to install the update.
2

Place Update patch on
q-Status™ Server
FTP or SCP the patch update to the q-Status™ web server and place it in the same directory as where the q-Status™ web program is located (e.g. /var/apache/htdocs).
qstatuswebserver# pwd
/var/apache/htdocs/
qstatuswebserver# ls
q-statusSolaris       q-statusSolaris2.04Update01_patch.tar.gz
qstatuswebserver# 
3

Untargzip patch
Un tar-gzip the patch.
qstatuswebserver# gunzip q-statusSolaris2.04Update01_patch.tar.gz
qstatuswebserver# ls
q-statusSolaris       q-statusSolaris2.04Update01_patch.tar
qstatuswebserver# tar xvfp q-statusSolaris2.04Update01_patch.tar
x INSTALL, 2256 bytes, 5 tape blocks
x README-Instructions, 5237 bytes, 11 tape blocks
x Update01_patch.tar, 2243072 bytes, 4381 tape blocks
qstatuswebserver# ls
INSTALL               Update01_patch.tar         q-statusSolaris2.04Update01_patch.tar
README-Instructions   q-statusSolaris 
qstatuswebserver# 									
This will create three files:

File Description

INSTALL - Install script

Update01_patch.tar - tar file of replacement code

README-Instructions - README instructions and description of patch.

Review the README-Instructions for any issues or deviations from the normal install procedures.
qstatuswebserver# view README-Instructions
"README-Instructions" [Read only] 118 lines, 5237 characters 
README q-Status Solaris 2.04 - Update 01
################################################################################
                   22 September 2006 Version 2.04 - Update 01
                #########################################################
                # This update is provided to clients who have purchased #
                # q-Status yearly software maintenance directly from    #
                # Logiqwest (http://www.logiqwest.com). Unauthorized    #
                # distribution and use is prohibited and is subject to  #
                # trade mark violations.                                #
                #########################################################
Introduction
------------
q-Status Solaris Version 2.04 Update 01 Release represents an evolution of
LogiQwest's q-Status technology. This new release incorporates javascript
objects which provide new sort and filtering capability with the local browser.
Additionally Network reporting has been enahnced to support zone data and IPV6
IP configuration information.What is in this Version
-----------------------
* New javascript objects sort fields in selection interfaces.
* New OS revision type filter drop down in Selection of multi hosts.
* Additional RAW data reports display.
* Enhanced compare engine for hardware, baseline hardware and baseline network
* comparisons.
* Patchdiag Summary report now includes number of patches. Sorting by percent
                 ...        ....      .....      .....     ..... .
                 ...        ....      .....      .....     ..... .
                 ...        ....      .....      .....     ..... .
4

Run INSTALL script
As root execture the q-Status™ patch update script called INSTALL. The INSTALL script looks for the q-StatusSolaris directory and verified that you have a base version or updated base version installed. If it does not find this directory or validated the correct version, the INSTALL script will exit. The script will prompt the user to continue. Enter a carriage return at any prompt will issue the default. At the end of the installation, the INSTALL script will removed itself as the default.
qstatuswebserver# ./INSTALL
====================================================================
q-Status Solaris 2.04 Update01 PATCH INSTALL Program
--------------------------------------------------------------------
This script must be run as root!
This file must be located in the same directory as where the
q-statusSolaris directory (e.g. /var/apache/htdocs) is located.
--------------------------------------------------------------------
Enter cariage return to continue or "Q" to quit:<cr>
NO QUIT
x q-statusSolaris, 0 bytes, 0 tape blocks
x q-statusSolaris/About.html, 2472 bytes, 5 tape blocks
x q-statusSolaris/Admin, 0 bytes, 0 tape blocks
x q-statusSolaris/Admin/CGI, 0 bytes, 0 tape blocks
x q-statusSolaris/Admin/CGI/goldenDelete.cgi, 3971 bytes, 8 tape blocks
x q-statusSolaris/Admin/index.html, 3335 bytes, 7 tape blocks
x q-statusSolaris/bin, 0 bytes, 0 tape blocks
x q-statusSolaris/bin/list.prtconf, 471 bytes, 1 tape blocks
x q-statusSolaris/bin/SSHget, 1400 bytes, 3 tape blocks
x q-statusSolaris/bin/SSHxfr, 1320 bytes, 3 tape blocks
x q-statusSolaris/CGI, 0 bytes, 0 tape blocks
x q-statusSolaris/CGI/disks.cgi, 9476 bytes, 19 tape blocks
x q-statusSolaris/CGI/qStatusGUI.cgi, 17700 bytes, 35 tape blocks
x q-statusSolaris/CGI/searchText.cgi, 15476 bytes, 31 tape blocks
x q-statusSolaris/CGI/sysinfo.cgi, 31624 bytes, 62 tape blocks
x q-statusSolaris/conf, 0 bytes, 0 tape blocks
x q-statusSolaris/conf/patchdiag.xref, 1846915 bytes, 3608 tape blocks
x q-statusSolaris/conf/selectHosts.tasks, 713 bytes, 2 tape blocks
x q-statusSolaris/Docs, 0 bytes, 0 tape blocks
x q-statusSolaris/Docs/qStatusInstallation.html, 15208 bytes, 30 tape blocks
x q-statusSolaris/Docs/SSHsetup.html, 32153 bytes, 63 tape blocks
x q-statusSolaris/Goodies, 0 bytes, 0 tape blocks
x q-statusSolaris/Goodies/LQWq-Status.pkg, 163328 bytes, 319 tape blocks
x q-statusSolaris/Goodies/pkg_WorkArea, 0 bytes, 0 tape blocks
x q-statusSolaris/Goodies/pkg_WorkArea/pkginfo, 265 bytes, 1 tape blocks
x q-statusSolaris/Goodies/q-StatusStandaloneExtraction.tar.gz, 39916 bytes, 78 tape blocks
x q-statusSolaris/Help, 0 bytes, 0 tape blocks
x q-statusSolaris/Help/patchdiagHelp.html, 8390 bytes, 17 tape blocks
x q-statusSolaris/History.txt, 2135 bytes, 5 tape blocks
x q-statusSolaris/index.html, 3173 bytes, 7 tape blocks
x q-statusSolaris/README, 8168 bytes, 16 tape blocks
x q-statusSolaris/README.html, 13453 bytes, 27 tape blocks
-------------------------------------------------------------------
Update Complete
-------------------------------------------------------------------
Do you wish to remove Update Files (Default [Y]): <cr>
Removing Install Program and Files
===================================================================
Verify this update by accessing the About.html file by clicking the
revision number (e.g. 2.04) in the q-Status Solaris GUI
qstatuswebserver# ls
q-statusSolaris       q-statusSolaris2.04Update01_patch.tar
qstatuswebserver# 
5 Validate Update by Clicking the
"About" text to display the
version information in the
"q-Status™ About" window.

In a web browser, validate that the update has been completed by checking the "q-Status™ About" window from any q-Status™ Solaris GUI.

Move the mouse over the version number and it will change to the text to "About". Click the "About" text will display the "q-Status™ About" window.

Notes:

Web browser cache may still contain the old version of the "q-Status™ About" window. Either clear the browser cache prior to viewing this page or perform serveral "refreshes".

A new LQWq-Status.pkg and q-StatusStandaloneExtraction.tar.gz file is always delivered with a new a q-Status™ Solaris patch update and will overwrite any existing version located in the q-statusSolaris/Goodies/ directory. If the client has created extra collection scripts or change parameters, they must recreate these files using the scripts in the q-statusSolaris/Goodies/pkg_WorkArea directory. See "Creating a q-Status™ Package Add Module" and "Creating a q-Status™ Standalone Extraction Tar-Gzip file".
q-Status™ Patch Updates are delivered with a new version of the patchdiag.xref as of the date of its release. If the client is using a later or special version of the patchdiag.xref, the update process will overwrite this file located in the q-statusSolaris/conf/ directory. If the client wishes to save their installed version, it should be copied or duplicated to a saved names (e.g. patchdiag.xref.save). After the INSTALL script is run, simply replace the q-Status™ Patch Update version with the save version.