Managing NetInfo, Configuring NetInfo | Apple Mac OS X Server

Additional Information About LDAP

The LDAP server in Mac OS X Server is based on OpenLDAP. Additional information about OpenLDAP, including an administrator’s guide, is available at www.openldap.org.

Warning: Apple doesn’t support the OpenLDAP administrator’s guide, so you should carefully test all procedures documented in it before using them on an Open Directory server that’s in service.

Managing NetInfo

NetInfo is the built-in Mac OS X directory service used for the local directory domain on every Mac OS X Server and Mac OS X computer. NetInfo stores information about users and resources and makes it available to Mac OS X processes that want to use it.

Note: NetInfo may not be supported in future releases. Administrators should use dscl and other tools that work on LDAP or NetInfo whenever possible.

Configuring NetInfo

You can use the following tools to manage the NetInfo directory. For more information about a particular tool, see the related man page.

Tool	Used to
NeST	Configure a NetInfo directory domain. There can actually be more
	than one NetInfo directory domain on an upgraded server, and
	NeST can also be used on a client computer’s NetInfo directory
	domain.

nicl	Create, view, and modify entries in the NetInfo directory.

nidomain	Creates and destroys NetInfo directories. Tells you which domains
	are served from which directories by servers running on a
	particular computer.

nifind	Search the NetInfo directory for a particular entry.

nigrep	Search the NetInfo directory for all instances of a string you specify.

nidump	Export NetInfo data to text or flat files.

niload	Import flat files into the NetInfo directory.

nireport	Print tables of NetInfo directory entries.

niutil	Reads from a NetInfo directory and writes to one.

In addition, you can use the NeST tool to get and set authentication methods used by Open Directory Password Server, as described in “Enabling or Disabling Authentication Methods” on page 260.

Chapter 15 Working with Open Directory

259

Image 259

Apple Mac OS X Server manual Managing NetInfo, Additional Information About Ldap, Configuring NetInfo

Contents

Mac OS X Server Apple Computer, Inc Apple Computer, Inc. All rights reserved Contents Preparing the Target Volume for a Clean Installation Installing Server SoftwareLocating Computers for Installation Specifying the Target Computer Volume Managing Network Port Configurations Setting Network PreferencesConfiguring Network Interfaces Viewing or Changing Media Settings Unmounting Volumes Working with Disks and VolumesMounting and Unmounting Volumes Mounting Volumes 141 Listing Connected Users 142 163 171 214 Apache Tomcat JBoss Server 215 MySQL Database Contents 265 Configuring the Active Directory Plug-In Glossary AppendixIndex Contents About This Guide Understanding Notation Conventions Using This GuideCommands and Other Terminal Text Command Parameters and Options Commands Requiring Root Privileges Default Settings Earlier versions of the server Install Mac OS X Server and set it up for the first timeCreate and manage users, groups, and computer lists. Set up This guide Tells you how to Set up and manage QuickTime streaming services Manage directory and authentication services This guide Tells you how to Opening Terminal Executing Commands Folder Specifying Files and FoldersPath string Description Test.c file in the current folder Redirecting Input and Output Modifying Flow ControlRedirect Description Following command in a Terminal window Using Environment Variables Executing Commands and Running Tools Searching for Text Within a File Correcting Typing ErrorsRepeating Commands Including Paths Using Drag and Drop An example of a configured crontab file Terminating CommandsScheduling Tasks Viewing Command Information Sending Commands to a Remote ComputerTo access a man $ hdiutil help $ dig -h $ diff --help Executing Commands How SSH Works Understanding Secure Shell Password-Less Logins Using SSH Keys Updating SSH Key Fingerprints Controlling Access to SSH Service What is an SSH Man-in-the-Middle Attack? You’re prompted for the user’s password Connecting to a Remote ComputerUsing SSH To access a remote computer using ssh To access a remote computer using telnet Using TelnetTo enable Telnet access To disable Telnet access To use installer to install Mac OS X Server software Installing Server Software Locating Computers for Installation To list computers on the local network Specifying the Target Computer VolumePreparing the Target Volume for a Clean Installation To list volumes available for server software Installing from Multiple CDs Automating Server SetupRestarting After Installation To save a configuration file during server setup Creating a Configuration File Installing Server Software and Finishing Basic Setup To provide a passphrase interactively Working with an Encrypted Configuration FileCustomizing a Configuration File To provide a passphrase in a file Sample Configuration File Installing Server Software and Finishing Basic Setup Installing Server Software and Finishing Basic Setup Storing a Configuration File in an Accessible Location Configuring the Server Remotely from the Command Line Using the serversetup Tool Changing Server SettingsUsing the serveradmin Tool To set the server software serial number Viewing, Validating, and Setting the Software Serial NumberGeneral and Network Preferences To display the server’s software serial number To validate a server software serial number To check for available updatesTo install an update Updating Server Software Moving a Server Installing Server Software and Finishing Basic Setup To restart a remote computer immediately Restarting a ComputerAutomatic Restart To restart the local computer Shutting Down a Computer Changing a Remote Computer’s Startup DiskManipulating Open Firmware Nvram Variables Folder Usage Monitoring and Restarting Critical Services Restarting or Shutting Down a Computer To change the computer name Viewing or Changing the Computer NameViewing or Changing the Date and Time To display the computer name Viewing or Changing Network Time Server Usage Viewing or Changing the System DateViewing or Changing the System Time Viewing or Changing the System Time Zone Viewing or Changing Sleep Settings Viewing or Changing the Energy Saver SettingsViewing or Changing Automatic Restart Settings Viewing or Changing the Startup Disk Settings Changing the Power Management Settings Viewing or Changing Apple Event Response Viewing or Changing the Sharing SettingsViewing or Changing the International Settings Viewing or Changing Remote Login Settings Disables the buttons and 1 enables the buttons Viewing and Changing the Login SettingsTo view the current setting Configuring Network Interfaces Setting Network Preferences Viewing Port Names and Hardware Addresses Managing Network Interface InformationViewing or Changing MTU Values Activating Port Configurations Managing Network Port ConfigurationsViewing or Changing Media Settings Creating or Deleting Port Configurations To change the order of the port configurations Managing TCP/IP SettingsChanging a Server’s IP Address Run the changeip tool To change a server’s IP addressTo change the IP address of a standalone server To change TCP/IP settings for a particular port or device To list TCP/IP settings for a configurationTo view TCP/IP settings for port en0 To view TCP/IP settings for a particular port or device Viewing or Changing DNS Servers Working with VLANs Enabling TCP/IPIeee 802.3ad Ethernet Link Aggregation Configuring Ethernet Link Aggregation Configuring a Network Interface Managing Snmp Settings Managing AppleTalk Settings Immediately above it, add this line Installing SnmpOpen the /etc/hostconfig file Locate the line Starting Snmp To stop snmpd Configuring SnmpTo start the snmp agent manually To identify the process id Other options in the menu you were working in are Collecting Snmp Information from the HostTo view the snmp.conf file To start snmpd, execute this as root Viewing or Changing FTP Proxy Settings Managing Proxy Settings Viewing or Changing Gopher Proxy Settings Viewing or Changing Web Proxy SettingsViewing or Changing Secure Web Proxy Settings Viewing or Changing Streaming Proxy Settings Viewing or Changing Socks Firewall Proxy Settings Managing AirPort SettingsViewing or Changing Proxy Bypass Domains Computer Name Managing the Computer, Host, and Bonjour NamesHostname To display the server’s Bonjour name Managing Preference Files and the Configuration DaemonCommand displays 0 if the name was changed Bonjour Name To set the hostname of a system Changing Network LocationsTo get the hostname of a system To view the current locations This example, the network location will switch to AirPortComputer will respond with output similar to the following Understanding Disks, Partitions, and the File System Mounting and Unmounting Volumes To view a list of currently mounted file systems Mounting VolumesUnmounting Volumes To unmount a volume To display disk information To enable diskspacemonitorDisplaying Disk Information Monitoring Disk Space Reclaiming Disk Space Using Log-Rolling Scripts Erasing, Modifying, Verifying, and Repairing Disks To mount a drive To get mount info about a partitionTo erase and repartition a disk Partitioning a Disk To format a Mac OS Extended volume as case-sensitive HFS+Command Description Partitioning and Formatting Disks To fomat a disk Checking for Disk ProblemsLabeling a Disk Formatting a Disk To enable journaling Checking to See If Journaling is EnabledEnabling Journaling for an Existing Volume To see if journaling is enabled Enabling and Disabling Spotlight Enabling Journaling When You Erase a DiskUnderstanding Spotlight Technology Disabling Journaling To view the metadata of a file To enable Spotlight on your serverPerforming Spotlight Searches Restart your server Controlling Spotlight Indexing Managing RAID Volumes To image a boot volume Imaging and Cloning Volumes Using ASRTo repair a failed mirror To restore a volume from an image Understanding Accounts Working with Users and Groups To create an local administrator user with a specific UID Administering and Creating AccountsCreating a Local Administrator User Account for a Server To create a local administrator user account To create a domain administrator user account Creating a Domain Administrator User Account To see if a user is a server administrator Checking a User’s Administrator PrivilegesCreating a Nonadministrator User Account To find the Guid of the administrator user Specify the user ID, replacing 1234 with the new user’s ID 102 Review the Guid for a particular user Retreiving a User’s GuidRemoving a User Account To retrieve a user’s Guid Disable the user account by entering the following command Revoking a User’s Right to Access His or Her AccountTo prevent a user from logging To terminate all of a user’s processes To reenable a user account that is disabled Checking a Server User’s Name, UID, or Password To change a user account attribute to a new value Modifying a User AccountAttribute Description To create a mobile account Creating a Mobile User Account To create a home folder for a particular user Managing Home FoldersTo flush the cache Creating a User’s Home Folder To mount a user’s shared home directory on an AFP server Administering Group AccountsTo create a home folder for users in the local domain Mounting a User’s Home Folder To add a group account Creating a Group Account Removing a Group Account You can remove group accounts by using the dscl toolTo remove a group account Adding a User to a Group You can add users to a group using the dscl toolTo add a user to a group Removing a User from a Group You can remove users from a group by using the dscl toolTo remove a user from a group Review the new settings of the group To create a nested group Creating and Deleting Nested GroupTo verify a nested group To delete a group Editing Group RecordsTo unnest a group To display the information about a particular group See the CreateGroupFolder man page for more information Viewing the Workgroup a User Selects at LoginCreating a Group Folder To create a group folder To import users and groups Importing Users and Groups Writing a Record Description Creating a Character-Delimited User Import FileNumber of attributes in each account record 121 Using the StandardGroupRecord Shorthand Using the StandardUserRecord ShorthandAn example user account looks like this Some examples of permission settings Setting PermissionsViewing Permissions Use one of the following values to set the permission level Setting the umask for Individual Users Use the chmod tool to change permissions for an item Changing PermissionsSee the chmod man page for more information Securing Initial System Accounts Securing System AccountsChanging the Owner Changing the Group Restricting Use of the sudo Tool To disable root loginEnter the root password when prompted Securing the Root Account Securing Single-User Boot To set the Open Firmware password for increased security Setting Password PolicyComputer should restart and display the login window To set a more secure global password policy To change a user’s passwordTo view the global password policy To set the minimum password length to 5 characters To query for a user by name Access the help prompt and enter the command nameFinding User Account Information See the pwpolicy man page for more information 132 Managing Share Points Working with File Services To create a share point Listing Share PointsCreating a Share Point To list existing share points Modifying a Share Point To change share point settings Viewing AFP Settings Managing the AFP ServiceStarting and Stopping AFP Service Checking AFP Service Status To change several settings Changing AFP SettingsList of AFP Settings To change a setting Location of the error log Allow an administrator user to masquerade as another userAuthentication mode. Can be Whether the AFP service should restart automatically when Default = -1unlimited Record user logins in the activity logLogin greeting message Last time the login greeting was set or updated List of AFP serveradmin Commands To list connected users Listing Connected UsersValue returned by getConnectedUsers To disconnect users Disconnecting AFP UsersSending a Message to AFP Users To send a message Value Description Canceling a User DisconnectTo cancel a user disconnect Computer will repond with the following output To list service statistic samples Listing AFP Service StatisticsComputer will respond with the following output Value displayed by Viewing AFP Log FilesTo view the latest entries in a log To display the log paths Viewing NFS Service Settings Managing the NFS ServiceStarting and Stopping NFS Service Checking NFS Service Status Checking FTP Service Status Managing the FTP ServiceStarting FTP Service Stopping FTP Service List of FTP Service Settings Changing FTP Service SettingsParameter ftp Description Own preferences Directory in which the FTP content is storedDisplays a banner message that appears when Prompted to log in to the FTP. Customize to your Viewing the FTP Transfer Log List of FTP serveradmin CommandsChecking for Connected FTP Users Viewing SMB/CIFS Service Settings Managing the SMB/CIFS ServiceStarting and Stopping SMB/CIFS Service Checking SMB/CIFS Service Status List of SMB/CIFS Service Settings Changing SMB/CIFS Service SettingsParameter smb Description Medium service start and stop, authentication failures Browser service. Can be set toAdvanced pane of Windows service settings in the Server Low errors and warnings only This corresponds to the Wins Registration Off and Enable Server’s NetBIOS name. Can be set to a maximumPane of the Windows service settings in the Server Admin Windows service settings in the Server Admin Listing SMB/CIFS Users List of SMB/CIFS serveradmin Commands Computer responds with the following output Disconnecting SMB/CIFS UsersListing SMB/CIFS Service Statistics To list SMB/CIFS connections Managing ACLs Viewing SMB/CIFS Service LogsLocation of the SMB service log Location of the name service log To deny a guest read permission for a file Using chmod to Modify ACLsFollowing are the permissions applicable to folders To grant a user write permission for a file Output should look like the following To view the ACL of a file 160 Understanding the Print Process Working with the Print Service To stop print service Performing Print Service TasksStarting and Stopping Print Service To start print service Viewing Print Service Settings Checking the Status of Print ServiceChanging Print Service Settings Parameter print Description Print Service Settings Parameter printDescription Queue Data Array Command printcommand= Description Managing the Print ServiceFollowing is an example of a queue array parameter block To pause a queue Pausing a QueueListing Queues Listing Jobs and Job Information To hold a job Holding a JobTo release the job Viewing Cover Pages Viewing Print Service Log FilesTo obtain a list of available cover pages 170 To stop NetBoot service Understanding the NetBoot ServiceStarting and Stopping NetBoot Service To start NetBoot service Viewing NetBoot Settings Checking NetBoot Service StatusChanging NetBoot Settings Storage Record Array Changing General Netboot Service SettingsVolume parameter array Parameter netboot Description Image Record Array Filters Record Array To enable NetBoot Enabling NetBoot 1.0 for Older NetBoot ClientsPort Record Array Updating an Image Booting from an ImageUsing hdiutil to Work with System Images Working with System Images Imaging Multiple Clients Using Multicast asr Using asr to Restore System Images To configure a client to receive a multicast stream Choosing a Boot Device Using systemsetup Postfix Agent Understanding the Mail Service Mailman Cyrus Viewing Mail Service Settings Managing the Mail ServiceStarting and Stopping Mail Service Checking the Status of Mail Service Parameter mail Description Mail Service Settings Default = += Default = 500sDefault = 1s Default = domain Default = -=+ Default = 0sDefault = postfix Default = 1000s Default = postdrop Default = flockDefault = flush Default = 60s Default = none Default = 10sDefault = /usr/bin Default = mail Default = fcntl Default = smtpDefault = 7d Default = qmgr Default = host Default = errorDefault = showq Default = 5d Default = bounce Default = incomingDefault = active Default = deferred Default = 600s Default = virtualDefault = $home Default = rewrite Default = c Default = 30sDefault = hash Default = Default Default = auxprop Default = cyrus 193 Listing Mail Service Statistics Mail serveradmin CommandsTo list samples Location of the server log Viewing the Mail Service LogsDefault = srvr.log To display the log locations Backing Up the Mail Files Reconstructing the Mail Database Generating a CSR and Creating a Keychain Setting Up SSL for Mail ServiceEnter a key size at the next prompt, and then press Return 199 To import an SSL certificate into the keychain Accessing the Server CertificatesObtaining an SSL Certificate Importing an SSL Certificate into the Keychain To list the certificates stored in the System keychain Creating a Password FileSee the certadmin man page for more information To create a password file Enabling Sieve Scripting Configuring Mailboxes Sample Sieve Scripts To enable Sieve supportReload the mail service Enabling Sieve Support Basic Sort and Anti-Junk Mail Filter Script Self-Defined Forwarding Script Sieve Scripting Resources 206 Files Location Understanding Web Technology Viewing Web Settings Managing the Web ServiceStarting and Stopping Web Service Checking Web Service Status Serveradmin and Apache Settings Changing Web SettingsChanging Settings Using serveradmin Listing Hosted Sites Web serveradmin CommandsViewing Service Logs Viewing Service Statistics V3-Cache requests per second Value you want to display. Valid valuesV1-Number of requests per second V2-Throughput bytes/sec Addsite File Example Script for Adding a WebsiteAddsite.in File To run the script Tuning the Server Performance To start Apache Tomcat Working with Application Servers and JavaApache Tomcat JBoss Server To stop JBoss, enter the following To install the default databaseMySQL Database To start JBoss, enter the following To start mysqld To set the root passwordTo create a database To set the network option Managing Network Services Working with Network Services Viewing Dhcp Service Settings Managing the Dhcp ServiceStarting and Stopping Dhcp Service Checking the Status of Dhcp Service To change a single Dhcp setting Changing Dhcp Service SettingsDhcp Service Settings To see a list of available service settings About Subnet IDs Dhcp Subnet Settings ArraySubnet Parameter Lease time in seconds General pane of the subnet settings in the ServerNot set default Wins pane of the subnet settings in the Server Domain name such as apple.com Corresponds to the NetBIOS Scope ID field in the WinsAdding a Dhcp Subnet To add a subnet To add a static map Adding a Dhcp Static MapAbout Static Map IDs Determine the location of the Dhcp service logs List of Dhcp serveradmin CommandsViewing the Dhcp Service Log Command Dhcpcommand=Description Viewing DNS Service Settings Managing the DNS ServiceStarting and Stopping the DNS Service Checking the Status of DNS Service Viewing the DNS Service Log Changing DNS Service SettingsDNS Service Settings List of DNS serveradmin Commands Managing the Firewall Service Configuring IP Forwarding Firewall Startup Starting and Stopping Firewall ServiceChecking the Status of Firewall Service Viewing Firewall Service Settings Firewall Service Settings Changing Firewall Service SettingsParameter ipfilter Description Ipfilter Groups with Rules Array Defining Firewall RulesAdding Rules by Modifying ipfw.conf Unmodified ipfw.conf file An example of this would be similar to the following Adding Rules Using serveradminPing cracker.evil.org to determine its IP address To add a rule Ipfilter Rules Array Firewall serveradmin Commands Location of the ipfilter service log Managing the NAT ServiceViewing Firewall Service Log Using Firewall Service to Simulate Network Activity Changing NAT Service Settings Starting and Stopping NAT ServiceChecking the Status of NAT Service Viewing NAT Service Settings NAT serveradmin Commands NAT Service SettingsParameter nat Description Port Mapping Viewing the NAT Service Log Viewing VPN Service Settings Managing the VPN ServiceStarting and Stopping VPN Service Checking the Status of VPN Service Default = IPSec Changing VPN Service SettingsList of VPN Service Settings Default = Keychain Default = Dsacl Default = ManualDefault = L2TP Default = PPP Default = Mppe Default = PptpDefault = EAP-RSA Restarted. See Using the serveradmin Tool on List of VPN serveradmin CommandsViewing the VPN Service Log VPN Service Log on this Location of the VPN service log Configuring Site-to-Site VPNSite-to-Site VPN Adding a VPN Keyagent User Hardware Requirements Setting Up IP FailoverIP Failover Prerequisites IP Failover Operation Enabling IP Failover To enable IP failover Notification Only Configuring IP FailoverPre and Post Scripts To restore the NAT service to its default configuration Restoring the Default Configuration for Server ServicesEnabling PPP Dial-In To restore the DNS service to its default configuration To restore the Dhcp service to its default configurationRe-create the two default records To restore the Qtss service to its default configuration To restore the VPN service to its default configuration Testing Your Open Directory Configuration Using General Directory ToolsUnderstanding Open Directory Registering URLs with SLP Testing Open Directory Plug-insChanging Open Directory Service Settings Modifying a Directory Domain Managing OpenLDAP Configuring LdapPasswordOptionsString LDAPTimeoutUnits Default = minutes LDAPServerBackend Standard Distribution Tools Configuring slapd and slurpd DaemonsTool Used to Searching the Ldap Server Delay RebindIdle Timeout Idle Rebinding Options 256 257 Using Ldif Files Managing NetInfo Configuring NetInfoAdditional Information About Ldap Enabling or Disabling Authentication Methods Managing Open Directory PasswordsOpen Directory Password Server Viewing or Changing Password Policies To load KDC data from a dumped file Kerberos and Apple Single Sign-OnBacking Up the Kerberos Database To dump the KDC’s database To delete a principal To add a service principalPrincipal Management To add a principal To kerberize a service from a terminal running on that host Using Directory Service ToolsOperating on Directory Service Directory Domains Using kadmin to kerberize a service Manipulating a Single Named Group Record Finding Network Information To remove an Ldap server Adding or Removing Ldap Server ConfigurationsConfiguring the Active Directory Plug-In To add an Ldap server 266 Understanding QuickTime Streaming Server Performing Qtss Service Tasks Changing Qtss Settings Starting and Stopping the Qtss ServiceChecking Qtss Service Status Viewing Qtss Settings Look in the sample file for Qtss SettingsDescriptions of Settings Default = qtaccess Default = admin Default = digest Logs on Default = qtssManaging Qtss Listing Current Connections For connections v1, this is integer average number Viewing Qtss Service StatisticsConnections List the Qtss processes Send a HUP signal to this processForcing Qtss to Reread its Preferences To force Qtss to reread its preferences To reset the user name and password Configuring Streaming SecurityResetting the Streaming Server Admin User Name and Password To set up Sites/Streaming/ in older home folders Creating an Access File Controlling Access to Streamed Media Qtusers Between terms, make sure you enclose the entire messageQuotation marks Path and filename of the user file Making Changes to the User or Group File Accessing Protected MediaAdding User Accounts and Passwords Adding or Deleting Groups Create XML text ref movie with extension .qtl Manipulating QuickTime and MP4 MoviesCreating Reference Movies Create QuickTime Atom ref movie with extension .qtl 280 Configuring Your System Logging Configuring the Log File Local Logging Remote Logging Configuring Remote Logging on a Client ComputerTo enable remote logging on a client computer Configuring Remote Logging on a Server Open /etc/rc and locate the following line Or match a single host like this PCI RAID Card Command Reference 286 287 288 Computer account See computer list Glossary Directory node See directory domain Full name See long name 292 293 294 Relay point See open relay Search path See search policy 297 298 Restoring images Logs Lpr Backup Cyrus Mail files AccessSecuring Chgrp tool ACL access control list 136 Example Stopping service Naming 41 Disk journaling Dynamic Host Configuration Protocol. See DhcpError messages command not found Executing commands Image Booting from 176 updating Backing up Principal management 262 tools and utilities Kerberosautoconfig tool 261 keychain QuickTime Streaming Server. See Qtss 302 AFP DNS Used by ldapsearch 255 scheduling tasks Tools for remote configuration 239 Terminating commandsTime, viewing or changing 57 Stopping service Viewing service logs