'\"
.\" @(#)setdomainname.1m	1.3 05 Oct 1998 SMI
.\" Copyright (c) 1999, Sun Microsystems, Inc.
.\" All Rights Reserved
\" Copyright (c) AT&T 1997. All rights reserved
.\" @(#)setdomainname.rof	1.4 5/22/97
.TH setdomainname 1m "24 Sept 1998"
.if n .tr \--
.SH NAME
setdomainname - changes the name of a SunLink Server domain.
.SH SYNOPSIS
.nf
.ft4
setdomainname [ -n new-domain-name [ -s ] ]
.SH DESCRIPTION
The setdomainname command is used to change the name of a 
SunLink Server domain.
It is an interactive command but also accepts command line arguments.
.sp .5
If an error occurs during processing or if you interrupt this command, 
it will restore the original domain name.  
You should run this command on the primary domain controller
first, and then on any backup domain controllers.
This command must be run on every server within a domain.  
.sp .5
Otherwise, domain-wide services will not work correctly.
.sp .5
You must be logged in as root to run this command.
.SH OPTIONS
.SS -n new-domain-name
Represents the new name of the domain.
.SS -s
Prevents the server from starting automatically.
.SH EXAMPLE
If a server is a backup domain controller named sales_bdc in 
the domain sales, and you want to rename it to localsales, 
you can use the setdomainname command.
.sp .5
You either can run the setdomainname command and respond to 
individual prompts, or you can type the following command:
.sp .5
	setdomainname -n localsales -s