IBM Tivoli Netcool/Proviso 4.4.1Applying a DataMart patch
IBM Tivoli Netcool/Proviso 4.4.1 Applying a DataMart patch
This IBM Education Assistant module describes how to apply a patch to the DataMart product component.
Objectives
Objectives Upon completion of this module, you should be able to: Apply a patch to the DataMart module View the patch installation log
Upon completion of this module, you should be able to apply a patch to the DataMart module, which is a core component within Netcool/Proviso. You will also be able to confirm that the patch application, or installation, was successful using the patch installation log.
Assumptions
Assumptions Before applying a DataMart patch: Have Netcool/Proviso 4.4.1 installed and running Log in to the DataMart host as root Plan to apply patches during a scheduled maintenance window
Netcool/Proviso 4.4.1 must be installed and running before the patch installation is performed. The patch installation must be performed by a user with root-level permissions. Some patches might require downtime for the Netcool/Proviso environment, so plan to apply DataMart patches during a scheduled maintenance window.
Save and extract the patch file
Save and extract the patch file Save the patch to the DataMart host Use the gzip and tar utilities to extract the patch files gzip –d tar –xvf Example: # gzip -d 4.4.1-SP2.tar.gz # tar -xvf 4.4.1-SP2.tar x PATCHES, 0 bytes, 0 tape blocks x PATCHES/DM4.4.1-patches, 0 bytes, 0 tape blocks x PATCHES/DM4.4.1-patches/DM4.4.1-patch-ora9, 0 bytes, 0 tape blocks x PATCHES/DM4.4.1-patches/DM4.4.1-patch-ora9/pvm.ar, 5932151 bytes, 11587 tape blocks x PATCHES/DM4.4.1-patches/DM4.4.1-patch-ora9/tools.ar, 1412635 bytes, 2760 tape blocks x PATCHES/patch441.sh, 9223 bytes, 19 tape blocks
If more than one DataMart is present in your environment, you must follow these steps on each DataMart host. Save the patch to the local DataMart host. The file extension of the patch file is .tar.gz. Use the gzip -d or the gunzip command to extract the patch file to a tar file. Use the tar -xvf command to fully extract the patch and all supporting files. The patch extracts to a directory named PATCHES. This slide illustrates the two-step extraction process.
Review patch documentation
Review patch documentation Read the README text file that is included with the patch. The documentation includes the purpose of the patch and the installation instructions
Before applying the patch, review the README text file that accompanies the patch. The fixes and enhancements that are provided with the patch are listed in the README document, along with any specific installation instructions.
Apply patch
Apply patch Change to the new PATCHES directory Run the patch script with the following command ./patch -t datamart -h Example: # ./patch441.sh -t datamart -h /opt/datamart
When you extract the patch tar file, a directory named PATCHES is created. This new directory includes the installation script and all supporting files. Change to the PATCHES directory and run the installation script with the options -t datamart -h followed by the DataMart home directory. In this example, the patch script is named patch441.sh, and the DataMart home directory is /opt/datamart. The full command is ./patch441.sh -t datamart -h /opt/datamart. The following slide shows an example of this command and typical output messages.
Patch installation example
Patch installation example # ./patch441.sh -t datamart -h /opt/datamart/ Thu Dec 10 12:15:30 CST 2009: ************************************************************** Thu Dec 10 12:15:30 CST 2009: datamart patch 4.4.1SP2 Thu Dec 10 12:15:30 CST 2009: ************************************************************** Thu Dec 10 12:15:30 CST 2009: START Upgrade datamart in /opt/datamart/ - environment OK Thu Dec 10 12:15:30 CST 2009: /opt/datamart//lib/libtclOracle.so has support for Oracle 9 installed Thu Dec 10 12:15:30 CST 2009: Installing from ./DM4.4.1-patches/DM4.4.1-patch-ora9 to /opt/datamart//arc Thu Dec 10 12:15:30 CST 2009: Installing files pvm.ar tools.ar Thu Dec 10 12:15:30 CST 2009: Copying pvm.ar, setting read/write permissions, owner is pvuser Thu Dec 10 12:15:30 CST 2009: Copying tools.ar, setting read/write permissions, owner is pvuser Thu Dec 10 12:15:30 CST 2009: Installing from ./DM4.4.1-R2E1-RE-patch/DM4.4.1-ora9 to /opt/datamart//bin Thu Dec 10 12:15:30 CST 2009: Installing files Thu Dec 10 12:15:30 CST 2009: Installing from ./DM4.4.1-class-patch/DM4.4.1-ora9 to /opt/datamart//classes Thu Dec 10 12:15:30 CST 2009: Installing files Thu Dec 10 12:15:30 CST 2009: FINISHED Patch 4.4.1SP2 datamart succeeded\n\n Patch 4.4.1SP2 logged in /opt/datamart//log/patch441SP2.log\n
The output of the patch installation command indicates if the operation was successful. In this example, the second to last line of the output indicates that the patch installation has finished and was successful. The last line of the output points to the patch installation log.
Review the patch installation log
Review the patch installation log The last line of the patch installation message shows the path to the patch installation log The log file contains the same information as the output of the original patch installation
The patch installation log displays the same information as the installation output.
DataLoad patches
DataLoad patches DataLoad patches are installed using a similar process Save and extract the DataLoad patch Run the patch script with the following command ./patch -t dataload -h Example: # ./patch441.sh -t dataload -h /opt/dataload
DataLoad patches are packaged and installed using the same process as DataMart patches. DataLoad patches must be copied and applied to every DataLoad host individually. Run the DataLoad patch installation script with the options -t dataload -h followed by the DataLoad home directory. In this example, the patch script is named patch441.sh, and the DataLoad home directory is /opt/dataload. The full command is ./patch441.sh -t dataload -h /opt/dataload. The command output and log format are similar to DataMart patches.
Summary
Summary You should now be able to: Apply a patch to the DataMart module View the patch installation log
You should now be able to apply a patch to the DataMart module and confirm that the patch installation was successful by using the patch installation log.
Training roadmap for Netcool/Proviso
Training roadmap for Netcool/Proviso http://www.ibm.com/software/tivoli/education/edu_prd.html
Use this link to explore the training roadmap for IBM Tivoli® Netcool/Proviso.
Feedback
Feedback Your feedback is valuable You can help improve the quality of IBM Education Assistant content to better meet your needs by providing feedback. Did you find this module useful? Did it help you solve a problem or answer a question? Do you have suggestions for improvements? Click to send e-mail feedback: mailto:iea@us.ibm.com?subject=Feedback_about_datamartpatch.ppt This module is also available in PDF format at: ../datamartpatch.pdf
You can help improve the quality of IBM Education Assistant content by providing feedback.
Trademarks