Scalable Database Server, HiRDB Version 8 Installation and Design Guide

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

1.2 Organization of HiRDB directories and files

Organization of this section
(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

Table 1-3 lists the directories and files that the HiRDB administrator creates.

Table 1-3 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

Table 1-4 lists the directories and files that HiRDB creates.

Table 1-4 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
%PDDIR%\lib\servers Directory for storing HiRDB server's executable files and libraries
%PDDIR%\client\lib Directory for storing HiRDB client's libraries
%PDDIR%\client\utl Directory for storing HiRDB client's commands and utilities
%PDDIR%\client\jba Directory for storing HiRDB Java stored procedure/function distribution wizard (created for use with the Windows or Windows (x64) version of HiRDB)
%PDDIR%\client\include Directory for storing the header information that is used during UAP creation
%PDDIR%\include Directory for storing header information that is used during UAP creation
%PDDIR%\spool\save1 Directory for storing saved core files
%PDDIR%\spool\pdshmdump1 Directory for storing shared memory dump files
%PDDIR%\spool\pdlckinf1 Directory for storing deadlock time-out information files
%PDDIR%\spool\pdsysdump1 Directory for storing simple dump files common to the system
%PDDIR%\spool\pdsdsdump1 Directory for storing simple dump files for a single server
%PDDIR%\spool\pdfesdump1 Directory for storing simple dump files for a front-end server
%PDDIR%\spool\pddicdump1 Directory for storing simple dump files for a dictionary server
%PDDIR%\spool\pdbesdump1 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\scdqid1, scdqid2 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 HiRDB's internal work directory
%PDDIR%\spool\olkrsfs HiRDB's internal work directory
%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\pdsqldump1 Directory for storing access path information files
%PDDIR%\spool\pdrshs1.log, pdrshs2.log File for storing information about remote commands
%PDDIR%\spool\pdsha1.log, pdsha2.log File for storing information about the system switchover facility
any name2 RPC trace file
%PDDIR%\tmp3 HiRDB's internal work directory
%PDDIR%\tmp\pdommenv File for storing shared memory information
%PDDIR%\tmp\home\processor-name 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%\.dbenv Directory for storing HiRDB database environment information files
%PDCLTPATH\pdsql1.trc, pdsql2.trc4 Files for storing trace information for SQL that is executed by a UAP
%PDCLTPATH\pderr1.trc, pderr2.trc4 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\lib Directory for storing plug-in libraries
%PDDIR%\plugin\plug-in-name Plug-in 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%\jre5 JavaTM 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%\pdistup Directory containing the simple setup tool
%PDDIR%\sample Directory containing an execution environment for the sample database
%PDDIR%\HiRDEF Directory containing an execution environment for the HiRDB definition support
%PDDIR%\UXPLDIR Directory used by the differing system call specifications absorption library
%PDDIR%\UXPLDIR\spool\
uxpllog1.txt, uxpllog2.txt
File for storing the information that is output by the differing system call specifications absorption library
%PDDIR%\Setup.ini File for managing installation information

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 8 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 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.

4 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 or not 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

Because the process ID is used in the file name, note that as many files as there are processes may be output during UAP execution.

5 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.