mirror of
https://github.com/QuantumPackage/qp2.git
synced 2024-08-31 05:03:40 +02: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.
|
|||
|
.
|