User manual APPLE MAC OS X SERVER 10.5 COMMAND-LINE ADMINISTRATION

[. . . ] Mac OS X Server Command-Line Administration For Version 10. 5 Leopard Apple Inc. © 2007 Apple Inc. All rights reserved. The owner or authorized user of a valid copy of Mac OS X Server software may reproduce this publication for the purpose of learning to use such software. No part of this publication may be reproduced or transmitted for commercial purposes, such as selling copies of this publication or for providing paid-for support services. Every effort has been made to ensure that the information in this manual is accurate. [. . . ] See "Using the serveradmin Tool" on page 50. getLogPaths getQueues setJobState setQueueState writeSettings 172 Chapter 10 Working with the Print Service Listing Queues To list print service queues, use the serveradmin getQueues command. $ sudo serveradmin command print:command = getQueues Pausing and Releasing a Queue You can use the serveradmin setQueueState command to pause or release a queue. To pause a queue: $ sudo serveradmin command print:command = setQueueState print:state = PAUSED print:namesArray:_array_index:0 = queue Control-D Parameter queue Description The name of the queue. To find the name of the queue, use the getQueues command and look for the value of the printer setting. See "Listing Queues" on page 173. To release a queue: $ sudo serveradmin command print:command = setQueueState print:state = RESUMED print:namesArray:_array_index:0 = queue Control-D Listing Jobs and Job Information To list information about print jobs, use the serveradmin getJobs command. $ sudo serveradmin command print:command = getJobs print:maxDisplayJobs = jobs print:queueNamesArray:_array_index:0 = queue Control-D Parameter jobs queue Description The maximum number of jobs to list. To find the name of the queue, use the getQueues command and look for the value of the printer setting. See "Listing Queues" on page 173. Chapter 10 Working with the Print Service 173 For each job, the command lists:  Document name  Document size  Job ID  Submitting user  Submitting host  Job name  Job state  Job priority Holding and Releasing a Job To hold or release a job, use the serveradmin setJobState command. To hold a job: $ sudo serveradmin command print:command = setJobState print:status = HOLD print:jobsArray:_array_index:0:printer = queue print:jobsArray:_array_index:0:idsArray:_array_index:0 = jobid Control-D Parameter queue Description The name of the queue. To find the name of the queue, use the getQueues command and look for the value of the printer setting. To find the ID of the job, use the getJobs command and look for the value of the jobId setting. See "Listing Jobs and Job Information" on page 173. jobid To release the job for printing, change its state to PENDING. To release a job: $ sudo serveradmin command print:command = setJobState print:status = PENDING print:jobsArray:_array_index:0:printer = queue print:jobsArray:_array_index:0:idsArray:_array_index:0 = jobid Control-D 174 Chapter 10 Working with the Print Service Viewing Print Service Log Files and Log Paths To view the contents of the Print service logs and to view log paths, use tail or another file-listing tool. To view the latest entries in a log: $ tail log-file The following are log files for Print service:  /var/log/cups/error_log (CUPS general message log)  /var/log/cups/access_log (CUPS access log)  /var/log/cups/page_log (CUPS page log)  /Library/Logs/PrintService/PrintService. admin. log (Server Admin Print log: logs all Print administrative actions issued from Server Admin)  /Library/Logs/atprintd/<queue-id>. spool. log (AppleTalk spool logs: 1 per shared AppleTalk queue) To see where current logs are located, use the serveradmin getLogPaths command. To view log paths: $ sudo serveradmin command print:command = getLogPaths The computer responds with the following output: print:logPathsArray:_array_index:0:name print:logPathsArray:_array_index:0:path PrintService_admin. log" print:logPathsArray:_array_index:1:name print:logPathsArray:_array_index:1:path print:logPathsArray:_array_index:2:name print:logPathsArray:_array_index:2:path print:logPathsArray:_array_index:3:name print:logPathsArray:_array_index:3:path = "Print Service Admin log" = "/Library/Logs/PrintService/ = = = = = = "CUPS: error_log" "/var/log/cups/error_log" "CUPS: access_log" "/var/log/cups/access_log" "CUPS: page_log" "/var/log/cups/page_log" Viewing Cover Pages To obtain a list of available cover pages: $ sudo serveradmin settings print:coverPageNames This returns a read-only list of permitted values for this setting. The value "none" is not listed as a cover page name but is used to disable the cover page feature for the selected print queue. Chapter 10 Working with the Print Service 175 176 Chapter 10 Working with the Print Service 11 Working with NetBoot Service and System Images 11 Use this chapter to learn the commands to configure and manage NetBoot Service and system images. This chapter describes the commands used to configure and manage NetBoot service. You can use NetBoot to host a standard operating system and application configuration on a server for all clients on a network. Understanding NetBoot Service NetBoot service in Mac OS X Server enables multiple Mac computers to boot from a single server-based disk image, instead of from their internal hard disks. This allows you to create a standard configuration and use it on all desktop computers on a network-- or to host multiple images customized for different workgroups. You can also create server configurations and run all servers from one image. Updating the disk image on the NetBoot server updates all computers when they restart. In addition, you can copy a directory server configuration to all clients using the same system image. Starting and Stopping NetBoot Service To start the service: $ sudo serveradmin start netboot If you get the following response, you have not yet enabled NetBoot on a network port: $ netboot:state = "STOPPED" $ netboot:status = 5000 To stop the service: $ sudo serveradmin stop netboot 177 Viewing NetBoot Service Status To see if the service is running: $ sudo serveradmin status netboot To see complete service status: $ sudo serveradmin fullstatus netboot Viewing NetBoot Settings To list all service settings: $ sudo serveradmin settings netboot Changing NetBoot Settings You can change NetBoot service settings using the serveradmin tool. To change a setting: $ sudo serveradmin settings netboot:setting = value Parameter setting Description A NetBoot service setting. To see a list of available settings, enter $ sudo serveradmin settings netboot or see "Changing General Netboot Service Settings" on this page. value An appropriate value for the setting. To change several settings: $ sudo serveradmin settings netboot:setting = value netboot:setting = value netboot:setting = value [. . . ] Control-D Changing General Netboot Service Settings NetBoot allows client computers to start up from an operating system image stored on your server. To change settings for NetBoot service, use the following parameters with the serveradmin tool: Parameter (netboot:) filterEnabled Description A parameter that specifies whether client filtering is enabled. [. . . ] See Mail service encryption 31, 33, 34, 35, 45, 63 energy saver settings 61 environment variables 24 env tool 24 Ethernet 66, 72, 73, 74 exporting users and groups 127 stopping 152 user connections 155 G globally unique identifier. See GUID gopher proxy settings 79 grep tool 26 group accounts adding users 113 administering 110 creating 111 editing 117 folders 117 managing 99 nested 115 removing 112 removing users 114 storage location 100 workgroups 118 See also groups group folders 117 groups directory domains 265 exporting 127 importing 123, 124, 126 permissions 131 QTSS 281 share points 63 guest accounts 163 GUID (globally unique identifier) 102, 105 F files, specifying 22 file services 137 See also AFP; FTP; NFS; share points file systems mail storage 186 Podcast shared 292, 293 searching 95, 96 workings of 85 See also volumes File Transfer Protocol. See searching fingerprint, RSA 33 Firewall service changing settings 232 command list 236 configuration file 233, 235 default configuration 251 defining rules 233 disabling 231 logs 237 managing 231 network activity simulation 237 proxy settings 79 rules array 233, 236 settings 232 starting 231 status checking 232 stopping 231 folders permissions 130, 131 specifying 22 See also group folders; home folders fsaclctl tool 164 fsck_hfs tool 93 fsck tool 93 FTP (File Transfer Protocol) service commands list 155 logs 155 overview 152 Podcast uploads 293 proxy settings 78 settings 152, 153 starting 152 status checking 152 H hdiutil tool 98, 183 home folders 109, 110, 131 host name 81, 83 hosts. See servers HTTPS CGI POST upload 293 hup signal 277 I iCal service 295 iChat service 296 identity certificates. [. . . ]