mirror of
https://github.com/QuantumPackage/qp2.git
synced 2024-12-26 21:33:30 +01:00
140 lines
3.4 KiB
Groff
140 lines
3.4 KiB
Groff
.\" Man page generated from reStructuredText.
|
||
.
|
||
.TH "QP_TUNNEL" "1" "Jun 15, 2019" "2.0" "Quantum Package"
|
||
.SH NAME
|
||
qp_tunnel \- | Quantum Package >
|
||
.
|
||
.nr rst2man-indent-level 0
|
||
.
|
||
.de1 rstReportMargin
|
||
\\$1 \\n[an-margin]
|
||
level \\n[rst2man-indent-level]
|
||
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
-
|
||
\\n[rst2man-indent0]
|
||
\\n[rst2man-indent1]
|
||
\\n[rst2man-indent2]
|
||
..
|
||
.de1 INDENT
|
||
.\" .rstReportMargin pre:
|
||
. RS \\$1
|
||
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
||
. nr rst2man-indent-level +1
|
||
.\" .rstReportMargin post:
|
||
..
|
||
.de UNINDENT
|
||
. RE
|
||
.\" indent \\n[an-margin]
|
||
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
.nr rst2man-indent-level -1
|
||
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
||
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
||
..
|
||
.sp
|
||
Establishes a tunnel to allow communications between machines within
|
||
different networks, for example multiple MPI slave jobs running on
|
||
different clusters.
|
||
.SH USAGE
|
||
.INDENT 0.0
|
||
.INDENT 3.5
|
||
.sp
|
||
.nf
|
||
.ft C
|
||
qp_tunnel [\-g] (ADDRESS|EZFIO_DIR)
|
||
.ft P
|
||
.fi
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
\fBEZFIO_DIR\fP is the name of the \fI\%EZFIO\fP directory containing the data,
|
||
and \fBADDRESS\fP is the address of another tunnel.
|
||
.INDENT 0.0
|
||
.TP
|
||
.B \-h, \-\-help
|
||
Displays the help message
|
||
.UNINDENT
|
||
.INDENT 0.0
|
||
.TP
|
||
.B \-g, \-\-get\-input
|
||
Download the EZFIO directory from the remote instance of qp_tunnel.
|
||
.UNINDENT
|
||
.SH EXAMPLE
|
||
.INDENT 0.0
|
||
.INDENT 3.5
|
||
.sp
|
||
.nf
|
||
.ft C
|
||
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
||
| | | |
|
||
| N1_1 N1_2 N1_3 | | N2_1 N2_2 N2_3 |
|
||
| | | | | | | | | |
|
||
| +\-\-\-\-+\-\-\-\-+ | | +\-\-\-\-+\-\-\-\-+ |
|
||
| | | | | |
|
||
| C1 F1 | | F2 C2 |
|
||
| +\-\-\-\-\-\-\-\-\-=\-\-\-\-=\-\-\-\-\-\-\-\-+ |
|
||
| | | |
|
||
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+ +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
||
.ft P
|
||
.fi
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.sp
|
||
Imagine you have two clusters, C1 and C2. Each cluster is accessible via SSH
|
||
on a front\-end named respectively F1 and F2. Groups of nodes N1 and N2 have
|
||
been reserved by the batch scheduling system on both clusters.
|
||
Each node in N1 is on the same network as the other nodes of N1, but they
|
||
can’t access the network on which the nodes of N2 are.
|
||
.INDENT 0.0
|
||
.IP 1. 3
|
||
Start a parallel simulation on the cluster C1, running on nodes N1.
|
||
We assume that there is a shared file system, such that F1 can access
|
||
the EZFIO directory. We also assume that F1 can communicate with the
|
||
nodes of N1.
|
||
.IP 2. 3
|
||
Run a tunnel on the front\-end F1 and keep it running:
|
||
.UNINDENT
|
||
.INDENT 0.0
|
||
.INDENT 3.5
|
||
.sp
|
||
.nf
|
||
.ft C
|
||
me@f1 $ qp_tunnel my_directory.ezfio
|
||
Connect to:
|
||
tcp://31.122.230.47:42379
|
||
Ready
|
||
.ft P
|
||
.fi
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.INDENT 0.0
|
||
.IP 3. 3
|
||
On the front\-end F2, run another instance connecting to the other one,
|
||
which will fetch the \fI\%EZFIO\fP directory:
|
||
.UNINDENT
|
||
.INDENT 0.0
|
||
.INDENT 3.5
|
||
.sp
|
||
.nf
|
||
.ft C
|
||
me@f2 $ qp_tunnel \-\-get\-input tcp://31.122.230.47:42379
|
||
Connect to:
|
||
tcp://31.122.209.139:42379
|
||
Communication [ OK ]
|
||
Getting input... my_directory.ezfio ...done
|
||
Ready
|
||
.ft P
|
||
.fi
|
||
.UNINDENT
|
||
.UNINDENT
|
||
.INDENT 0.0
|
||
.IP 4. 3
|
||
Keep the tunnel running, and you can now run a slave simulation within the
|
||
nodes N2.
|
||
.UNINDENT
|
||
.SH AUTHOR
|
||
A. Scemama, E. Giner
|
||
.SH COPYRIGHT
|
||
2019, A. Scemama, E. Giner
|
||
.\" Generated by docutils manpage writer.
|
||
.
|