~wb-munzinger/+junk/ocfs2-tools

« back to all changes in this revision

Viewing changes to ocfs2cdsl/ocfs2cdsl.8.in

  • Committer: Bazaar Package Importer
  • Author(s): Jeremy Lainé
  • Date: 2009-07-06 07:26:30 UTC
  • mfrom: (1.1.7 upstream) (0.1.5 squeeze)
  • Revision ID: james.westby@ubuntu.com-20090706072630-59335sl51k3rvu74
Tags: 1.4.2-1
* New upstream release (Closes: #535471).
* Drop patch for limits.h, included upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH "ocfs2cdsl" "8" "February 2007" "Version @VERSION@" "OCFS2 Manual Pages"
2
 
.SH "NAME"
3
 
ocfs2cdsl \- Create context dependent symbolic link (CDSL).
4
 
.SH "SYNOPSIS"
5
 
\fBocfs2cdsl\fR [\fB-cfnqvV\fR] [\fB\-t\fR \fIhostname|mach|os|nodenum\fR] \fIfilename\fR
6
 
.SH "DESCRIPTION"
7
 
.PP 
8
 
\fBocfs2cdsl\fR is used to create a context dependent symbolic link for
9
 
\fIfilename\fR (file or directory) for a node. A CDSL \fIfilename\fR will
10
 
have its own image for a specific node, but a common name in the OCFS2. It
11
 
is very important that the \fBocfs2ctl\fR command to be issued on all nodes
12
 
that are part of the cluster and to any subsequent nodes that are added. If
13
 
the \fBocfs2cdsl\fR command is not executed in some of the nodes, the cdsl
14
 
directory will not be accessible by them.
15
 
 
16
 
.SH "OPTIONS"
17
 
 
18
 
.TP
19
 
\fB\-t\fR \fIhostname|mach|os|nodenum\fR
20
 
\fIhostname|mach|os|nodenum\fR - One of these options should be specified
21
 
in order to create the CDSL. As for information, \fIhostname\fR would be
22
 
the same as the output of "uname -n", \fImach\fR would be the output of
23
 
"uname -m", \fIos\fR would the the output of "uname -o" and \fInodenum\fR
24
 
would be the global node number for the hostname in the
25
 
\fI/etc/ocfs2/cluster.conf\fR file.
26
 
 
27
 
.TP
28
 
\fB\-c\fR
29
 
During the creation of the CDSL, if the file does exist, the data will be
30
 
copied to the new location.
31
 
 
32
 
.TP
33
 
\fB\-f\fR
34
 
Force the execution of the command.
35
 
 
36
 
.TP
37
 
\fB\-n\fR
38
 
Will perform a check of all options and motions, but will not perform any
39
 
change on disk.
40
 
 
41
 
.TP
42
 
\fB\-q\fR
43
 
Execute \fBocfs2cdsl\fR in quiet mode.
44
 
 
45
 
.TP
46
 
\fB\-v\fR
47
 
Execute \fBocfs2cdsl\fR in verbose mode.
48
 
 
49
 
.TP
50
 
\fB\-V\fR
51
 
Print version and exit.
52
 
 
53
 
.SH "EXAMPLE"
54
 
 
55
 
If one wants to have a shared ORACLE_HOME installed on an OCFS2 partition,
56
 
and wants to have node specific configuration \fIfilename\fR in the same
57
 
shared ORACLE_HOME, one can have the \fIfilename\fR created by ocfs2cdsl.
58
 
A good example would be the directory $ORACLE_HOME/network/agent. Node1
59
 
could have its own view of the directory, which is different from Node2
60
 
view, but having the exact same full pathname.
61
 
.br
62
 
 
63
 
        # ocfs2cdsl -c -t hostname $ORACLE_HOME/network/agent
64
 
 
65
 
.br
66
 
In the example above, a CDSL directory will be created and the contents of the
67
 
\fIagent\fR directory will copied to the new location. If the same is to be executed
68
 
on all nodes, and assuming that no changes are made to the directory, each one of the
69
 
nodes would have the exact same view of the \fIagent\fR directory. In case of change
70
 
in the \fIagent\fR directory after the creation of the CDSL, only the node performing
71
 
the change would be able to see it. All other nodes would still have the same initial
72
 
view of the \fIagent\fR directory.
73
 
 
74
 
.SH "SEE ALSO"
75
 
.BR mkfs.ocfs2(8)
76
 
.BR fsck.ocfs2(8)
77
 
.BR tunefs.ocfs2(8)
78
 
.BR mounted.ocfs2(8)
79
 
.BR ocfs2console(8)
80
 
.BR debugfs.ocfs2(8)
81
 
 
82
 
.SH "AUTHORS"
83
 
Oracle Corporation
84
 
 
85
 
.SH "COPYRIGHT"
86
 
Copyright \(co 2004, 2007 Oracle. All rights reserved.