'\"
.\" @(#)setservername.1m	1.2 01 Oct 1998 SMI
.\" Copyright (c) 1999, Sun Microsystems, Inc.
.\" All Rights Reserved
.\" Copyright (c) AT&T 1997. All rights reserved.
.\" @(#)setservername.rof	1.2 3/26/96
.TH setservername 1m "30 Sep 1997"
.if n .tr \--
.SH NAME
setservername - changes the name of a SunLink Server.
.SH SYNOPSIS
.nf
.ft4
setservername [ -n newname -p password -a administrator [ -d pdc_name ] [-s] ]
.SH DESCRIPTION
The setservername command is used to change the name of a SunLink Server.  
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 server name.
.sp .5
If you are changing the name of a backup domain controller, 
you need to supply the name of the primary domain controller, 
which must be running and connected to the network.  
You also will be prompted for the name of an existing 
administrative account and password in the domain.  
This permits the command to connect to the primary domain controller, 
to configure the new server name into the domain and to remove the 
old server name from the domain.
.sp .5
You must be logged in as root to run this command.
.SH OPTIONS
.SS -n
Represents the new server name.
.SS -p
Is the password for the administrative account.
.SS -a
Is the name of the administrative account.
.SS -d pdc_name
Is (for a backup domain controller) the name of the primary 
domain controller in 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 sales2, you can use the setservername command. 
.sp .5
You either can run the setservername command and respond to individual 
prompts, or you can type the following command:
.sp. 5
	setservername -n sales2 -p pass1 -a admin1 -d sales1 -s