author | John Beck <John.Beck@Oracle.COM> |
Mon, 08 Jun 2015 11:25:12 -0700 | |
changeset 4435 | b497cc6685f1 |
permissions | -rw-r--r-- |
4435
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
1 |
'\" te |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
2 |
.\" Copyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
3 |
.TH masfcnv 1M "7 May 2012" "SunOS 5.12" "System Administration Commands" |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
4 |
.SH NAME |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
5 |
masfcnv \- SNMP configuration migration script |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
6 |
.SH SYNOPSIS |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
7 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
8 |
.nf |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
9 |
\fB/usr/lib/net-snmp/masfcnv\fR [\fB-cimnrs\fR] [\fB-l\fR \fIagent\fR\fImaster\fR] |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
10 |
[\fB-p\fR \fIenable\fR\fIdisable\fR\fIerror\fR] [\fB-t\fR \fInone\fR\fIadd\fR] |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
11 |
[\fB-u\fR \fIagent\fR\fImaster\fR\fIerror\fR] [\fB-y\fR \fIagent\fR\fImaster\fR\fIerror\fR] |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
12 |
.fi |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
13 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
14 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
15 |
.nf |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
16 |
\fBmasfcnv\fR [\fB-V\fR] |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
17 |
.fi |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
18 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
19 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
20 |
.nf |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
21 |
\fBmasfcnv\fR [\fB-?\fR] |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
22 |
.fi |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
23 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
24 |
.SH DESCRIPTION |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
25 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
26 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
27 |
The \fBmasfcnv\fR script is used to assist the system administrator in migrating an existing set of configuration files for the Sun SNMP Management Agent for Sun Fire and Netra Systems (MASF) to the Systems Management Agent (SMA). |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
28 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
29 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
30 |
The script accepts as input the currently installed set of MASF and SMA configuration files and outputs a new set of SMA configuration files. Existing SMA configuration files are backed up by appending \fB\&.bak\fR to the filename. The administrator can choose to output the new configuration to standard output, instead of replacing the current configuration, by specifying the \fB-n\fR option. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
31 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
32 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
33 |
The migration script must be run as the superuser. Failure to do so causes the script to exit with an error message. Before running the script you should ensure that both the SMA and MASF agents are not running. If the agents are running they will be shut down by the script. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
34 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
35 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
36 |
The migration script installs a new startup script for the MASF agent in \fB/etc/init.d\fR, as well as a backup of the old script. During migration, MASF will be configured as an AgentX subagent of SMA. All migration settings will be migrated to the SMA configuration file. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
37 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
38 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
39 |
The migration script aborts if any unrecognized directives are found in either the MASF configuration files or the SMA configuration files. This can be overridden with the \fB-i\fR option. If this option is selected, the behavior is to retain unrecognized directives that were present in the SMA configuration, but remove those present in the MASF configuration. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
40 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
41 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
42 |
The migration script then proceeds to migrate access control and trap configuration. As a side effect of running the migration script, the following directives might be expanded by the script into multiple directives with an equivalent interpretation: |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
43 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
44 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
45 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
46 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
47 |
\fBrwcommunity\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
48 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
49 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
50 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
51 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
52 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
53 |
\fBrocommunity\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
54 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
55 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
56 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
57 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
58 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
59 |
\fBrwuser\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
60 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
61 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
62 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
63 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
64 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
65 |
\fBrouser\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
66 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
67 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
68 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
69 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
70 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
71 |
\fBtrapcommunity\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
72 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
73 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
74 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
75 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
76 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
77 |
\fBtrapsink\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
78 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
79 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
80 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
81 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
82 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
83 |
\fBtrap2sink\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
84 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
85 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
86 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
87 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
88 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
89 |
\fBinformsink\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
90 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
91 |
.SS "Access Control Migration" |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
92 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
93 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
94 |
Access control directives are expanded into the equivalent com2sec, group, access and view directives. Existing group names are renamed by prepending a prefix to avoid conflict with any which may already be defined in SMA. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
95 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
96 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
97 |
When migrating SNMPv1 or v2c access control, a conflict can occur if both MASF and SMA configuration files have defined access permissions for the same community and source address. The default behavior is to abort with a message, unless a use of the \fB-y\fR option specifies otherwise. If \fB-y\fR \fBagent\fR is specified then the MASF configuration takes precedence. If \fB-y\fR \fBmaster\fR is specified then the SMA configuration is retained. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
98 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
99 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
100 |
When migrating USM configuration (SNMPv3), a conflict can occur if both SMA and MASF configurations define a user with the same \fBsecurityName\fR. If this occurs, the behavior of the script is determined by the \fB-u\fR option. If \fB-u\fR \fBagent\fR is specified, the configuration of the user defined in the MASF configuration files is the one that is retained. Otherwise, if the \fB-u\fR \fBmaster\fR option is specified, the use defined in the SMA configuration files is retained. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
101 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
102 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
103 |
By default, the migration script attempts to migrate USM users from MASF to SMA. The script determines whether there are any SNMPv3 users present in the SMA configuration and whether the default \fBengineID\fR has been overridden in the SMA configuration files. If neither of these conditions obtain, then the any \fBusmUser\fR statements containing localized authentication keys can be migrated to SMA, along with the MASF \fBengineID\fR. This results in the \fBengineID\fR of the SMA master agent changing. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
104 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
105 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
106 |
If the script determines that there are existing SNMPv3 users or a manually configured \fBengineID\fR present in the SMA configuration, only those users defined in \fBcreateUser\fR statements are transferred. Those users that were defined in \fBusmUser\fR statements are transferred but will have their passwords reset to a random value. You should notify your users of their new password or reset the password yourself by editing the newly-generated configuration file. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
107 |
.SS "Trap/Inform Migration" |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
108 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
109 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
110 |
The migration script performs a check to determine whether a trap destination defined for MASF is already specified in an existing SMA \fBtrapsink\fR, \fBtrap2sink\fR or \fBinformsink\fR directive. If this is the case, then the directive in the MASF configuration will be discarded to avoid duplicate traps/informs being received. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
111 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
112 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
113 |
\fBtrapsink\fR, \fBtrap2sink\fR and \fBinformsink\fR directives specified in the existing SMA configuration are considered valid destinations for MASF traps/informs and will receive them from the MASF subagent after migration. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
114 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
115 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
116 |
If the \fB-t\fR \fBnone\fR option was specified on the command line, the migration script carries over any remaining MASF trap/inform directives without modification. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
117 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
118 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
119 |
If the \fB-t\fR \fBadd\fR option was specified (the default), the migration script expands any \fBtrapsink\fR, \fBtrap2sink\fR, or \fBinformsink\fR directives to use the \fBTARGET-MIB\fR and \fBNOTIFICATION-MIB\fR. The \fBTARGET-MIB\fR specifies targets using IP addresses, so it might be desirable to use the \fB-t\fR \fBnone\fR option if, for example, the network allocates IP addresses to hostnames dynamically by means of DHCP. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
120 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
121 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
122 |
The expanded directives defines filters specific to the MASF agent so that traps from other subagents will not be received by migrated trap destinations. Existing filters present in the SMA configuration are, by default, not modified and might or might not receive MASF traps, depending upon the filters that were originally defined for them. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
123 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
124 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
125 |
If the \fB-l\fR option is specified, any filters already defined in the \fBTARGET-MIB\fR and the \fBNOTIFICATION-MIB\fR for SMA are extended to include traps from MASF. In the event that a trap destination is already configured in the \fBTARGET-MIB\fR with the same target address and community as an existing MASF trap/inform sink, a conflict will arise. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
126 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
127 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
128 |
If \fB-l\fR \fBagent\fR was specified and a conflict arises, the migration script uses the target SNMP parameters (that is, the SNMP version and choice of trap/inform) defined by the MASF \fBtrap\fR/\fBinformsink\fR directive to send traps to this destination. Otherwise, if the \fB-l\fR \fBmaster\fR option was specified, the conflict will be resolved using the target SNMP parameters specified in the SMA configuration. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
129 |
.SS "Miscellaneous" |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
130 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
131 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
132 |
If the migration script encounters in the MASF configuration file any of the directives listed below and the directives are either not present or differ from the SMA configuration, the script will log a warning message. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
133 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
134 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
135 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
136 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
137 |
\fBsyslocation\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
138 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
139 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
140 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
141 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
142 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
143 |
\fBsyscontact\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
144 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
145 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
146 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
147 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
148 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
149 |
\fBsysname\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
150 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
151 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
152 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
153 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
154 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
155 |
\fBsysservices\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
156 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
157 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
158 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
159 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
160 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
161 |
\fBagentgroup\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
162 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
163 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
164 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
165 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
166 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
167 |
\fBagentuser\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
168 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
169 |
.RS +4 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
170 |
.TP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
171 |
.ie t \(bu |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
172 |
.el o |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
173 |
\fBauthtrapenable\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
174 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
175 |
.SH OPTIONS |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
176 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
177 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
178 |
The following options are supported: |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
179 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
180 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
181 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
182 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
183 |
\fB\fB-?\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
184 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
185 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
186 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
187 |
\fB\fB-\fR\fB-help\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
188 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
189 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
190 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
191 |
Displays usage information. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
192 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
193 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
194 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
195 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
196 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
197 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
198 |
\fB\fB-c\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
199 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
200 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
201 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
202 |
\fB\fB-\fR\fB-no-community\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
203 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
204 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
205 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
206 |
Do not transfer v1/v2c communities. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
207 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
208 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
209 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
210 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
211 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
212 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
213 |
\fB\fB-i\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
214 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
215 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
216 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
217 |
\fB\fB-\fR\fB-ignore-unrecognized-directives\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
218 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
219 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
220 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
221 |
Continue processing if unrecognized directives are present. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
222 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
223 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
224 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
225 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
226 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
227 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
228 |
\fB\fB-l\fR \fBagent\fR | \fBmaster\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
229 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
230 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
231 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
232 |
\fB\fB-\fR\fB-master-trap-target\fR=\fBagent\fR | \fBmaster\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
233 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
234 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
235 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
236 |
If \fBagent\fR is specified, the existing SMA trap targets will be configured to receive traps that were previously sent to destinations for the Sun Fire SNMP agent. If \fBmaster\fR is specified, the targets will be configured to receive Sun Fire SNMP traps, but existing SNMP target parameters will be used. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
237 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
238 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
239 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
240 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
241 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
242 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
243 |
\fB\fB-m\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
244 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
245 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
246 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
247 |
\fB\fB-\fR\fB-no-usmuser\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
248 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
249 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
250 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
251 |
Do not transfer usm (v3) users. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
252 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
253 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
254 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
255 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
256 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
257 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
258 |
\fB\fB-n\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
259 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
260 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
261 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
262 |
\fB\fB-\fR\fB-dry-run\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
263 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
264 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
265 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
266 |
Run the migration without modifying any files. If an error arises, continue processing. This can be used to determine the likely migration issues. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
267 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
268 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
269 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
270 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
271 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
272 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
273 |
\fB\fB-p\fR \fBenable\fR | \fBdisable\fR | \fBerror\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
274 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
275 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
276 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
277 |
\fB\fB-\fR\fB-use-agent-port\fR=\fBenable\fR | \fBdisable\fR | \fBerror\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
278 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
279 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
280 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
281 |
Indicates whether the port originally used by the Sun Fire SNMP agent should be used by the SMA agent after migration (if the two agents are using different ports). If \fBenable\fR is specified, then the port used by the Sun Fire SNMP agent will also be used by the SMA agent after migration. If \fBdisable\fR is specified, the ports used by SMA will not be updated by the migration tool. If the \fBerror\fR option is specified and the SMA agent is not already using the same ports as those used by the original Sun Fire SNMP agent, an error is reported and the migration process is terminated. If no option is specified the default behavior is equivalent to the \fBerror\fR flag. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
282 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
283 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
284 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
285 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
286 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
287 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
288 |
\fB\fB-r\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
289 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
290 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
291 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
292 |
\fB\fB-\fR\fB-no-trap\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
293 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
294 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
295 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
296 |
Do not transfer trap destinations. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
297 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
298 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
299 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
300 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
301 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
302 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
303 |
\fB\fB-s\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
304 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
305 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
306 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
307 |
\fB\fB-\fR\fB-skip-user\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
308 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
309 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
310 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
311 |
If a user is found in the MASF configuration file that cannot be created in the new configuration because of a change in the engine ID, then output a message indicating that the user could not be migrated (needs to be manually recreated) and continue processing. If this option is not present, the migration tool will consider such a situation as an error and abort. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
312 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
313 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
314 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
315 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
316 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
317 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
318 |
\fB\fB-t\fR \fBnone\fR | \fBadd\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
319 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
320 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
321 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
322 |
\fB\fB-\fR\fB-trap-filter\fR=\fBnone\fR | \fBadd\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
323 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
324 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
325 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
326 |
If \fBnone\fR is specified then the script will copy trap directives directly. The administrator might need to manually update the configuration file to ensure traps are only delivered to their intended destinations. If \fBadd\fR is specifed, trap filters will be constructed so that traps originating from the original Sun Fire SNMP agent are delivered only to the destinations that originally received them. The default behavior is \fBadd\fR. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
327 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
328 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
329 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
330 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
331 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
332 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
333 |
\fB\fB-u\fR \fBagent\fR | \fBmaster\fR | \fBerror\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
334 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
335 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
336 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
337 |
\fB\fB-\fR\fB-select-user\fR=\fBagent\fR | \fBmaster\fR | \fBerror\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
338 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
339 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
340 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
341 |
Specifies that if a user with the same name is found in both configuration files that the conflict is to be resolved using the specified configuration file as input. Selecting a user from a particular file will also cause the group declaration for that user to be taken from the same file. If \fBagent\fR is specified then the user will be taken from the configuration file for the Sun Fire SNMP Agent. If \fBmaster\fR is specified, the user will be taken from the SMA configuration. Otherwise, if \fBerror\fR is given, the script will terminate. If this option is not present, the default behavior is equivalent to the \fBerror\fR flag. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
342 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
343 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
344 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
345 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
346 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
347 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
348 |
\fB\fB-V\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
349 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
350 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
351 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
352 |
\fB\fB-\fR\fB-version\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
353 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
354 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
355 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
356 |
Display the version of this script. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
357 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
358 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
359 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
360 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
361 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
362 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
363 |
\fB\fB-y\fR \fBagent\fR | \fBmaster\fR | \fBerror\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
364 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
365 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
366 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
367 |
\fB\fB-\fR\fB-select-community\fR=\fBagent\fR | \fBmaster\fR | \fBerror\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
368 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
369 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
370 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
371 |
Specifies that if a community with the same name is found in both configuration files that the conflict is to be resolved using the specified configuration file as input. If \fBagent\fR is specified then the community will be taken from the configuration file for the Sun Fire SNMP Agent. If \fBmaster\fR is specified, the community will be taken from the SMA configuration. Otherwise, if \fBerror\fR is given, the script will terminate. If this option is not present, the default behavior is equivalent to the \fBerror\fR flag. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
372 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
373 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
374 |
.SH EXAMPLES |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
375 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
376 |
\fBExample 1 \fRSimplest Case |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
377 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
378 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
379 |
The command shown below is appropriate for a simple migration. The migration fails if there are any potential conflicts. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
380 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
381 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
382 |
.in +2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
383 |
.nf |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
384 |
# masfcnv |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
385 |
.fi |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
386 |
.in -2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
387 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
388 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
389 |
\fBExample 2 \fRMigrating Such That MASF Settings Override |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
390 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
391 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
392 |
To migrate the MASF configuration such that it will always succeed, that MASF settings will override in the event of a conflict with SMA, and that access will still be provided on the original MASF port, enter: |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
393 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
394 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
395 |
.in +2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
396 |
.nf |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
397 |
# masfcnv -is -l agent -p enable -u agent -y agent |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
398 |
.fi |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
399 |
.in -2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
400 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
401 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
402 |
\fBExample 3 \fRDry Run, Retaining SMA Settings |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
403 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
404 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
405 |
To attempt a dry run and migrate the configuration such that any conflicts will be resolved by retaining existing SMA settings, enter: |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
406 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
407 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
408 |
.in +2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
409 |
.nf |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
410 |
masfcnv -l master -u master -y master |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
411 |
.fi |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
412 |
.in -2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
413 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
414 |
.SH EXIT STATUS |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
415 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
416 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
417 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
418 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
419 |
\fB\fB0\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
420 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
421 |
.RS 12n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
422 |
.rt |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
423 |
Success. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
424 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
425 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
426 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
427 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
428 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
429 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
430 |
\fB\fBnon-zero\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
431 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
432 |
.RS 12n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
433 |
.rt |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
434 |
A problem occurred during migration. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
435 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
436 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
437 |
.SH FILES |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
438 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
439 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
440 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
441 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
442 |
\fB\fB/etc/sma/snmp/snmpd.conf\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
443 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
444 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
445 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
446 |
\fB\fB/var/sma_snmp/snmpd.conf\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
447 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
448 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
449 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
450 |
SMA configuration files |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
451 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
452 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
453 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
454 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
455 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
456 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
457 |
\fB\fB/etc/opt/SUNWmasf/conf/snmpd.conf\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
458 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
459 |
.br |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
460 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
461 |
\fB\fB/var/opt/SUNWmasf/snmpd.dat\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
462 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
463 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
464 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
465 |
MASF configuration files |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
466 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
467 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
468 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
469 |
.ne 2 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
470 |
.mk |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
471 |
.na |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
472 |
\fB\fB/tmp/sma_migration.log\fR\fR |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
473 |
.ad |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
474 |
.sp .6 |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
475 |
.RS 4n |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
476 |
\fBmasfcnv\fR log file |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
477 |
.RE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
478 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
479 |
.SH ATTRIBUTES |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
480 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
481 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
482 |
See \fBattributes\fR(5) for descriptions of the following attributes: |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
483 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
484 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
485 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
486 |
.TS |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
487 |
tab() box; |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
488 |
cw(2.75i) |cw(2.75i) |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
489 |
lw(2.75i) |lw(2.75i) |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
490 |
. |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
491 |
ATTRIBUTE TYPEATTRIBUTE VALUE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
492 |
_ |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
493 |
Availabilitysystem/management/snmp/net-snmp/documentation |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
494 |
_ |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
495 |
Interface StabilityVolatile |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
496 |
.TE |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
497 |
|
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
498 |
.SH SEE ALSO |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
499 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
500 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
501 |
\fBattributes\fR(5) |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
502 |
.SH NOTES |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
503 |
.sp |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
504 |
.LP |
b497cc6685f1
21210454 add masfcnv.1m to Userland
John Beck <John.Beck@Oracle.COM>
parents:
diff
changeset
|
505 |
The former path to this utility, \fB/usr/sfw/lib\fR, is now a link to \fB/usr/lib\fR. |