Apple oxs manual Serversetup, Determining Whether a Service Needs to be Restarted

Notes About Specific Commands and Tools

serversetup

The serversetup utility is located in /System/Library/ServerSetup. To run this command, you can type the full path, for example:

$ /System/Library/ServerSetup/serversetup -getAllPort

Or, if you want to use the utility to perform several commands, you can change your working directory and type a shorter command:

$ cd /System/Library/ServerSetup

$ ./serversetup -getAllPort

$ ./serversetup -getDefaultInfo

or add the directory to your search path for this session and type an even shorter command:

$ PATH = "$PATH:/System/Library/ServerSetup"

$ serversetup -getAllPort

To permanently add the directory to your search path, add the path to the file /etc/profile.

serveradmin

You can use the serveradmin tool to perform many service-related tasks. You’ll see it used throughout this guide.

Determining Whether a Service Needs to be Restarted

Some services need to be restarted after you change certain settings. If a change you make using a service’s writeSettings command requires that you restart the service, the output from the command includes the setting <svc>:needsRecycleOrRestart with a value of yes.

Important: The needsRecycleOrRestart setting is displayed only if you use the serveradmin svc:command = writeSettings command to change settings. You won’t see it if you use the serveradmin settings command.

Chapter 1 Typing Commands

19