Installing the ZENworks Adaptive Agent

1. On the target device, open a Web browser to the following location:

   https://server/zenworks-setup

   where server is the DNS name or IP address of a ZENworks Server.

   The Web browser displays a list of deployment packages. For each architecture (32-bit and 64-bit), there are two types of packages:

   Network: The network package downloads and installs only the preagent to the target device; the preagent then downloads and installs the ZENworks Adaptive Agent from the ZENworks Server.

   Standalone: The standalone package downloads the preagent and Adaptive Agent to the target device; the preagent then installs the Adaptive Agent from the local device. The standalone package is useful when you need to install the ZENworks Adaptive Agent to a device that is currently disconnected from the network. You can save the package to removable media (CD, USB flash drive, and so forth) and have the standalone device run the package from the media. The Adaptive Agent is installed to the device, but no registration or management occurs until the device connects to the network.

2. Click the name of the deployment package you want to use; save the package to the device’s local drive or run it from the ZENworks Server.

3. If you downloaded the package, launch the package on the device.

   This installation might take several minutes.

4. Upon completion of the installation, a message is displayed asking whether to reboot. Select one of the following options:

   • Do nothing and auto-reboot occurs after 5 minutes.

   • Click Cancel. You will need to reboot later.

   • Click OK to reboot immediately.

   When the device reboots, it is registered in the Management Zone and the ZENworks icon is placed in the notification area (system tray).

   In ZENworks Control Center, the device appears under the \Servers folder structure or \Workstation folder structure on the Devices page.

To create a deployment task:

1. In ZENworks Control Center, click the Deployment tab.

   The Deployable Device panel lists all the devices (imported or discovered) to which you can deploy the Adaptive Agent.

2. In the Deployment Task panel, click New to launch the Deploy Device Wizard. Complete the wizard using information from the following table to fill in the fields.

   Wizard Page and Field	Details
   Enter Deployment Task page Name	Specify a name for the task. The name cannot include any of the following invalid characters: / \ * ? : " ' < > | ` % ~
   Select Devices page	Click Add to display the Discovered Device Browser dialog box. The default view displays all discovered devices in your Management Zone. Click to select a device. When finished selecting devices, click OK to return the Select Devices page. The devices you selected are displayed in the list.
   Enter Credentials page Save Credentials to DataStore	The Enter Credentials page lets you provide the user names and passwords required to deploy the Adaptive Agent to the devices included in the task. Unless you save the credentials, they are stored only in memory. Saved credentials are encrypted in the database for increased security. Credentials that are not saved are cleared from memory if the ZENworks Server is restarted. If your are creating a scheduled deployment task, you might want to save the credentials to ensure that they are still available when the deployment is performed. To deploy the Adaptive Agent, the ZENworks Server must be able to map a drive to the device’s administrative share (ADMIN$). This requires the following credentials: If the device is a member of a domain: You can use a domain Administrator group credential, or you can use a local Administrator group credential. If you use the local credential, you must specify the user name as workstation_name\username to distinguish it from domain credentials. If the device is not a member of a domain: You must use a local Administrator group credential. Depending on your environment, one credential might not provide access to all of the devices where you want to deploy the Adaptive Agent. In this case, you need to add as many credentials as necessary to cover the devices included in the task. The ZENworks Server uses the first credential that works.
   Enter Credentials page Credentials	To add a credential: Click Add to display the Enter Credential Information dialog box.In the Username field, enter the appropriate user name. To deploy the Adaptive Agent, the ZENworks Server must be able to map a drive to the device’s administrative share (ADMIN$). This requires the following credentials: If the device is a member of a domain: You can use a domain or local Administrator group credential. If you use the local credential, you must specify the user name as workstation_name\username to distinguish it from domain credentials. If the device is not a member of a domain: You must use a local Administrator group credential. Enter the user password in the Password and Reenter Password fields. Click OK to save the credential. Depending on your environment, one credential might not provide access to all of the devices where you want to deploy the Adaptive Agent. In this case, you need to add as many credentials as necessary to cover the devices included in the task. The ZENworks Server uses the first credential that works.
   Select Schedule page	The Select Schedule page lets you choose whether you want the task to run as soon as it is created (the Now option) or if you want to schedule the task to run at a future date and time. If you select Scheduled, choose one of the following schedules: No Schedule: Indicates that no schedule has been set. The task does not run until a schedule is set or it is manually launched. This is useful if you want to create the task and come back to it later to establish the schedule or run it manually. Date Specific: Specifies one or more dates on which to run the task. Recurring: Identifies specific days each week, month, or on a fixed interval on which to run the task. Click the Help button for more detailed information about the schedules.
   Select Primary Server page Primary Server	Select the ZENworks Server that you want to perform the deployment task.
   Select Primary Server page Override Zone Windows Proxy Settings	Chose to whether override the Windows Proxy settings configured at the Management Zone. NOTE:This panel is displayed only if a Linux server is selected as the Primary Server. If you want to configure the settings on a task, you must select Override Zone Windows Proxy Settings before you can modify the settings. The Windows Proxy Settings panel lets you specify a managed Windows* device in your zone to perform discovery and deployment tasks in place of a ZENworks® Server. This is designed primarily to enable ZENworks Servers running on Linux* to offload discovery tasks that use Windows-specific discovery technologies such as WMI and WinAPI and deployment tasks that involve Windows managed devices. In order to protect information, such as a discovery credential, that is passed between the ZENworks Server and the Windows Proxy, the connection is secured through SSL. Windows Proxy: Select the managed Windows device (server or workstation) that you want to perform discovery and deployment tasks in behalf of Linux-based ZENworks Servers. Windows Proxy Timeout: Specify the number of seconds you want the ZENworks Server to wait for a response from the Windows Proxy. Any responses received after the specified timeout period are discarded.
   General Options page Deployment Package	Depending upon the processor architecture of the managed device, select the deployment package to be used for installing ZENworks Adaptive Agent on the device. If you are not sure about the device's processor architecture, choose the package with target architecture as All, which applies to 32-bit and 64-bit platforms. If the selected package has been deleted from the Primary Server, then the default deployment package is deployed.
   General Options page Specify Agent Installation Folder	Specify the directory on the managed device where you want to install ZENworks Adaptive Agent. By default, the agent is installed to the directory specified in the %ZENWORKS_HOME% system environmental variable or to the %ProgramFiles%\novell\zenworks directory if the variable is not set on the managed device. Ensure that the installation path does not contain spaces. NOTE:If the directory you specify cannot be created, then the agent is installed in the default location.
   General Options page Reboot Option	After installation of the ZENworks Adaptive Agent, a device must reboot to make the Adaptive Agent functional. Do the following: Select the desired reboot option. Immediate: To reboot immediately after installation of the Adaptive Agent, select Immediate to force the device Manual: To allow the user to manually reboot the device at his or her convenience, select Manual. Scheduled: To reboot the device at a specified time, select Scheduled. Fill in the schedule’s fields. Start Date: Click to display a calender you can use to select a date for the event. Start Time: Specify the time at which the event must start. Use Coordinate Universal Time (UTC): The Start Time is converted to Universal Coordinated Time (UTC). Select this option to indicate that the Start Time you entered is already in Coordinated Universal Time and should not be converted. For example, suppose you are in the Eastern time zone. If you enter 10:00 a.m. and select this option, the Start Time is scheduled for 10:00 UTC. If you do not select this option, the Start Time is scheduled for 14:00 UTC because Eastern time is UTC - 4 hours. (Optional) Select the Do Not Prompt for Reboot option if you do not want the reboot prompt message to be displayed.
   Add Registration Key page	Select a registration key to use during the registration portion of the deployment process. A registration key provides information about the folders and groups to which a device is assigned during registration. Selecting a registration key is optional; if you don’t select one, registration rules are used to determine the folder and group assignments. For more information about registration keys and rules, see Registering Devices.
   Pre/Post Deployment page	Select specify commands that you want run before and after the Adaptive Agent is installed on a device. For example, you can execute operating system commands, run scripts, and launch executables. The commands are passed to the pre-agent as part of the deployment task package. The pre-agent executes the commands in the system space, so you must specify commands that do not require user interaction. Click the Help button for more detailed information about predeployment and post-deployment commands.