Novell Doc: ZENworks 11 SP3 Administration Quick Start - Installing the ZENworks Adaptive Agent

4.3 Installing the ZENworks Adaptive Agent

The following sections provide instructions for manually installing the ZENworks Adaptive Agent on devices.

NOTE:In addition to manually installing the Adaptive Agent, you can automate installation by using network device discovery and deployment. The discovery and deployment process is beyond the scope of this Quick Start. To learn how to use this process, see the ZENworks 11 SP3 Discovery, Deployment, and Retirement Reference.

4.3.1 Manual Installation on Windows

Make sure the device meets the necessary requirements (see Managed Device Requirements in the ZENworks 11 SP3 System Requirements).
On the target device, open a Web browser to the following address:
```
https://server:port/zenworks-setup
```
Replace server with the DNS name or IP address of a ZENworks Server and replace the port only if the ZENworks Server is not using the default port (80 or 443).

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

Network (.NET required): The network (.NET required) package installs only the pre-agent on the target device; the pre-agent then downloads and installs the ZENworks Adaptive Agent from the ZENworks Server. The network (.NET required) package requires that Microsoft .NET 4.0 or later is installed on the device prior to the deployment of the agent to the device.

Standalone (.NET required): The standalone (.NET required) package requires that Microsoft .NET 4.0 or later is installed on the device prior to the deployment of the agent to the device. This package contains all the executable files required for Adaptive Agent installation except the Microsoft .NET installer.

Standalone: The standalone package installs the pre-agent and extracts all executable files required for Adaptive Agent installation, including Microsoft .NET installer on the target device. The pre-agent 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 on) and have the standalone device run the package from the media. The Adaptive Agent is installed on the device, but no registration or management occurs until the device connects to the network.

Custom: The package name, Default Agent, refers to the predefined deployment packages. The custom deployment packages created through Deployment > Edit Deployment Package are shown with the name given during the creation of the package.
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.
If you downloaded the package, launch the package on the device.

For information about options you can use with the package when launching it from a command line, see Package Options for Windows, Linux, and Macintosh in ZENworks 11 SP3 Discovery, Deployment, and Retirement Reference.
IMPORTANT:If you choose to install a complete package, the installation of Windows Installer or .NET Framework might require a reboot after you launch the package. A message is displayed showing various options on rebooting. Select one of the following options:
- Do nothing, and auto-reboot occurs after 5 minutes.
- Click Cancel. You need to reboot later.
- Click OK to reboot immediately.
When the device reboots, the installation automatically resumes.
Upon completion of the installation, the device reboots automatically if you have already reboot the device while installing Windows Installer or .NET Framework.

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 in the \Servers folder or \Workstation folder on the Devices page.
Skip to Section 4.4, Using the ZENworks Adaptive Agent for information about logging in and using the Adaptive Agent on a device.

4.3.2 Manual Installation on Linux

Instead of having a ZENworks Server deliver the Adaptive Agent to a device, you can manually download the Adaptive Agent deployment package from the server and install the agent.

Make sure the device meets the necessary requirements (see Managed Device Requirements in the ZENworks 11 SP3 System Requirements).
On the target device, open a Web browser to the following address:
```
http://server:port/zenworks-setup
```
Replace server with the DNS name or IP address of a ZENworks Server and replace the port only if the ZENworks Server is not using the default port (80 or 443).

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

Network (JRE required): The network (JRE required) package installs only the pre-agent on the target device; the pre-agent then downloads and installs the ZENworks Adaptive Agent from the ZENworks Server. The network (JRE required) package requires that JRE 1.6.0 or later is installed on the device prior to the deployment of the agent to the device.

NOTE:When installing the ZENworks Adaptive Agent to Linux managed devices, the Sun Java Runtime Environment (JRE) is the required JRE. Other JREs are not supported.

Standalone: The standalone package installs the pre-agent and extracts all executable files required for Adaptive Agent installation, including the JRE installer on the target device. The pre-agent then installs the Adaptive Agent from the local device. The standalone package is useful when you need to install the ZENworks Adaptive Agent on a device that is currently disconnected from the network. You can save the package to removable media (CD, USB flash drive, and so on) and have the standalone device run the package from the media. The Adaptive Agent is installed on the device, but no registration or management occurs until the device connects to the network.

Custom: The package name, Default Agent, refers to the predefined deployment packages. The custom deployment packages created through Deployment > Edit Deployment Package are shown with the name given during the creation of the package.
Click the name of the deployment package you want to use, save the package to the device’s local drive, then give executable permissions to the file by running the command chmod 755 filename.

For information about options you can use with the package when launching it from a command line, see Package Options for Windows, Linux, and Macintosh in ZENworks 11 SP3 Discovery, Deployment, and Retirement Reference.
(Optional) On a RHEL device, run the following command:

chcon -u system_u -t rpm_exec_t filename
In the terminal window, go to the directory where you have downloaded the package, then launch the package on the device by running the command ./filename, where filename is the name of the package you downloaded in Step 3.
(Conditional) If you want to view the ZENworks notify icon in the notification area after agent installation for the Linux device, log out of and log in to the device.

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

4.3.3 Manual Installation on Macintosh

You can deploy the ZENworks Adaptive Agent to a Macintosh device by downloading the deployment package from the ZENworks download page. Ensure that you have installed Java 1.6 on the Macintosh device.

NOTE:It is required to install only Apple’s Java Runtime Environment (JRE) on the Macintosh devices for the ZENworks Adaptive Agent to work.

For Macintosh devices that have been upgraded from 10.6.8 to 10.7, ensure you update the JVM version installed on the device before you install the agent.

Watch a video that demonstrates how to install the Adaptive Agent to a Macintosh device

On the target Macintosh device, open a Web browser and enter the following address:

http://<server>/zenworks-setup

Replace <server> with DNS name or the IP address of a ZENworks server.
Click the appropriate Macintosh package to download
NOTE:There are two types of packages for each architecture (32-bit and 64-bit):
- Network (JRE required): This package requires Java 1.6 to be installed on the device prior to the installation of the deployment package. It also requires network access to the ZENworks Server to download the necessary PKG files.
- Standalone (JRE required): This package requires Java 1.6 to be installed on the device prior to the installation of the deployment package. However, access to the ZENworks Server is not required to install the agent.
At the command prompt, specify executable permissions to the downloaded .bin file by running the chmod +x <file_name> command.

For more information on the options that you can use with the package, see Package Options for Windows, Linux, and Macintosh in ZENworks 11 SP3 Discovery, Deployment, and Retirement Reference
At the command prompt, navigate to the directory where you have downloaded the package, then launch the package on the device by running the following command:

sudo ./filename

The filename is the name of the package you downloaded in Step 2.
Log out of and log in to the device to view the ZENworks notify icon in the notification area after agent installation for the Macintosh device.

In ZENworks Control Center, the device appears in the \Servers folder or \Workstation folder on the Devices page.
NOTE:After deploying the ZENworks Adaptive Agent on Macintosh device, /opt/novell/zenworks/bin is not added to the PATH variable and hence the commands in that directory cannot be used directly. Do any of the following on the Macintosh device to run the commands from /opt/novell/zenworks/bin:
- Relogin to the device.
- Specify the complete path to access the command.
For example: /opt/novell/zenworks/bin/zac.