Nonstop Database, HiRDB Version 9 Installation and Design Guide

[Contents][Index][Back][Next]

1.3.1 Initial files that are created

Organization of this subsection
(1) Directories and files that the HiRDB administrator creates
(2) Directories and files that HiRDB creates

(1) Directories and files that the HiRDB administrator creates

The following table lists the directories and files that the HiRDB administrator creates.

Table 1-2 Organization of directories and files that the HiRDB administrator creates

File or directory name Description
$PDDIR/conf/pdsys File for storing system common definitions
$PDDIR/conf/pdutsys File for storing unit control information definitions
$PDDIR/conf/pdsvrc File for storing server common definitions
$PDDIR/conf/server-name File for storing each server definition
$PDDIR/conf/pduapenv Directory for storing UAP environment definitions
$PDDIR/conf/chgconf Directory for storing system reconfiguration definition files

(2) Directories and files that HiRDB creates

The following table lists the directories and files that HiRDB creates.

Table 1-3 Directories and files that HiRDB creates

File or directory name Description
$PDDIR/bin Directory for storing HiRDB commands and utilities
$PDDIR/lib Directory for storing HiRDB's shared libraries and message text files
$PDDIR/lib/sysconf Directory for storing a file that is used to analyze HiRDB system definitions
$PDDIR/lib/sysdef
$PD DIR/lib/sysdef_r
$PDDIR/lib/sysdef_v94
$PDDIR/lib/servers Directory for storing HiRDB server and XDS executable files and libraries
$PDDIR/lib/save Directory for storing information when the pdmemsv command is used to share the libraries
$PDDIR/lib/jvm Directory for storing libraries that are required to execute the POSIX library HiRDB (created for 32-bit mode and 64-bit mode HP-UX 11.0)
$PDDIR/lib/chinese Directory for storing EUC Chinese character code parser libraries
$PDDIR/lib/chinese-gb18030 Directory for storing Chinese character code parser libraries
$PDDIR/lib/lang-c Directory for storing single-byte character code parser libraries
$PDDIR/lib/sjis Directory for storing Shift-JIS kanji code parser libraries
$PDDIR/lib/ujis Directory for storing EUC Japanese kanji code parser libraries
$PDDIR/lib/utf-8 Directory for storing Unicode (UTF-8) parser libraries
$PDDIR/lib/utf-8_ivs Directory for storing Unicode (IVS-supported UTF-8) parser libraries
$PDDIR/client/lib Directory for storing HiRDB client's libraries
$PDDIR/client/lib10_20 Directory for storing HP-UX 10.20 HiRDB client's libraries
$PDDIR/client/utl Directory for storing HiRDB client's commands and utilities
$PDDIR/include Directory for storing the header information that is used during UAP creation
$PDDIR/spool Directory for storing HiRDB work files
$PDDIR/spool/save#1 Directory for storing saved core files and server process abnormal termination information file
$PDDIR/spool/pdshmdump#1 Directory for storing shared memory dump files
$PDDIR/spool/pdlckinf#1 Directory for storing deadlock time-out information files
$PDDIR/spool/pdsysdump#1 Directory for storing simple dump files common to the system
$PDDIR/spool/pdsdsdump#1 Directory for storing simple dump files for a single server
$PDDIR/spool/pdfesdump#1 Directory for storing simple dump files for a front-end server
$PDDIR/spool/pddicdump#1 Directory for storing simple dump files for a dictionary server
$PDDIR/spool/pdbesdump#1 Directory for storing simple dump files for a back-end server
$PDDIR/spool/pdstj1, pdstj2 Statistics log files
$PDDIR/spool/pdlog1, pdlog2 Message log files
$PDDIR/spool/pdjnlinf Directory for storing system log information output files
$PDDIR/spool/pdjnlinf/errinf Directory for storing system log error information output files
$PDDIR/spool/pdscdqi1, pdscdqi2 Files for storing HiRDB's internal schedule queue information
$PDDIR/spool/oslmqid File for storing message queue IDs
$PDDIR/spool/oslsmid File for storing semaphore IDs
$PDDIR/spool/pdprcsts prc status file
$PDDIR/spool/.pdatmode Status files for startup and termination
$PDDIR/spool/.pdipcid Files used for managing semaphore IDs
$PDDIR/spool/.pdommenv Files for storing shared memory information
$PDDIR/spool/cmdlog/cmdlog1, cmdlog2 Files containing the historical information about the executed commands
$PDDIR/spool/errlog/errlog1, errlog2 Files containing the historical information about internal HiRDB operation
$PDDIR/spool/olkfifs Directory for storing pipe files for use with thread locking#7
$PDDIR/spool/olkrsfs Directory for storing pipe files for use with thread suspend/resume#8
$PDDIR/spool/oslcnt1 File for managing the number of pipe files
$PDDIR/spool/cnctusrinf File for storing the connected user information if there is any user still connected to HiRDB during the execution of normal termination or a planned termination command
$PDDIR/spool/cnctusrdtl File for storing the execution result of pdls -d act, pdls -d prc, and pdls -d trn commands if there is any user still connected to HiRDB during the execution of normal termination or a planned termination command
$PDDIR/spool/pdsqldump#1 Directory for storing access path information files
$PDDIR/spool/pdtrninf Directory for outputting transaction information file when using realtime SAN replication
$PDDIR/spool/pdprf Directory for outputting PRF trace files
$PDDIR/spool/pduaperr Directory for SQL error report files
$PDDIR/spool/pdcwwrn Directory for SQL runtime warning information files
$PDDIR/spool/utlrpt Directory for outputting processing performance information files
any name#2 RPC trace file
/dev/HiRDB/pth/#3 Directory for storing communication information files
$PDDIR/tmp#4 HiRDB's internal work directory
$PDDIR/tmp/pdommenv File for storing shared memory information
$PDDIR/tmp/home/HiRDB-managed-ID-directory Current work directory
$PDDIR/conf Directory for storing HiRDB system definition files
$PDDIR/conf/backconf Directory for storing the pre-reconfiguration HiRDB system definition when executing the system reconfiguration command
$PDDIR/conf/Inittab /etc/inittab save directory
$PDDIR/.dbenv Directory for storing HiRDB database environment information files
$PDCLTPATH/pdsql1.trc, pdsql2.trc#5 Files for storing trace information for SQL that is executed by a UAP
$PDCLTPATH/pderr1.trc, pderr2.trc#5 Files for storing information about communication errors between a UAP and a server
$PDDIR/plugin Directory that integrates all HiRDB plug-in directories
$PDDIR/plugin/.sys HiRDB's internal work directory
$PDDIR/plugin/lib Directory for storing plug-in libraries
$PDDIR/plugin/plug-in-name Plug-in directory
$PDDIR/plugin/plug-in-name/.sys HiRDB's internal work directory
$PDDIR/plugin/plug-in-name/bin Directory for storing plug-in commands
$PDDIR/plugin/plug-in-name/etc Directory for storing the common files that are required by all plug-ins
$PDDIR/plugin/plug-in-name/conf Directory for storing plug-in configuration files
$PDDIR/jre#6 Java execution environment
$PDDIR/renew Directory used during updating to the HiRDB update version
$PDDIR/renew_bak Directory for backing up the operating HiRDB when updating to the HiRDB update version
$PDDIR/.pdlogprgid File for managing the syslog program ID
[Figure] For HP-UX
/sbin/init.d/
/sbin/rc1.d/
[Figure] For Solaris
/etc/init.d/
/etc/rc0.d/
/etc/rc1.d/
[Figure] For Linux
/etc/init.d/
/etc/rc0.d/
/etc/rc1.d/
/etc/rc6.d/
Directory for storing script files that run when the operating system starts up or shuts down.
File name:
[Figure] For HP-UX or Solaris
HiRDB single server configuration is HiRDB_S or K090HiRDB_S
HiRDB parallel server configuration is HiRDB_P or K090HiRDB_P
[Figure] For Linux
HiRDB single server configuration is HiRDB_S, K09HiRDB_S, or S91HiRDB_S
HiRDB parallel server configuration is HiRDB_P, K09HiRDB_P, or S91HiRDB_P
$PDDIR/pdistup Directory containing the simple setup tool
$PDDIR/spool/tmp Directory for storing temporary work files

#1: Because HiRDB uses this directory to output troubleshooting information, it may keep increasing in size. You should use the pdcspool command periodically to delete the contents.

You use the operands listed below for periodic deletion of troubleshooting information. For details about these operands, see the manual HiRDB Version 9 System Definition:
  • pd_spool_cleanup_interval
  • pd_spool_cleanup_interval_level
  • pd_spool_cleanup
  • pd_spool_cleanup_level

#2: To specify the filename, use the pd_rpc_trace_name operand.

#3: The files in this directory can be deleted when all HiRDB servers in this server machine have stopped.

#4: This directory is used internally by HiRDB. Do not create directories or files in this directory. Do not specify this directory for use by HiRDB to create files (for example, for the pd_rpc_trace_name operand). This directory is deleted and re-created each time the unit starts.

#5: Two copies of this file are output to the directory specified with PDCLTPATH. If PDCLTPATH is omitted, the files are output to the current directory used to start the UAP (in the case of a UAP started from OpenTP1, $DCDIR/tmp/home/directory-with-server-name-xx).

The names for the files to be created depends on whether X/Open-compliance API (TX_ function) was used. When the TX_ function is used, the files are created with the following names:
  • pdsqlxxxxx-1.trc, pdsqlxxxxx-2.trc
  • pderrxxxxx-1.trc, pderrxxxxx-2.trc
Legend:
xxxxx: Process ID during UAP execution

Be aware that it is possible for as many files to be output as there are server processes during UAP execution, since the process ID serves as the file name.

#6: This directory is created when the version is earlier than 07-03. When version 07-03 or later is used, this directory is not created because JRE is not bundled with the package.

#7: The number of pipe files created in this directory is the value of the pd_max_server_process operand [Figure] 2 + 100.

#8: Shown below are the formulas for approximating the number of pipe files to be created in this directory:
  • HiRDB single server configuration
    Value of pd_max_server_process + 127 + value of pd_max_users [Figure] 4
  • HiRDB parallel server configuration
    Value of pd_max_server_process + 127 + a
    a: Use one of the following formulas, as applicable:
    Front-end server: value of pd_max_users [Figure] 2
    Dictionary server: value of pd_max_dic_process [Figure] 35
    Back-end server: value of pd_max_bes_process [Figure] 35
    Include in the total the appropriate value for the servers in the unit.