Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Java™ Troubleshooting Guide for HP-UX Systems: > Chapter 1 Diagnostic and Monitoring Tools and Options

HPjconfig

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

HPjconfig is a configuration tool for tuning your HP-UX 11i system to match the characteristics of your application. It provides kernel parameter recommendations tailored to your HP-UX hardware platform and application characteristics. HPjconfig has features for saving and restoring configurations so you can distribute customized recommendations across your customer base.

HPjconfig can also be used to verify that your HP-UX system has all the necessary patches required for Java. The HP-UX patches required for Java can be found at the following website:

http://h20361.www2.hp.com/en/HPUXJAVAPATCHES/index.html

HPjconfig is a pure Java Application that runs on the HP-UX SDK or JRE for the Java 2 Platform version 1.4.2.x, 5.0.x, and 6.0.x. HPjconfig is supported on HP PA-RISC 11i v1 (11.11), 11i v2 (11.23), 11i v3 (11.31), and HP Itanium® 11i v2 (11.23) and 11i v3 (11.31). All HP-UX 11i HP Integrity Itanium® and HP-9000 PA-RISC systems are supported.

For more information about HPjconfig, including the download, go to:

http://h20392.www2.hp.com/portal/swdepot/displayProductInfo.do?productNumber=HPJCONFIG

HPjconfig can be run in either graphical user interface (GUI) mode or non-GUI (command-line) mode. In either mode, it generates a summary of the configuration information in the log file named HPjconfig_<hostname>_<date>_<timestamp>.log. This log file name can be specified using the -logfile option.

Following is the usage information for the HPjconfig command:

usage:     
    HPjconfig [ options ] -gui     
    HPjconfig [ options ] <object> <action>  

objects: -patches &| -tunables 
actions: -listreq | -listmis | -listpres | -apply  

options:
    -patches       operate on java-specific patches
    -tunables      operate on java-specific tunables
    -listreq       list all java required patches or tunables that are applicable to this system
    -listmis       list missing java-specific patches or tunables on the system       
    -listpres      list applied (installed) java-specific patches or tunables on the system
    -apply         apply (install) missing java-specific patches or tunables on the system
    -javavers      java versions for selecting patches e.g 1.2, 1.3, 1.4, 5.0  
    -[no]gui       run in GUI mode
    -logfile       name of log file
    -proxyhost     HTTP proxy host name for accessing live data
    -proxyport     HTTP proxy port for accessing live data    
    -help          show help string and exit
    -version       show version string

The following examples show how to execute HPjconfig in GUI mode from the csh and the ksh:

(csh) $ setenv DISPLAY <Display's IP Address>:0.0
      $ setenv PATH $PATH:/usr/sbin
      $ java -jar HPjconfig.jar  

(ksh) $ export DISPLAY=<Display's IP Address>:0.0
      $ export PATH=$PATH:/usr/sbin
      $ java -jar HPjconfig.jar

The following four figures show the System, Application, Patches, and Tunables tabs for the HPjconfig tool:

Figure 1-1 HPjconfigSystem Tab

HPjconfig — System Tab

Figure 1-2 HPjconfigApplication Tab

HPjconfig — Application Tab

Figure 1-3 HPjconfigPatches Tab

HPjconfig — Patches Tab

Figure 1-4 HPjconfigTunables Tab

HPjconfig — Tunables Tab

The following commands show how to execute HPjconfig in non-GUI mode. The -help option lists options you can use in this mode.

$ cd <hpjconfig_installation_dir>
$ java -jar ./HPjconfig.jar -nogui -help 

The following example executes HPjconfig in non-GUI mode to list missing patches for Java SDK 1.4:

$ java -jar HPjconfig.jar -nogui -patches -listmis -javavers 1.4 
Log written to HPjconfig_mutant_20060915_040458.log 
List of missing patches:
 PHSS_34201  solves problem emulating floating point conversion when running
 PA2.0 Java on an IPF system.. solves problem with Aries signal handling
 that overlaps Java signal handling. solves problem emulating floating
 point conversion when running PA2.0 Java on an IPF system.. solves
 problem with Aries signal handling that overlaps Java signal handling.

The following example uses HPjconfig to show the values for HP-UX tunables required by Java:

$ java -jar HPjconfig.jar -nogui -tunables -listreq 
Log written to HPjconfig_mutant_20060915_040934.log
List of required tunables: 
Name                            Recommended value 
nproc                           2048+20 max_thread_proc 3000 
nkthread                        6000 
nfile                           30000 
maxfiles                        2*1024 
maxfiles_lim                    2*1024 
maxdsiz                         2000*1024*1024

The following example uses HPjconfig to display tunables that are set to values less than those recommended:

$ java -jar HPjconfig.jar
-nogui -tunables -listmis 
Log written to HPjconfig_mutant_20060915_040955.log
List of tunables whose values are less than the recommended values:
Name                            Recommended value 
max_thread_proc                 3000 
maxdsiz                         2000*1024*1024

The following example shows the log file contents that are produced by HPjconfig:

$ more HPjconfig_server1_20060915_042600.log    
 Fri Sep 15 16:26:00 PDT 2006     
 HPjconfig 3.0.01 (Thu Jul 21 14:52:47 2005)    
 Machine name:  server1    
 IP address:    15.244.94.25    
 System type:   ia64 hp server rx5670   
 Architecture:  IA64N    
 OS name:       HP-UX 
 OS version:    B.11.23   
 Processors:    4    

 Java version:  1.4
 
 Reading required patches/tunables information from /tmp/HPjconfig.xml
 Read required patches/tunables information   

 Reading patch list from system   
 Read patch list from system     

 List of required patches:
   PHCO_30476    supports HPjmeter profiling of unbound (MxN) threads.
   PHKL_30192    solves kernel panic with thousands of MxN threads.
   PHSS_30015    solves problem with Aries signal handling that overlaps Java signal handling.   
   PHSS_34201    solves problem emulating floating point conversion when running
                 PA2.0 Java on an IPF system.. solves problem with Aries signal 
                 handling that overlaps Java signal handling. solves problem 
                 emulating floating point conversion when running PA2.0 Java on 
                 an IPF system.. solves problem with Aries signal handling that
                 overlaps Java signal handling.
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2009 Hewlett-Packard Development Company, L.P.