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 "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. See "Listing Queues" on page 173. 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. Default = "no" An array of values for each server volume used to store boot or installation images. For a description, see "The Storage Record Array" on page 179. netBootStorageRecordsArray. . . 178 Chapter 11 Working with NetBoot Service and System Images Parameter (netboot:) netBootFiltersRecordsArray. . . Description An array of values for each computer explicitly allowed or disallowed access to images. [. . . ] See servers HTTPS CGI POST upload 293 hup signal 277 I iCal service 295 iChat service 296 identity certificates. See certificates idle timeout, LDAP connection 257 IEEE 802. 3ad 73, 74 ifconfig tool 65, 73 images. See NetBoot service importing users and groups 123, 124, 126 See also exporting indexing of volumes 96 inetd daemon 221 input/output commands 23 installation overview 39 server software 39, 41, 42 Index 323 software updates 52 installer tool 39, 182 instant messaging. See iChat service Internet Printing Protocol. [. . . ]