]>
Commit | Line | Data |
---|---|---|
fe68bb0f | 1 | .TH STELLA 1 "10 Feb 2000" "MIT Athena" |
2 | \" RCSID: $Header$ | |
3 | .SH NAME | |
4 | stella \- examine and modify information about hosts in Moira | |
5 | .SH SYNOPSIS | |
6 | .B stella hostname [options] | |
7 | .SH DESCRIPTION | |
8 | .I Stella | |
9 | is a tool for updating information about hosts in Moira. It supports | |
10 | all host modification commands and a few options to change cluster | |
11 | mapping. | |
12 | ||
13 | If no options are specified, it will assume \fI-info\fR, which will | |
14 | result in all information about the specified host being displayed. | |
15 | ||
16 | .SH OPTIONS | |
17 | ||
18 | .IP \fB-info\ \fRor\ \fB-i\fR | |
19 | Display information about a host. This is the default mode if no other | |
20 | options are given. The output is similar to that of moira. | |
21 | ||
22 | .IP \fB-addalias\ \fIaliasname\ \fRor\ \fB-a\ \fIaliasname\fR | |
23 | This will add \fIaliasname\fR as an alias for the given host. This | |
24 | option can be specified multiple times with different alias names | |
25 | on the same command line. | |
26 | .IP \fB-deletealias\ \fIaliasname\ \fRor\ \fB-d\ \fIaliasname\fR | |
27 | This will remove the alias \fIaliasname\fR for the given host. This | |
28 | option can be specified multiple times with different alias names | |
29 | on the same command line. | |
30 | ||
31 | .IP \fB-listmap\ \fRor\ \fB-lm\fR | |
32 | This will list cluster mappings for the specified host; that is, | |
33 | the clusters to which the host belongs. | |
34 | .IP \fB-addmap\ \fIcluster\ \fRor\ \fB-am\ \fIcluster\fR | |
35 | This will add the specified host to \fIcluster\fR. | |
36 | .IP \fB-deletemap\ \fIcluster\ \fRor\ \fB-dm\ \fIcluster\fR | |
37 | This will delete the specified host from \fIcluster\fR. | |
38 | ||
39 | .IP \fB-vendor\ \fIvendor\ \fRor\ \fB-V\ \fIvendor\fR | |
40 | Update the vendor field for the specified host to \fIvendor\fR. | |
41 | .IP \fB-model\ \fImodel\ \fRor\ \fB-M\ \fImodel\fR | |
42 | Update the model field for the specified host to \fImodel\fR. | |
43 | .IP \fB-os\ \fIos\ \fRor\ \fB-o\ \fIos\fR | |
44 | Update the OS field for the specified host to \fIos\fR. | |
45 | .IP \fB-location\ \fIlocation\ \fRor\ \fB-L\ \fIlocation\fR | |
46 | Update the location field for the specified host to \fIlocation\fR. | |
47 | ||
48 | .IP \fB-address\ \fIaddress\ \fRor\ \fB-A\ \fIaddress\fR | |
49 | Change the address of the given host to \fIaddress\fR. | |
50 | .IP \fB-network\ \fInetwork\ \fRor\ \fB-N\ \fInetwork\fR | |
51 | Change the network for the given host to \fInetwork\fR. | |
52 | ||
53 | .IP \fB-opcmt\ \fIop_cmt\ \fRor\ \fB-oc\ \fIop_cmt\fR | |
54 | Set the operational comment for the specified host to \fIop_cmt\fR. | |
55 | .IP \fB-admcmt\ \fIadm_cmt\ \fRor\ \fB-ac\ \fIadm_cmt\fR | |
56 | Set the administrative comment for the specified host to \fIadm_cmt\fR. | |
57 | ||
58 | .IP \fB-contact\ \fIcontact\ \fRor\ \fB-c\ \fIcontact\fR | |
59 | Update the contact information for the given host to \fIcontact\fR. | |
89ef8830 | 60 | .IP \fB-billingcontact\ \fIcontact\ \fRor\ \fB-bc\ \fIcontact\fR |
61 | Update the billing contact information for the given host to \fIcontact\fR. | |
fe68bb0f | 62 | .IP \fB-status\ \fIstatus\ \fRor\ \fB-S\ \fIstatus\fR |
63 | Set the status of the specified host to \fIstatus\fR. | |
64 | ||
65 | .IP \fB-owner\ \fIowner\ \fRor\ \fB-O\ \fIowner\fR | |
66 | Set the owner of the specified host to \fIowner\fR. | |
67 | ||
68 | You may specify an owner explicitly, as user:username, list:listname, | |
c71e8a44 | 69 | or kerberos:principal_name; or the type may be |
fe68bb0f | 70 | left off if the owner name is non ambiguous. |
71 | .B Stella | |
72 | will try first as a user, and if that fails will try the member as a | |
f88aafc6 | 73 | list. |
fe68bb0f | 74 | |
75 | .IP \fB-verbose\ \fRor\ \fB-v\fR | |
76 | Give more information. With this flag, stella will display the | |
77 | queries it is making to the moira server. | |
78 | .IP \fB-noauth\ \fRor\ \fB-n\fR | |
79 | Do not attempt to perform Kerberos authentication with the Moira server. | |
80 | Most lookup operations should be still possible without tickets. | |
81 | .IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR | |
82 | Use the specified host and port to contact the Moira database instead of | |
83 | the default server. Both may be symbolic names or numbers. If the | |
84 | port is left off, the default Moira server port will be assumed. The | |
85 | database chosen will be the one specified on the command line, specified | |
86 | in the MOIRASERVER environment variable, the hesiod "moira" sloc entry, | |
87 | or the compiled in default, in that order or preference. | |
88 | ||
89 | .IP \fB-create\ \fRor\ \fB-C\fR | |
90 | This will create the specified host, with information provided by other | |
91 | options. By default, the host will be owned by NONE and will be active. | |
92 | .IP \fB-delete\ \fRor\ \fB-D\fR | |
93 | This will delete the specified host, if the status field is already set | |
94 | to Deleted (3). | |
95 | .IP \fB-rename\ \fInewname\ \fRor\ \fB-R\ \fInewname\fR | |
96 | This will rename the given host to \fInewname\fR. | |
97 | ||
98 | .SH AUTHORS | |
99 | Nickolai Zeldovich. | |
100 | .SH SEE ALSO | |
101 | moira(1) | |
102 | ||
103 | .SH DIAGNOSTICS | |
104 | An exit status of 2 indicates a problem contacting the server. An exit | |
105 | status of 1 indicates that the arguments could not be parsed or some | |
106 | query to the moira server returned an error. An exit status of 0 | |
107 | indicates that all operations requested completed successfully. | |
108 | ||
109 | .SH NOTES | |
110 | The hostname doesn't actually have to be the first argument, but if | |
111 | you put it anywhere else, it's easy to get the other arguments in the | |
112 | wrong order and do something other than what you intended. | |
113 |