Page Properties | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
A 'snapshot', which will be the output produced by the pbs_snapshot tool, will be a tarball (.tgz file) named as "snapshot_<timestamp>.tgz" containing the following directory structure & files:
- server/
- qstat_B.out: output of "qstat -B"
- qstat_Bf.out: output of "qstat -Bf"
- qmgr_ps.out: output of "qmgr print server"
- qstat_Q.out: output of "qstat -Q"
- qstat_Qf.out: output of "qstat -Qf"
- qmgr_pr.out: output of "qmgr print resource"
- rscs_all (derived from the resourcedef file): Will list out built-in as well as custom resources in the following format:
Name: <resource name>
type = <resource type attribute>
flag = <resource flag attribute>Name: <resource name>
type = <resource type attribute>
flag = <resource flag attribute>...
...
- server_priv/: a copy of the 'server_priv' directory inside PBS_HOME, core files are captured separately (see core_file_bt/)
- accounting/: contains accounting logs from PBS_HOME/server_priv/accounting/ directory for the number of days specified by --accounting-logs option
- server_logs/ : contains server logs from the PBS_HOME/server_logs directory for the number of days specified by --daemon-logs option
- job/
- qstat.out: output of "qstat"
- qstat_f.out: output of "qstat -f"
- qstat_t.out: output of "qstat -t"
- qstat_tf.out: output of "qstat -tf"
- qstat_x.out: output of "qstat -x"
- qstat_xf.out: output of "qstat -xf"
- qstat_ns.out: output of "qstat -ns"
- qstat_fx_F_dsv.out: output of "qstat -fx -F dsv"
- qstat_f_F_dsv.out: output of "qstat -f -F dsv"
- node/
- pbsnodes_va.out: output of "pbsnodes -va"
- pbsnodes_a.out: output of "pbsnodes -a"
- pbsnodes_avSj.out: output of "pbsnodes -avSj"
- pbsnodes_aSj.out: output of "pbsnodes -aSj"
- pbsnodes_avS.out: output of "pbsnodes -avS"
- pbsnodes_aS.out: output of "pbsnodes -aS"
- pbsnodes_aFdsv.out: output of "pbsnodes -aFdsv"
- pbsnodes_avFdsv.out: output of "pbsnodes -avFdsv"
qmgr_pn_default.out: output of "qmgr print node @default"
mom_priv/: a copy of the 'mom_priv' directory inside PBS_HOME, core files are captured separately (see core_file_bt/)
- mom_logs/: contains mom logs from the PBS_HOME/mom_logs directory for the number of days specified by --daemon-logs option
- comm_logs/: contains comm logs from the PBS_HOME/comm_logs directory for the number of days specified by --daemon-logs option
- sched_priv/: a copy of the 'sched_priv' directory inside PBS_HOME with all the files, core files are not captured (see core_file_bt/).
- sched_logs/: contains scheduler logs from the PBS_HOME/sched_logs directory for the number of days specified by --daemon-logs option
- reservation/
- pbs_rstat_f.out: output of "pbs_rstat -f"
- pbs_rstat.out: output of "pbs_rstat"
- scheduler/
- qmgr_lsched.out: output of "qmgr list sched"
- qmgr_lsched.out: output of "qmgr list sched"
hook/
- qmgr_ph_default.out: output of "qmgr print hook @default"
qmgr_lpbshook.out: output of "qmgr list pbshook"
datastore/
pg_log/: a copy of the "PBS_HOME/datastore/pg_log" directory for the number of days specified by --daemon-logs option
pbs/
pbs.conf: a copy of the pbs.conf file for the PBS system
pbs_probe_v.out: output of "pbs_probe -v"
- pbs_hostn_v.out: output of "pbs_hostn -v $(hostname)"
- pbs_environment: copy of PBS_HOME/pbs_environment file
core_file_bt/ (stack backtrace from core files)
sched_priv/: files containing the output of "thread apply all backtrace full" on all core files captured from PBS_HOME/sched_priv
- server_priv/: files containing the output of "thread apply all backtrace full" on all core files captured from PBS_HOME/server_priv
- mom_priv/: files containing the output of "thread apply all backtrace full" on all core files captured from PBS_HOME/mom_priv
- misc/: files containing the output of "thread apply all backtrace full" on any other core files found inside PBS_HOME
- system/
- os_info: Information about the OS
- process_info: List of processes running on the system when the snapshot was taken (output of "ps -aux | grep [p]bs" on linux systems and "tasklist /v" on windows systems)
- ps_leaf.out: output of ps -leaf, only on linux systems
- lsof_pbs.out: output of "lsof | grep [p]bs", only on linux systems
- etc_hosts: Copy of "/etc/hosts" file, only on linux systems.
- etc_nsswitch_conf: Copy of "/etc/nsswitch.conf" file, only on linux systems.
- vmstat.out: Output of the command 'vmstat', only on linux systems.
- df_h.out: Output of the command 'df -h', only on linux systems.
- dmesg.out: Output of the 'dmesg' command, only on linux systems.
- ctime: this will log the time (since epoch) when the snapshot was taken.
- pbs_snapshot.log: captures the logs generated by pbs_snapshot.
...
Interface: Option -o <path to output file>target directory>
- Synopsis: Path to the directory where the snapshot tar file that tarball will be generated (without the extension .tgz)
- Details:
- This is a mandatory option to pbs_snapshot.If a tar file by the same name already exists then pbs_snapshot will error out..
- The target directory must exist.
- As an example, if -o is passed "/temp", then path to the generated snapshot would be "/temp/snapshot_<timestamp>.tgz"
Interface: Option -d <pbs_diag>
...
Sample Usage:
- pbs_snapshot -o mysnapshoto /temp: Will capture a snapshot inside $PWD/mysnapshot/temp/snapshot_<timestamp>.tgz along with 30 days of accounting logs and 5 days of daemon logs from the machine that's runningg running PBS Server
- pbs_snapshot --daemon-logs=1 --accounting-logs=1 -o mysnapshot /temp --obfuscate --map=mapfile.txt: Will capture a snapshot inside $PWD/mysnapshot.tgz along with 1 days inside /temp/snapshot_<timestamp>.tgz along with 1 day of accounting and daemon logs, will obfuscate the data and store data mapping in the map file named 'mapfile.txt'.
...