SUBDOCK on C7: Difference between revisions

From DISI
Jump to navigation Jump to search
No edit summary
m (Buyan moved page SUBDOCK ON C7 to SUBDOCK on C7)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
These are C7 specific notes for running [[SUBDOCK_DOCK3.8|SUBDOCK]] with [[DOCK 3.8]] on [[Cluster 7]].
SUBDOCK on C7
For the full SUBDOCK reference, see [[SUBDOCK_DOCK3.8]].


== What SUBDOCK does ==
This page is for C7-specific notes on [[SUBDOCK_DOCK3.8|SUBDOCK]]. For the full SUBDOCK documentation, see [[SUBDOCK_DOCK3.8]].
SUBDOCK submits many DOCK jobs to a scheduler.
On C7, the scheduler is SLURM, so SUBDOCK submits jobs with sbatch.


== Main C7 Rule ==
== C7 setup ==
C7 uses SLURM. Do not use SGE on C7.
 
Load DOCK:


== Load Dock on C7 ==
  module load dock
  module load dock
  echo $DOCK_INSTALL_PATH
  echo $DOCK_INSTALL_PATH
  echo $DOCKBASE
  echo $DOCKBASE


The DOCK executable is usually:
SUBDOCK is inside the DOCK install:
  ${DOCK_INSTALL_PATH}/dock3/dock64
 
  ${DOCK_INSTALL_PATH}/SUBDOCK/subdock.bash
${DOCK_INSTALL_PATH}/SUBDOCK/rundock.bash
 
`subdock.bash` expects `rundock.bash` to be in the same directory.


== Required SUBDOCK variables ==
== Scheduler ==
  export EXPOST_DEST=/path/to/output
 
C7 runs this workflow through SLURM (`sbatch`). Set the controller explicitly:
 
export USE_SLURM=true
export USE_SGE=false
export USE_PARALLEL=false
export USE_CHARITY=false
 
If more than one controller is enabled, SUBDOCK exits with:
 
cannot select more than one job controller!
 
== Required variables ==
 
SUBDOCK needs:
 
  export EXPORT_DEST=/path/to/output
  export INPUT_SOURCE=/path/to/split_database_index
  export INPUT_SOURCE=/path/to/split_database_index
  export DOCKFILES=/path/to/dockfiles
  export DOCKFILES=/path/to/dockfiles
  export DOCKEXEC=${DOCK_INSTALL_PATH}/dock3/dock64
  export DOCKEXEC=${DOCK_INSTALL_PATH}/dock3/dock64
Use paths in your own workspace. Do not write output into the shared DOCK install, e.g. avoid:
${DOCK_INSTALL_PATH}/test/docking/output
== Run ==
Example:
mkdir -p output
export EXPORT_DEST="$(pwd)/output"
export INPUT_SOURCE="$(pwd)/split_database_index"
export DOCKFILES="$(pwd)/dockfiles"
export DOCKEXEC="${DOCK_INSTALL_PATH}/dock3/dock64"
bash ${DOCK_INSTALL_PATH}/SUBDOCK/subdock.bash
Successful submission looks like:
submitting N out of N jobs
Submitted batch job <jobid>
== Check jobs ==
squeue -u $USER
squeue -j <jobid>
`sacct` may not work on C7 if SLURM accounting is disabled. Check logs after completion:
ls output/logs
less output/logs/1.out
Success usually includes:
starting DOCK vers=3.8
finished!
== Related pages ==
* [[SUBDOCK_DOCK3.8]]
* [[DOCK_3.8_testing_on_C7]]
* [[DOCK 3.8]]
[[Category:DOCK_3.8]]
[[Category:Cluster 7]]

Latest revision as of 21:15, 22 June 2026

SUBDOCK on C7

This page is for C7-specific notes on SUBDOCK. For the full SUBDOCK documentation, see SUBDOCK_DOCK3.8.

C7 setup

Load DOCK:

module load dock
echo $DOCK_INSTALL_PATH
echo $DOCKBASE

SUBDOCK is inside the DOCK install:

${DOCK_INSTALL_PATH}/SUBDOCK/subdock.bash
${DOCK_INSTALL_PATH}/SUBDOCK/rundock.bash

`subdock.bash` expects `rundock.bash` to be in the same directory.

Scheduler

C7 runs this workflow through SLURM (`sbatch`). Set the controller explicitly:

export USE_SLURM=true
export USE_SGE=false
export USE_PARALLEL=false
export USE_CHARITY=false

If more than one controller is enabled, SUBDOCK exits with:

cannot select more than one job controller!

Required variables

SUBDOCK needs:

export EXPORT_DEST=/path/to/output
export INPUT_SOURCE=/path/to/split_database_index
export DOCKFILES=/path/to/dockfiles
export DOCKEXEC=${DOCK_INSTALL_PATH}/dock3/dock64

Use paths in your own workspace. Do not write output into the shared DOCK install, e.g. avoid:

${DOCK_INSTALL_PATH}/test/docking/output

Run

Example:

mkdir -p output
export EXPORT_DEST="$(pwd)/output"
export INPUT_SOURCE="$(pwd)/split_database_index"
export DOCKFILES="$(pwd)/dockfiles"
export DOCKEXEC="${DOCK_INSTALL_PATH}/dock3/dock64"
bash ${DOCK_INSTALL_PATH}/SUBDOCK/subdock.bash

Successful submission looks like:

submitting N out of N jobs
Submitted batch job <jobid>

Check jobs

squeue -u $USER
squeue -j <jobid>

`sacct` may not work on C7 if SLURM accounting is disabled. Check logs after completion:

ls output/logs
less output/logs/1.out

Success usually includes:

starting DOCK vers=3.8
finished!

Related pages