~jeff-apple/openvista-gtm-integration/bug368789

« back to all changes in this revision

Viewing changes to docs/man1/ovimport.1

  • Committer: Jonathan Tai
  • Date: 2009-04-20 17:00:01 UTC
  • mfrom: (21.1.6 bug326435)
  • Revision ID: jon.tai@medsphere.com-20090420170001-gr4z4wg24b7crnf0
Merge bug 326435 - Linux commands should come with man pages

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH ovimport 1 "20 Apr 2009" Linux "User Manuals"
 
2
.SH NAME
 
3
ovimport \- imports routines and globals into a new OpenVista instance
 
4
.SH SYNOPSIS
 
5
.B ovimport [-h] [-q] [-f] [-r 
 
6
.I routines
 
7
.B ] [-g 
 
8
.I globals
 
9
.B ] 
 
10
.I instance_name
 
11
.SH DESCRIPTION
 
12
.B ovimport
 
13
imports routines and globals into a new OpenVista instance.  Routines can be in
 
14
a %RO-format file, or loose .m files in a directory.  In the latter case,
 
15
specify the directory containing the .m files after the -r flag; do not specify
 
16
the .m files themselves.  Globals can be in a %GO-format file or a ZWR-format
 
17
file.  Files with DOS-style line endings are converted to UNIX-style line
 
18
endings automagically; GT.M does not handle DOS-style line endings natively.
 
19
Line ending conversion requires enough free space in the target instance's 
 
20
.I tmp
 
21
directory to hold a copy of the files to be imported.  Support for compressed
 
22
files is planned in a future version.
 
23
.PP
 
24
.B ovimport
 
25
checks to see if the target instance has any routines or database transactions.
 
26
If either are found, the instance is assumed to not be new and 
 
27
.B ovimport
 
28
aborts.  To suppress this behavior, use the 
 
29
.B -f
 
30
flag.  
 
31
.PP
 
32
Routines are compiled after the routines are imported.  Journaling is
 
33
temporarily disabled during the global import to improve performance, unless the 
 
34
.B -f
 
35
flag was given.  This is safe to do because the database is guaranteed to be
 
36
empty before the import, so even if the system crashes and the database is
 
37
destroyed, the database can be recreated and
 
38
.B ovimport
 
39
can be run again.  If the 
 
40
.B -f
 
41
flag was given, the database is not guaranteed to be empty.  In this case,
 
42
journaling is not disabled because there may be other data already in the
 
43
database that is worth protecting.
 
44
.PP
 
45
Depending on the size of the files to be imported and the speed of the
 
46
hardware,
 
47
.B ovimport
 
48
may take several minutes to complete.  By default, dated status messages are
 
49
printed to stderr.  To suppress this behavior, use the 
 
50
.B -q
 
51
flag.  All import operations are also logged to syslog.
 
52
.SH OPTIONS
 
53
.IP -h
 
54
display help text
 
55
.IP -y
 
56
do not ask for confirmation
 
57
.IP -q
 
58
quiet; suppress status messages
 
59
.IP -j
 
60
after restoring the backup, apply journal entries
 
61
.IP -f
 
62
force; kill any processes accessing the database before restore
 
63
.SH "REPORTING BUGS"
 
64
Please report any bugs you encounter at
 
65
.PP
 
66
https://bugs.launchpad.net/openvista-gtm-integration
 
67
.SH AUTHOR
 
68
Jonathan Tai <jon.tai@medsphere.com>
 
69
.SH "SEE ALSO"
 
70
.BR ovrestore (1)