1 | .TH STELLA 1 "10 Feb 2000" "MIT Athena" |
---|
2 | \" RCSID: $Header: /afs/athena.mit.edu/astaff/project/moiradev/repository/moira/man/stella.1,v 1.7 2001-09-13 02:32:21 zacheiss Exp $ |
---|
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-listcontainer\ \fRor\ \fB-lcn\fR |
---|
40 | This will list the Active Directory container membership for the |
---|
41 | specified host. Unlike clusters, a machine may only belong to a |
---|
42 | single container. |
---|
43 | .IP \fB-addcontainer\ \fIcontainer\ \fRor\ \fB-acn\ \fIcontainer\fR |
---|
44 | This will add the specified host to \fIcontainer\fR. |
---|
45 | .IP \fB-deletecontainer\ \fIcontainer\fRor \ \fB-dcn\ \fIcontainer\fR |
---|
46 | This will delete the specified host from \fIcontainer\fR. |
---|
47 | |
---|
48 | .IP \fB-vendor\ \fIvendor\ \fRor\ \fB-V\ \fIvendor\fR |
---|
49 | Update the vendor field for the specified host to \fIvendor\fR. |
---|
50 | .IP \fB-model\ \fImodel\ \fRor\ \fB-M\ \fImodel\fR |
---|
51 | Update the model field for the specified host to \fImodel\fR. |
---|
52 | .IP \fB-os\ \fIos\ \fRor\ \fB-o\ \fIos\fR |
---|
53 | Update the OS field for the specified host to \fIos\fR. |
---|
54 | .IP \fB-location\ \fIlocation\ \fRor\ \fB-L\ \fIlocation\fR |
---|
55 | Update the location field for the specified host to \fIlocation\fR. |
---|
56 | |
---|
57 | .IP \fB-address\ \fIaddress\ \fRor\ \fB-A\ \fIaddress\fR |
---|
58 | Change the address of the given host to \fIaddress\fR. |
---|
59 | .IP \fB-network\ \fInetwork\ \fRor\ \fB-N\ \fInetwork\fR |
---|
60 | Change the network for the given host to \fInetwork\fR. |
---|
61 | |
---|
62 | .IP \fB-opcmt\ \fIop_cmt\ \fRor\ \fB-oc\ \fIop_cmt\fR |
---|
63 | Set the operational comment for the specified host to \fIop_cmt\fR. |
---|
64 | .IP \fB-admcmt\ \fIadm_cmt\ \fRor\ \fB-ac\ \fIadm_cmt\fR |
---|
65 | Set the administrative comment for the specified host to \fIadm_cmt\fR. |
---|
66 | |
---|
67 | .IP \fB-contact\ \fIcontact\ \fRor\ \fB-c\ \fIcontact\fR |
---|
68 | Update the contact information for the given host to \fIcontact\fR. |
---|
69 | .IP \fB-billingcontact\ \fIcontact\ \fRor\ \fB-bc\ \fIcontact\fR |
---|
70 | Update the billing contact information for the given host to \fIcontact\fR. |
---|
71 | .IP \fB-accountnumber\ \fIaccountnumber\ \fRor\ \fB-an\ \fIaccountnumber\fR |
---|
72 | Update the account number information for the given host to |
---|
73 | \fIaccountnumber\fR. |
---|
74 | .IP \fB-status\ \fIstatus\ \fRor\ \fB-S\ \fIstatus\fR |
---|
75 | Set the status of the specified host to \fIstatus\fR. |
---|
76 | |
---|
77 | .IP \fB-owner\ \fIowner\ \fRor\ \fB-O\ \fIowner\fR |
---|
78 | Set the owner of the specified host to \fIowner\fR. |
---|
79 | |
---|
80 | You may specify an owner explicitly, as user:username, list:listname, |
---|
81 | or kerberos:principal_name; or the type may be |
---|
82 | left off if the owner name is non ambiguous. |
---|
83 | .B Stella |
---|
84 | will try first as a user, and if that fails will try the member as a |
---|
85 | list. |
---|
86 | |
---|
87 | .IP \fB-unformatted\ \fRor\ \fB-u\fR |
---|
88 | Display host information with each field on a seperate line, in the |
---|
89 | form "fieldname: value". |
---|
90 | .IP \fB-verbose\ \fRor\ \fB-v\fR |
---|
91 | Give more information. With this flag, stella will display the |
---|
92 | queries it is making to the moira server. |
---|
93 | .IP \fB-noauth\ \fRor\ \fB-n\fR |
---|
94 | Do not attempt to perform Kerberos authentication with the Moira server. |
---|
95 | Most lookup operations should be still possible without tickets. |
---|
96 | .IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR |
---|
97 | Use the specified host and port to contact the Moira database instead of |
---|
98 | the default server. Both may be symbolic names or numbers. If the |
---|
99 | port is left off, the default Moira server port will be assumed. The |
---|
100 | database chosen will be the one specified on the command line, specified |
---|
101 | in the MOIRASERVER environment variable, the hesiod "moira" sloc entry, |
---|
102 | or the compiled in default, in that order or preference. |
---|
103 | |
---|
104 | .IP \fB-create\ \fRor\ \fB-C\fR |
---|
105 | This will create the specified host, with information provided by other |
---|
106 | options. By default, the host will be owned by NONE and will be active. |
---|
107 | .IP \fB-delete\ \fRor\ \fB-D\fR |
---|
108 | This will delete the specified host, if the status field is already set |
---|
109 | to Deleted (3). |
---|
110 | .IP \fB-rename\ \fInewname\ \fRor\ \fB-R\ \fInewname\fR |
---|
111 | This will rename the given host to \fInewname\fR. |
---|
112 | |
---|
113 | .SH AUTHORS |
---|
114 | Nickolai Zeldovich. |
---|
115 | .SH SEE ALSO |
---|
116 | moira(1) |
---|
117 | |
---|
118 | .SH DIAGNOSTICS |
---|
119 | An exit status of 2 indicates a problem contacting the server. An exit |
---|
120 | status of 1 indicates that the arguments could not be parsed or some |
---|
121 | query to the moira server returned an error. An exit status of 0 |
---|
122 | indicates that all operations requested completed successfully. |
---|
123 | |
---|
124 | .SH NOTES |
---|
125 | The hostname doesn't actually have to be the first argument, but if |
---|
126 | you put it anywhere else, it's easy to get the other arguments in the |
---|
127 | wrong order and do something other than what you intended. |
---|
128 | |
---|