Note |
The information in this topic applies only to System Center
2012 Configuration Manager SP1. |
Client installation and management for Mac computers in
System Center 2012 Configuration Manager requires
public key infrastructure (PKI) certificates. Configuration Manager
can request and install a user client certificate by using
Microsoft Certificate Services with an enterprise certification
authority (CA) and the Configuration Manager enrollment point and
enrollment proxy point site system roles. Or, you can request and
install a computer certificate independently from Configuration
Manager if the certificate meets the requirements for Configuration
Manager. PKI certificates secure the communication between the Mac
computers and the Configuration Manager site by using mutual
authentication and encrypted data transfers.
Important |
Configuration Manager Mac clients always perform certificate
revocation checking; unlike Configuration Manager clients that run
on Windows, you cannot disable this certificate revocation list
(CRL) checking function. If Mac clients cannot confirm the
certificate revocation status for a server certificate because they
cannot locate the CRL, they will not be able to successfully
connect to Configuration Manager site systems, such as management
points and distribution points. Especially for Mac clients in a
different forest to the issuing certification authority, check your
CRL design to ensure that Mac clients can locate and connect to a
CRL distribution point (CDP) for connecting site system
servers. |
Before you install the Configuration Manager client on a Mac
computer, decide how to install the client certificate:
- Use Configuration Manager enrollment by using
the CMEnroll tool and follow the steps in the next section of this
topic. The enrollment process does not support automatic
certificate renewal so you must re-enroll Mac computers before the
installed certificate expires.
- Use a certificate request and installation
method that is independent from Configuration Manager. For this
installation method, see the Use a Certificate Request and
Installation Method that is Independent from Configuration
Manager section in this topic.
Mac clients are automatically assigned to the Configuration
Manager site that manages them. Mac clients install as
Internet-only clients, which means that they will communicate with
the site system roles (management points and distribution points)
in their assigned site when you configure these site system roles
to allow client connections from the Internet. They do not
communicate with site system roles outside their assigned site.
Use the following steps and the supplemental procedures to
install, configure, and manage Mac computers for Configuration
Manager. The steps cover the following:
- Deploy PKI certificates for the site system
servers (web server certificate and client authentication
certificate).
- Prepare the certificate template for the Mac
computer.
- Configure the site system servers to support
Mac computers.
- Configure the enrollment site system
roles.
- Configure client settings for enrollment.
- Download the client source files for Mac
clients.
- Install the client and enroll the client
certificate on the Mac computer.
Steps to Install and Configure the
Client for Mac Computers
Use the following table for the steps, details, and
more information about how to install and configure the client for
Mac computers.
Steps |
Details |
More information |
Step 1: Deploy a web server certificate to site system
servers.
|
These site systems might already have this certificate for other
Configuration Manager clients. If not, deploy a web server
certificate to the following computers that hold the following site
system roles:
- Management point
- Distribution point
- Enrollment point
- Enrollment proxy point
Important |
The web server certificate must contain the Internet FQDN that
is specified in the site system properties. |
|
For an example deployment that creates and installs this web
server certificate, see the
Deploying the Web Server Certificate for Site Systems that Run
IIS section in the Step-by-Step Example
Deployment of the PKI Certificates for Configuration Manager:
Windows Server 2008 Certification Authority topic.
Important |
Make sure that you specify the Internet FQDN in the web server
certificate for the management point, the distribution point, and
the enrollment proxy point. |
|
Step 2: Deploy a client authentication certificate to
site system servers.
|
These site systems might already have this certificate for
Configuration Manager functionality. If not, deploy a client
authentication certificate to the following computers that hold the
following site system roles:
- Management point
- Distribution point
|
For an example deployment that creates and installs the client
certificate for management points, see the Deploying
the Client Certificate for Computers section in the Step-by-Step Example
Deployment of the PKI Certificates for Configuration Manager:
Windows Server 2008 Certification Authority topic.
For an example deployment that creates and installs the client
certificate for distribution points, see the
Deploying the Client Certificate for Distribution Points
section in the Step-by-Step Example
Deployment of the PKI Certificates for Configuration Manager:
Windows Server 2008 Certification Authority topic.
|
Step 3: Prepare the client certificate template for Mac
computers.
Note |
To run the Configuration Manager enrollment tool, you must have
an Active Directory user account. |
|
The certificate template must have Read and Enroll
permissions for the user account that will enroll the certificate
on the Mac computer.
|
See the Deploying
the Client Certificate for Mac Computers section in the
Step-by-Step
Example Deployment of the PKI Certificates for Configuration
Manager: Windows Server 2008 Certification Authority topic.
|
Step 4: Configure the management point and distribution
point.
|
Configure management points for the following options:
- HTTPS
- Allow client connections from the
Internet
- Allow mobile devices and Mac computers to use
this management point
Although distribution points are not required to install the
client on Mac computers, you must configure distribution points to
allow client connections from the Internet if you want to deploy
software to these Mac computers after the Configuration Manager
client is installed.
|
See the following procedure in this topic: Step 4: Configuring Management Points and
Distribution Points to support Mac Computers.
|
Step 5: Configure the enrollment proxy point and the
enrollment point.
|
You must install both these site system roles in the same site
but you do not have to install them on the same site system server,
or in the same Active Directory forest.
|
For more information about site system role placement and
considerations, see the
Planning Where to Install Sites System Roles in the Hierarchy
section in the Planning for Site
Systems in Configuration Manager topic.
To configure the enrollment proxy point and the enrollment
point, see the following procedure in this topic: Step 5: Installing and
Configuring the Enrollment Site Systems.
|
Step 6: Optional:
- Install the reporting services point
|
Install the reporting services point if you want to run reports
for Mac computers.
|
For more information about how to install and configure the
reporting services point, see Configuring Reporting in
Configuration Manager.
|
Step 7: Configure client settings for enrollment.
|
You must use the default client settings to configure enrollment
for Mac computers; you cannot use custom client settings.
|
For more information about client settings, see About Client Settings in
Configuration Manager.
For information about how to configure these client settings,
see the following procedure in this topic: Step 7: Configuring the
Client Settings for Enrollment.
|
Step 8: Download the client source files for Mac
clients.
|
Download the installation files and then install them on the Mac
computer.
|
See the following procedure in this topic: Step 8: Download and Install the Mac Client
Files.
|
Step 9: Install the client and then enroll the client
certificate on the Mac computer.
|
When you use Configuration Manager enrollment, you must first
install the client by using the Ccmsetup application, and then
enroll the client certificate by using the CMEnroll tool.
|
See the following procedure in this topic: Step 9: Installing the Client and
Enrolling the Certificate by using the CMEnroll Tool on the Mac
computer.
|
Supplemental Procedures to Install
and Configure the Client for Mac Computers
Use the following information when the steps in the
preceding table require supplemental procedures.
Step 4: Configuring Management
Points and Distribution Points to support Mac Computers
This procedure configures existing management points
and distribution points to support Mac computers. Before you start
this procedure, make sure that the site system server that runs the
management point and distribution point is configured with an
Internet FQDN. In addition, these site system roles must be in a
primary site.
To configure management points and
distribution points to support Mac computers
-
In the Configuration Manager console, click
Administration.
-
In the Administration workspace, expand Site
Configuration, select Servers and Site System Roles, and
then select the server that holds the site system roles to
configure.
-
In the details pane, right-click Management
point, click Role Properties, and in the Management
Point Properties dialog box, configure the following options,
and then click OK:
- Select HTTPS.
- Select Allow Internet-only client connections or
Allow intranet and Internet client connections. These
options require that an Internet FQDN is specified in the site
system properties.
- Select Allow mobile devices and Mac computers to use this
management point.
-
In the details pane, right-click Distribution
point, click Role Properties, and in the Distribution
Point Properties dialog box, configure the following options,
and then click OK:
- Select HTTPS.
- Select Allow Internet-only client
connections or Allow intranet and Internet client
connections. These options require that an Internet FQDN is
specified in the site system properties.
- Click Import certificate, browse to
the exported client distribution point certificate file, and then
specify the password.
-
Repeat steps 2 through 4 in this procedure for all
management points and distribution points in primary sites that you
will use with Mac computers.
Step 5: Installing and Configuring
the Enrollment Site Systems
These procedures configure the site system roles to
support Mac computers. Choose one of these procedures, depending on
whether you will install a new site system server to support Mac
computers or use an existing site system server:
To install and configure the
enrollment site systems: New site system server
-
In the Configuration Manager console, click
Administration.
-
In the Administration workspace, expand Site
Configuration, and click Servers and Site System
Roles
-
On the Home tab, in the Create group,
click Create Site System Server.
-
On the General page, specify the general
settings for the site system, and then click Next.
Important |
Make sure that you specify the Internet FQDN, even if it is the
same value as the intranet FQDN. Mac computers always connect to
the Internet FQDN, even when they are on the intranet. |
-
On the System Role Selection page, select
Enrollment proxy point and Enrollment point from the
list of available roles, and then click Next.
-
On the Enrollment Proxy Point page, review the
settings and make any changes that you require, and then click
Next.
-
On the Enrollment Point Settings page, review
the settings and make any changes that you require, and then click
Next.
-
Complete the wizard.
To install and configure the
enrollment site systems: Existing site system server
-
In the Configuration Manager console, click
Administration.
-
In the Administration workspace, expand Site
Configuration, select Servers and Site System Roles, and
then select the server that you want to use to support Mac
computers.
-
On the Home tab, in the Create group,
click Add Site System Roles.
-
On the General page, specify the general
settings for the site system, and then click Next.
Important |
Make sure that you specify the Internet FQDN, even if it is the
same value as the intranet FQDN. Mac computers always connect to
the Internet FQDN, even when they are on the intranet. |
-
On the System Role Selection page, select
Enrollment proxy point and Enrollment point from the
list of available roles, and then click Next.
-
On the Enrollment Proxy Point page, review the
settings and make any changes that you require, and then click
Next.
-
On the Enrollment Point Settings page, review
the settings and make any changes that you require, and then click
Next.
-
Complete the wizard.
Step 7: Configuring the Client
Settings for Enrollment
This step is required for Configuration Manager to
request and install the certificate on the Mac computer.
To configure the default client
settings for Configuration Manager to enroll certificates for Mac
computers
-
In the Configuration Manager console, click
Administration.
-
In the Administration workspace, click Client
Settings.
-
Click Default Client Settings.
Important |
You cannot use a custom client setting for the enrollment
configuration; you must use the default client settings. |
-
On the Home tab, in the Properties group,
click Properties.
-
Select the Enrollment section, and then
configure the following user settings:
- Allow users to enroll mobile devices and Mac
computers:Yes
- Enrollment profile: Click Set Profile.
-
In the Mobile Device Enrollment Profile dialog
box, click Create.
-
In the Create Enrollment Profile dialog box,
enter a name for this enrollment profile, and then configure the
Management site code. Select the Configuration
Manager SP1 primary site that contains the management points
that will manage the Mac computers.
Note |
If you cannot select the site, check that at least one
management point in the site is configured to support mobile
devices. |
-
Click Add.
-
In the Add Certification Authority for Mobile
Devices dialog box, select the certification authority (CA)
server that will issue certificates to Mac computers, and then
click OK.
-
In the Create Enrollment Profile dialog box,
select the Mac computer certificate template that you created in
Step 3, and then click OK.
-
Click OK to close the Enrollment Profile
dialog box, and then click OK to close the Default Client
Settings dialog box.
Tip |
If you want to change the client policy interval, use the
Client policy polling interval client setting in the
Client Policy client setting group. |
All users will be configured with these settings when
they next download client policy. To initiate policy retrieval for
a single client, see the Initiate
Policy Retrieval for a Configuration Manager Client section in
the How to
Manage Clients in Configuration Manager topic.
In addition to the enrollment client settings, ensure
that you have configured the following Configuration Manager client
device settings:
Step 8: Download and Install the Mac
Client Files
You must download and install the following programs
before you can install and manage the Configuration Manager client
on Mac computers:
- Ccmsetup: Use this application to
install the Configuration Manager client on Mac computers in your
organization.
- CMDiagnostics: Use this tool to
collect diagnostic information related to the Configuration Manager
client on Mac computers in your organization.
- CMUninstall: Use this tool to
uninstall the Configuration Manager client from Mac computers in
your organization.
- CMAppUtil: Use this tool to convert
Apple application packages into a format that can be deployed as a
Configuration Manager application.
- CMEnroll: Use this tool to request and
install the client certificate for a Mac computer so that you can
then install the Configuration Manager client.
These programs are contained in a Windows Installer
file named ConfigmgrMacClient.msi. This file is not supplied on the
Configuration Manager installation media. You can download this
file from the Microsoft Download Center.
To download and install the Mac OS X
client files
-
Download the Mac OS X client file package,
ConfigmgrMacClient.msi from the Microsoft Download Center and save this
file to a computer that runs Windows.
-
On the Windows computer, run the
ConfigmgrMacClient.msi file that you just downloaded to
extract the Mac client package, Macclient.dmg to a folder on the
local disk (by default C:\Program Files (x86)\Microsoft\System
Center 2012 Configuration Manager Mac Client\).
-
Copy the Macclient.dmg file to a folder on the Mac
computer.
-
On the Mac computer, run the Macclient.dmg file that
you just downloaded to extract the files to a folder on the local
disk.
-
In the folder, ensure that the files Ccmsetup and
CMClient.pkg are extracted and that a folder named Tools is created
that contains the CMDiagnostics, CMUninstall, CMAppUtil and
CMEnroll tools.
Step 9: Installing the Client and
Enrolling the Certificate by using the CMEnroll Tool on the Mac
computer
This procedure installs the client and then uses the
CMEnroll tool to request and install the client certificate for a
Mac computer so that you can then manage this computer by using
Configuration Manager.
To install the client and enroll the
certificate by using the CMEnroll tool
-
On the Mac computer, navigate to the folder where you
extracted the contents of the Macclient.dmg file that you
downloaded from the Microsoft Download Center.
-
Enter the following command-line: sudo
./ccmsetup
-
Wait until you see the Completed installation
message. Although the installer displays a message that you must
restart now, do not restart now but continue to the next step.
-
From the Tools folder on the Mac computer, type the
following: sudo ./CMEnroll -s
<enrollment_proxy_server_name> -ignorecertchainvalidation -u
<'user name'> [-p <password>]
If you do not specify the optional -p <password>,
you are then prompted to type the password.
The user name can be in the following formats:
- 'domain\name’. For example:
'contoso\mnorth'
- 'user@domain'. For example:
'mnorth@contoso.com'
The user name and corresponding password must match an
Active Directory user account that is granted Read and Enroll
permissions on the Mac client certificate template.
Example: If the enrollment proxy point server is named
server02.contoso.com, and a user name of
contoso\mnorth with a password of Passw0rd! has been
granted permissions for the Mac client certificate template, type
the following: sudo ./CMEnroll -s server02.contoso.com
–ignorecertchainvalidation -u 'contoso\mnorth' -p Passw0rd!
Note |
For a more seamless user experience, you can script the
installation steps and commands so that users only have to supply
their user name and password. |
-
Wait until you see the Successfully enrolled
message.
-
Restart the Mac computer.
Verify that the client installation is successful by
opening the Configuration Manager item in System
Preferences on the Mac computer. You can also update and view
the All Systems collection to confirm that the Mac computer
now appears in this collection as a managed client.
Tip |
To help troubleshoot any problems with the Mac client, you can
use the CMDiagnostics program that is included with the Mac OS X
client package to collect the following diagnostic information:
- A list of running processes
- The Mac OS X operating system version
- Mac OS X crash reports relating to the
Configuration Manager client including CCM*.crash and
System Preference.crash.
- The Bill of Materials (BOM) file and property
list (.plist) file created by the Configuration Manager client
installation.
- The contents of the folder
/Library/Application Support/Microsoft/CCM/Logs.
The information collected by CmDiagnostics is added to a zip file
that is saved to the desktop of the computer and is named
cmdiag-<hostname>-<date and
time>.zip. |
Uninstalling the Mac Client
If you want to uninstall the Mac client, use the
CMUninstall script that is provided with the Mac client files you
downloaded from the web. Use the following procedure to help you
uninstall the Configuration Manager client from Mac computers.
To uninstall the Mac client
-
On a Mac computer, open a terminal window and navigate
to the folder where you extracted the contents of the macclient.dmg
file that you downloaded from the Microsoft Download Center.
-
Navigate to the Tools folder and enter the following
command-line:
./CMUninstall -c
Note |
The –c property instructs the client uninstall to also
remove and client crash logs and log files. This is optional, but a
best practice to help avoid confusion if you later reinstall the
client. |
Renewing the Mac Client
Certificate
A typical validity period for the Mac client
certificate is 1 year. Configuration Manager does not automatically
renew the user certificate that it requests during enrollment, so
you must use the following procedure to renew the certificate.
This procedure removes the SMSID, which is required to
request a new certificate for the same Mac computer. After the new
certificate is requested, it is automatically used by Configuration
Manager.
Important |
When you remove and replace the client SMSID, any stored client
history such as inventory is deleted after you delete the client
from the Configuration Manager console. |
To renew the Mac client
certificate
-
Create a device collection for the Mac computers that
must renew the user certificates, and then add the Mac computers to
the collection.
Warning |
Configuration Manager does not monitor the validity period of
the certificate that it enrolls for Mac computers. You must monitor
this independently from Configuration Manager to identify the Mac
computers to add to this collection. |
-
In the Assets and Compliance workspace, start
the Create Configuration Item Wizard.
-
On the General page of the wizard, specify the
following information:
- Name:Remove SMSID for Mac
- Type:Mac OS X
-
On the Supported Platforms page of the wizard,
ensure that all Mac OS X versions are selected.
-
On the Settings page of the wizard, click
New and then, in the Create Setting dialog box,
specify the following information:
- Name:Remove SMSID for Mac
- Setting type:Script
- Data type:String
-
In the Create Setting dialog box, for
Discovery script, click Add script to specify a
script that discovers Mac computers with an SMSID configured.
-
In the Edit Discovery Script dialog box, enter
the following Shell Script:
|
Copy Code |
defaults read com.microsoft.ccmclient SMSID
|
-
Click OK to close the Edit Discovery
Script dialog box.
-
In the Create Setting dialog box, for
Remediation script (optional), click Add script to
specify a script that removes the SMSID when it is found on Mac
computers.
-
In the Create Remediation Script dialog box,
enter the following Shell Script:
|
Copy Code |
defaults delete com.microsoft.ccmclient SMSID
|
-
Click OK to close the Create Remediation
Script dialog box.
-
On the Compliance Rules page of the wizard,
click New, and then in the Create Rule dialog box,
specify the following information:
- Name:Remove SMSID for Mac
- Selected setting: Click Browse
and then select the discovery script that you specified
previously.
- In the following values field, enter
The domain/default pair of (com.microsoft.ccmclient, SMSID) does
not exist.
- Enable the option Run the specified
remediation script when this setting is noncompliant.
-
Complete the Create Configuration Item Wizard.
-
Create a configuration baseline that contains the
configuration item that you have just created and deploy this to
the device collection that you created in step 1.
For more information about how to create and deploy
configuration baselines, see How to Create
Configuration Baselines for Compliance Settings in Configuration
Manager and How to Deploy
Configuration Baselines in Configuration Manager.
-
On Mac computers that have the SMSID removed, run the
following command to install a new certificate:
|
Copy Code |
sudo ./CMEnroll -s <enrollment_proxy_server_name> -ignorecertchainvalidation -u <'user name'> [-p <password>]
|
-
Restart the Mac computer.
Use a Certificate Request and
Installation Method that is Independent from Configuration
Manager
When you do not use Configuration Manager enrollment
but instead, request and install the client certificate
independently from Configuration Manager, the configuration steps
are slightly different:
- Perform steps 1, 2, 4, 6 (optional), and 8.
- Do not perform steps 3, 5, 7, and 9.
- Install the client by using the following instructions.
To install the client certificate
independently from Configuration Manager and install the client
-
To install the client certificate independently from
Configuration Manager, use the instructions that accompany your
chosen certificate deployment method to request and install the
client certificate on the Mac computer.
-
To make sure that this certificate is accessible to
Configuration Manager, on the Mac computer, open a terminal window
and make the following changes:
- Enter the command sudo /Applications/Utilities/Keychain\
Access.app/Contents/MacOS/Keychain\ Access
- In the Keychain Access dialog box, in the
Keychains section, click System, and then, in the
Category section, click Keys.
- Expand the keys to view the client certificates. When you have
identified the certificate with a private key that you have just
installed, double-click the key.
- On the Access Control tab, select Allow all
applications to access this item.
- Click Save Changes and close the Keychain Access
dialog box.
-
Navigate to the folder where you extracted the contents
of the macclient.dmg file that you downloaded from the Microsoft
Download Center.
-
Enter the following command-line: sudo ./ccmsetup
–MP <management point Internet FQDN> -SubjectName
<certificate subject value>
Important |
The certificate subject value is case-sensitive, so type it
exactly as it appears in the certificate details. |
Example: If the Internet FQDN in the site system
properties is server03.contoso.com and the Mac client
certificate has the FQDN of mac12.contoso.com as a common
name in the certificate subject, type: sudo ./ccmsetup –MP
server03.contoso.com –SubjectName mac12.contoso.com
-
Wait until you see the Completed installation
message and then restart the Mac computer.
Verify that the client installation is successful by
opening the Configuration Manager item in System
Preferences on the Mac computer. You can also update and view
the All Systems collection to confirm that the Mac computer
now appears in this collection as a managed client.
Renewing the Mac Client
Certificate
Use the following procedure before you renew the
computer certificate on Mac computers.
This procedure removes the SMSID, which is required for
the client to use a new or renewed certificate on the Mac computer.
Because Configuration Manager does not support a certificate
selection criteria for Mac computers, either request the new
certificate with a different Subject value, or use the same Subject
value but delete the original certificate from the keychain
store.
Important |
When you remove and replace the client SMSID, any stored client
history such as inventory is deleted after you delete the client
from the Configuration Manager console. |
To renew the Mac client
certificate
-
Create a device collection for the Mac computers that
must renew the computer certificates, and then add the Mac
computers to the collection.
-
In the Assets and Compliance workspace, start
the Create Configuration Item Wizard.
-
On the General page of the wizard, specify the
following information:
- Name:Remove SMSID for Mac
- Type:Mac OS X
-
On the Supported Platforms page of the wizard,
ensure that all Mac OS X versions are selected.
-
On the Settings page of the wizard, click
New and then, in the Create Setting dialog box,
specify the following information:
- Name:Remove SMSID for Mac
- Setting type:Script
- Data type:String
-
In the Create Setting dialog box, for
Discovery script, click Add script to specify a
script that discovers Mac computers with an SMSID configured.
-
In the Edit Discovery Script dialog box, enter
the following Shell Script:
|
Copy Code |
defaults read com.microsoft.ccmclient SMSID
|
-
Click OK to close the Edit Discovery
Script dialog box.
-
In the Create Setting dialog box, for
Remediation script (optional), click Add script to
specify a script that removes the SMSID when it is found on Mac
computers.
-
In the Create Remediation Script dialog box,
enter the following Shell Script:
|
Copy Code |
defaults delete com.microsoft.ccmclient SMSID
|
-
Click OK to close the Create Remediation
Script dialog box.
-
On the Compliance Rules page of the wizard,
click New, and then in the Create Rule dialog box,
specify the following information:
- Name:Remove SMSID for Mac
- Selected setting: Click Browse
and then select the discovery script that you specified
previously.
- In the following values field, enter
The domain/default pair of (com.microsoft.ccmclient, SMSID) does
not exist.
- Enable the option Run the specified
remediation script when this setting is noncompliant.
-
Complete the Create Configuration Item Wizard.
-
Create a configuration baseline that contains the
configuration item that you have just created and deploy this to
the device collection that you created in step 1.
For more information about how to create and deploy
configuration baselines, see How to Create
Configuration Baselines for Compliance Settings in Configuration
Manager and How to Deploy
Configuration Baselines in Configuration Manager.
-
After you have installed a new certificate on Mac
computers that have the SMSID removed, run the following command to
configure the client to use the new certificate:
|
Copy Code |
sudo defaults write com.microsoft.ccmclient SubjectName –string <Subject_Name_of_New_Certificate>
|
-
Restart the Mac computer.
See Also