.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "oarsh 1"
.TH oarsh 1 "2016-03-31" "oarsh" "OAR commands"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
oarsh \- remote shell connector for OAR batch scheduler.
.PP
oarcp \- oarsh compagnon to copy files from a node or to a node.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBoarsh\fR [\s-1OPTIONS\s0] <\s-1NODENAME\s0> [\s-1COMMAND\s0]
.PP
\&\fBoarcp\fR [\s-1OPTIONS\s0] [\s-1NODENAME:\s0]<\s-1PATHNAME\s0> [\s-1NODENAME:\s0]<\s-1PATHNAME\s0>
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Connect to a node from the job submission frontend of the cluster or any other node.
.SH "OPTIONS"
.IX Header "OPTIONS"
The \fBoarsh\fR mechanism uses \fIOpenSSH\fR client (the ssh command) under the hood to perform connections to remote hosts. Thus most of \fIOpenSSH\fR options can be used (but some are filtered out for security reasons).
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
.IP "\fB\s-1OAR_JOB_ID\s0\fR" 4
.IX Item "OAR_JOB_ID"
If not using the job-key mechanism, the \fB\s-1OAR_JOB_ID\s0\fR environment variable has to be set to give the jobid of the job to connect to on the remote node (a node can run several jobs at a same time). This is only required for connecting from outside the job (e.g. from the job submission frontend).
.IP "\fB\s-1OAR_JOB_KEY_FILE\s0\fR" 4
.IX Item "OAR_JOB_KEY_FILE"
If using the job-key mechanism (see \fBoarsub\fR \-k \-e/\-i), \fBoarsh\fR can use the job-key defined by the \fB\s-1OAR_JOB_KEY_FILE\s0\fR environment variable to connect to job on the remote machine. That mechanism can allow to connect to a job from a machine which is outside the \s-1OAR\s0 cluster the job belong to (e.g. in a grid of \s-1OAR\s0 clusters), given the job-key is available on that machine. \s-1NB:\s0 it is also possible to give the job-key using \fBoarsh\fR \-i option.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
.IP "Connecting from within our job, from one node to another one (node23):" 4
.IX Item "Connecting from within our job, from one node to another one (node23):"
> oarsh node\-23
.IP "Connecting to a node (node23) of our job (Id: 4242) from the frontal of the cluster:" 4
.IX Item "Connecting to a node (node23) of our job (Id: 4242) from the frontal of the cluster:"
> OAR_JOB_ID=4242 oarsh node\-23
.IP "Connecting to a node (node23) of our job that was submitted using a job-key:" 4
.IX Item "Connecting to a node (node23) of our job that was submitted using a job-key:"
> OAR_JOB_KEY_FILE=~/my_key oarsh node\-23
.IP "Same thing but using OpenSSH-like \fI\-i\fR option:" 4
.IX Item "Same thing but using OpenSSH-like -i option:"
> oarsh \-i ~/my_key node\-23
.SH "NOTES"
.IX Header "NOTES"
\&\fBoarsh\fR inherits from most of OpenSSH capabilities (e.g. X11 forwarding). However, one feature which \fBoarsh\fR does break is the \s-1SSH\s0 Agent.
.PP
The user's OpenSSH configuration files (files in the \fI~/.ssh\fR directory) are not used by \fBoarsh\fR.
.PP
For advanced users, when using the job-key mechanism, it is also possible to use ssh directly to connect to a job on a node. Please refer to the documentation of your cluster, or ask the admisitrator of your cluster.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIoarsub\fR\|(1), \fIoardel\fR\|(1) \fIoarstat\fR\|(1), \fIoarnodes\fR\|(1), \fIoarhold\fR\|(1), \fIoarresume\fR\|(1)
.SH "COPYRIGHTS"
.IX Header "COPYRIGHTS"
.Vb 1
\& Copyright 2003\-2016 Laboratoire d\*(AqInformatique de Grenoble (http://www.liglab.fr). This software is licensed under the GNU General Public License Version 2 or above. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.Ve