[Bio] / SoftRelTools / importrel.1 Repository:
ViewVC logotype

View of /SoftRelTools/importrel.1

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1.1.1 - (download) (annotate) (vendor branch)
Fri Dec 20 20:20:56 2002 UTC (15 years, 11 months ago) by efrank
Branch: BobJacobsen, MAIN
CVS Tags: Head-20-Dec-2002, HEAD
Changes since 1.1: +0 -0 lines

Import from SLAC.  Not sure this is going to serve us, but there is a ton
of experience in this package.

.TH importrel 1 "March 1, 1995"
.SH NAME
.HP 10
importrel \- Import a release within the BaBar Software Release System from a remote site

.SH SYNOPSIS
.HP 10
.B importrel
.B -p[abCcDdfGgmorRyTtvV]
.B <release name>


.SH DESCRIPTION

importrel copies a release within the BaBar software distribution
from another site.  The source site is specified via the BFDISTr
environment variable. All included package versions are also
copied if needed.

.SH MAJOR OPTIONS
.PP 
.B \-p
.RS 8
Signifies production release, i.e. in the $BFDIST directory tree.
This option is currently required.

.PP 
.RE
.B \-a
.RS 8
Import only the architecture-independent part of the release; leave 
the contents of bin, lib, tmp and doc alone.  They can be gotten later
with importarch. 
.RE
.SH ONLINE OPTIONS
.PP 
.B \-o
.RS 8
Signifies online production release, i.e. in the $BFDIST/online_releases
directory tree.

.PP 
.RE
.SH MINOR OPTIONS
.RE
.PP 
.B \-b
.RS 8
Rerun importrel even if release already exist. Use
this option if importrel failed during previous session and needs to
be rerun.
.RE
.PP 
.B \-C
.RS 8
compress/uncompress the data during a SSH transfer. This is the default.
It can be turned off with -n.
.RE
.PP 
.B \-c
.RS 8
use compress or cat (for OSF) instead of gzip, gzip is default. This option
is normally not needed since importrel automatcally detect the existence
of gzip.
.RE
.PP 
.B \-D
.RS 8
Trace importver but do not actually execute it. This option is mainly for
debugging purpose only.
.RE
.PP 
.B \-d
.RS 8
display major parameters used. This option is very useful to obtain
the specification used by the program.
.RE
.PP 
.B \-f
.RS 8
force to clean up old version before creating new one. This option is
useful if old version is not usable for some reason.
.RE
.PP
.B \-n
.RS 8
turn off compression. Use tar/untar only.
.RE
.PP 
.B \-G
.RS 8
Add group access to all directories. Allow group access.
.RE
.PP 
.B \-g
.RS 8
Do not call importver to copy packages over. One reason to do so is to
import base release over, then import a incremental release.
.RE
.PP 
.B \-k
.RS 8
internal usage, test mode, assume there is no ksh.
.RE
.PP 
.B \-m
.RS 8
Copy lib/*/templates over. The default is not.
.RE
.PP 
.B \-q
.RS 8
quite.
.RE
.PP 
.B \-r
.RS 8
use tar instead of gtar, gtar is default.
.RE
.PP
.B \-R
.RS 8
use rsh/remsh instead of ssh. Ssh is default if available. 
.RE
.PP 
.B \-T
.RS 8
test remote rlogin. Use this option when rsh failed. It will try a
rsh on the remote host and analyze the error message. 
.RE
.PP 
.B \-t
.RS 8
Turn on debug mode.
.RE
.PP 
.B \-v
.RS 8
Show commands and list files as they are copied over
.RE
.PP 
.B \-V
.RS 8
Show version.
.RE

.SH ARGUMENTS
.PP
.B <release name>
.RS 8
The release to copy.
.RE

.SH ENVIRONMENT
.PP
.B BFDIST
.RS 8
Head of the tree that contains the BaBar software releases. Usually set to $BFROOT/dist
.RE
.PP
.B BFDISTr
.RS 8
Location of $BFDIST on the remote site. It can be absolutepathname or 
[user@]hostname:absolutepathname. If the hostname is specified, importrel
will tar files through RSH. Access via rsh to this location must be
possible, which may require particular .rhosts entries and/or token setup.

If the hostname is not specified, importrel will tar files directly, this
is normally done via AFS. e.g setenv BFDISTr /afs/slac.stanford.edu/g/babar/dist 

.RE
.SH SSH AUTOMATIC LOGIN
.PP
To set up automatic login via ssh so that one won't have to provide
password repetitively, do the following two steps:

1) Setting up the ~/.rhosts file using the same method as RSH's. 

2) Setting up ~/.ssh/known_hosts file

There is a ~/.ssh/known_hosts file that list all the known host. Logon
to the target machine with any method that works, then run 'ssh' back to
the remote host to set up the access.

    from <target-host>  [1]
    $ ssh <remote-host> date
    Host key not found from the list of known hosts.
    Are you sure you want to continue connecting (yes/no)?
    yes

Answer 'yes' to add a host key to the ~/.ssh/know_hosts file at the target
host. From now on the password authentication will be bypassed when you run
'ssh' from that remote machine to the target machine.
  
 Note: [1]. Target host has the source release code.
 
.SH "SEE ALSO"
SoftRelTools, importver

.SH AUTHOR
Bob Jacobsen (Bob_Jacobsen@lbl.gov)

.SH MAINTAINER
Terry Hung (terryh@slac.stanford.edu)

.SH BUGS

All architectures (BFARCH values, see the system documentation)
are imported.  This should have some useful restriction applied.


MCS Webmaster
ViewVC Help
Powered by ViewVC 1.0.3