Revision A McAfee Client Proxy 2.3.4 Installation Guide (McAfee epolicy Orchestrator) Installing Client Proxy software Client Proxy software Client Proxy consists of server and client software, whose deployment details depend on which management platform you are using. Server software The server software, which you install on the McAfee epo server, adds the Client Proxy server functionality to the McAfee epo platform. Because the server software extends the McAfee epo functionality, it is called the extension software or extension. Client software The client software is checked in to the Master Repository on the McAfee epo server as a package and then deployed to the client computers in your organization. Client computers are called endpoints. Deployment from McAfee epo This table summarizes how the server and client software is deployed when Client Proxy is managed with McAfee epo. Management platform McAfee epo Server software (extension) Install the extension software on the McAfee epo server. Client software (package) Check in the client package to the Master Repository and deploy the package to the endpoints. 1
Client computer requirements Client Proxy software runs on the endpoints in your organization. Before deploying the software to the endpoints, verify that they meet these requirements. Hardware requirements RAM 1 GB minimum (2 GB recommended) Hard disk 300 MB free disk space minimum (500 MB recommended) Supported operating systems on the endpoints The Client Proxy software supports the following operating systems on the endpoints: Windows Server 2008 R2 Windows Server 2012 Windows Server 2012 R2 Windows Server 2016 Windows 7 Windows 8 (Not including Windows 8 RT (Run Time) edition) Windows 8.1 Update 1 Windows 10 Windows 10 Anniversary Update Windows 10, version 1703 Windows 10, version 1709 Windows 10, version 1803 OS X 10.10 (Yosemite) OS X 10.11 (El Capitan) macos 10.12 (Sierra) macos 10.13 (High Sierra) Support for macos 10.13 (High Sierra) Client Proxy supports macos 10.13 (High Sierra) installed on the endpoints. Users must approve the Client Proxy kernel extension on endpoints running macos High Sierra, or the operating system blocks the files from loading. For more information, see McAfee Knowledge Base article KB90232. 2
Deploy Client Proxy with McAfee epo Download the software files Download the Client Proxy server and client software files from the McAfee Content & Cloud Security Portal to your administrator system. 1 Log on to your administrator system as administrator. 2 Go to the McAfee Content & Cloud Security Portal. 3 Enter your user name and password, then click Login. 4 Select Products McAfee Web Gateway 7 Downloads Tools. 5 Under McAfee Client Proxy, click the.zip file icon for the Client Proxy version you want to download, then click Download Save File OK. 6 In your Downloads folder, locate the server software.zip file and save it on your system: MCPSRVER1000_a.b.c.x_package.zip, where a.b.c is the version number of the release, and x is the number of the software build. 7 In your Downloads folder, locate the client software.zip file for the operating system running on the endpoints and save it on your system: Mac OS X or macos Mcpdistribution.zip Windows mcp-win a.b.c Build x Package #y.zip, where a.b.c is the version number of the release, x is the build number, and y is the package number. Install the extension software Install the Client Proxy extension.zip file on the McAfee epo server. The extension.zip file includes: Client Proxy manager (the server software) McAfee Common Catalog 1 From the McAfee epo menu, select Software Extensions. 2 Click Install Extension, then click Browse to locate the extension file MCPSRVER1000_a.b.c.x_package.zip, where a.b.c is the version number of the release, and x is the number of the software build. 3 Select the file, click Open, then click OK to open the Install Package window. 4 Click OK. Check in the client software package Check in the client software package to the Master Repository on the McAfee epo server. 1 From the McAfee epo menu, select Software Master Repository. 2 Click Check In Package. 3
3 For Package type, select Product or Update (.ZIP), then click Browse to locate the client software.zip file corresponding to the operating system running on the endpoints: Mac OS X or macos McpDistribution.zip Windows mcp-win a.b.c Build x Package #y.zip, where a.b.c is the version number of the release, x is the build number, and y is the package number. 4 Select the.zip file, click Open, then click Next. 5 Review the package options, then click Save. The client software package is added to the Packages in Master Repository list. Install the client software on the endpoints Install the client software on the endpoints running Windows, Mac OS X, or macos. Before you begin Before installing the client software, make sure these prerequisites are met: The extension software is installed on the McAfee epo server. The latest build of the client software is checked in to the Master Repository. A compatible build of McAfee Agent is checked in to the Master Repository and installed on the endpoints. After installation, the client software runs immediately without restarting the endpoints, but does not redirect web traffic until a policy is deployed to the endpoints. 1 From the McAfee epo menu, select Systems System Tree. 2 Select the organizational level where you want the client software installed. To select all endpoints managed by your platform, select My Organization. 3 Click Assigned Client s. 4 From the Actions drop-down list, select New Client Assignment. 5 In the Client Assignment Builder, configure these options in the order shown, then click Create New. Product Select McAfee Agent. Type Select Product Deployment. 6 In the Client Catalog: New window, configure these options, then click Save. Name Specify a name for the task. Description (Optional) Describe the task. Target platforms Select Mac or Windows. Products and components From the drop-down list, select the version of McAfee Client Proxy (for Windows) or McAfee Client Proxy for Mac OsX that you want installed on the endpoints. Then from the Action drop-down list, select Install. 7 Click Next to open the Schedule page. 4
8 From the Schedule type drop-down list, select Run immediately, then click Next to open the Summary page. 9 Review the task summary, then click Save. McAfee Agent runs the task the next time it checks for updates. To run the task immediately, issue an agent wake-up call. Remove Client Proxy software with McAfee epo Remove the extension software Remove the extension software from the McAfee epo server. 1 From the McAfee epo menu, select Software Extensions. 2 From the Extensions list, select McAfee Client Proxy. 3 Click Remove. Remove the client software from the endpoints Remove the client software from the endpoints. 1 From the McAfee epo menu, select Systems System Tree. 2 Select the organizational level where you want the client software installed. To select all endpoints managed by your platform, select My Organization. 3 Click Assigned Client s. 4 From the Actions drop-down list, select New Client Assignment. 5 In the Client Assignment Builder, configure these options in the order shown, then click Create New. Product Select McAfee Agent. Type Select Product Deployment. 6 In the Client Catalog: New window, configure these options, then click Save: Name Specify a name for the task. Description (Optional) Describe the task. Target platforms Select Mac or Windows. Products and components From the drop-down list, select the version of McAfee Client Proxy (for Windows) or McAfee Client Proxy for Mac OsX that you want removed from the endpoints. Then from the Action drop-down list, select Remove. 7 Click Next to open the Schedule page. 8 From the Schedule type drop-down list, select Run immediately, then click Next to open the Summary page. 9 Review the task summary, then click Save. 5
McAfee Agent runs the task the next time it checks for updates. To run the task immediately, issue an agent wake-up call. Remove the client software using Windows uninstall tool You can use the Windows uninstall tool to remove the client software from an endpoint. Best practice: Remove the client software using McAfee epo. If removal using McAfee epo is not possible, you can remove the client software using the Windows uninstall tool. To perform these steps remotely, the administrator and user can share the challenge and response codes by email, phone, or text messaging. 1 The user performs these steps on an endpoint running Windows: a Open the Control Panel, then select Programs and Features. b c Right-click McAfee Client Proxy, then click Uninstall. In the Uninstall McAfee Client Proxy dialog box, copy the uninstall code and send it to the administrator. 2 Using the Help Desk software, the administrator generates a release code and sends it to the user. 3 On the endpoint running Windows, the user pastes the release code in the Enter the uninstall password provided by your administrator field, then clicks Ok. The client software is uninstalled from the endpoint running Windows. Copyright 2018 McAfee, LLC McAfee and the McAfee logo are trademarks or registered trademarks of McAfee, LLC or its subsidiaries in the US and other countries. Other marks and brands may be claimed as the property of others. 6 0A00