The following sections provide instructions for manually installing the ZENworks Agent on devices.
NOTE:In addition to manually installing the ZENworks 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 Discovery, Deployment, and Retirement Reference.
NOTE:From ZENworks 23.4 onwards, agent installation and agent update are not supported on Windows 7.
Ensure that the device meets the necessary requirements (see Managed Device Requirements
.
On the target device, open a web browser and navigate 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 (443).
Or
In the ZCC Home page, go to Common Tasks, click Download ZENworks Tools and then click the ZENworks Agent tab.
The web browser displays a list of deployment packages for the ZENworks Agent. For each architecture (32-bit and 64-bit), these are the following 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 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 ZENworks Agent installation except the Microsoft .NET installer.
Standalone: The standalone package installs the pre-agent and extracts all executable files required for ZENworks Agent installation, including Microsoft .NET installer on the target device. The pre-agent then installs the ZENworks Agent from the local device. The standalone package is useful when you need to install the ZENworks 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 ZENworks 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.
Standalone (.NET required): The package contains all files required for ZENworks Agent installation. The package is useful when ZENworks Agent needs to be installed on a device that is currently disconnected from the network.
Network: The package contains signed ZENworks Pre-agent along with the zone details when executed downloads and installs the ZENworks Agent.
Signed ZENworks Pre-Agent / Web-Installer: The package contains only Signed ZENworks Pre-Agent, when executed downloads and installs the ZENworks Agent. On Windows, .NET 4.8 should be installed on the device.
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 that you want to use and 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.
If you choose to install the web-installer.exe, the ZENworks Agent Installation wizard is displayed.
Specify the Server Address and Server Port and click Next.
If the root certificate is not trusted by the trust manager, an alert is displayed. Accept the certificate and click Next.
The summary of server address and server port details where the Agent will be installed is displayed. Review the summary screen and click Next.
If ZENworks security configuration is enabled, then you will be prompted to enter the Authorization Key. Specify the authorization key and click Next.
For information about options that you can use with the package, when launching it from a command line, see Package Options for Windows, Linux, and Macintosh
in ZENworks 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.
After the completion of the installation, the device reboots automatically if you have rebooted 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.
For information about logging in and using the ZENworks Agent on a device, see Using the ZENworks Agent.
Instead of having a ZENworks Server deliver the ZENworks Agent to a device, you can manually download the ZENworks Agent deployment package from the server and install the agent.
IMPORTANT:You can install the ZENworks Agent on Linux if you have root or administrator permissions.
Make sure the device meets the necessary requirements (see Managed Device Requirements
in the ZENworks System Requirements).
On the target device, open a Web browser and navigate 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).
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 (443).
The web browser displays a list of deployment packages. For each architecture (32-bit and 64-bit), these are the following types of packages:
Standalone: The standalone package installs the pre-agent and extracts all executable files required for ZENworks Agent installation, including the JRE installer on the target device. The pre-agent then installs the ZENworks Agent from the local device. The standalone package is useful when you need to install the ZENworks Agent on a device that is currently disconnected from the network. You can save the package to removable media (for example, CD, or USB flash drive) and have the standalone device run the package from the media. The ZENworks Agent is installed on the device, but no registration or management occurs until the device connects to the network.
Network: The package contains signed ZENworks Pre-agent along with the zone details when executed downloads and installs the ZENworks Agent.
Signed ZENworks Pre-Agent / Web-Installer: The package contains only Signed ZENworks Pre-Agent, when executed downloads and installs the ZENworks Agent.
Custom: The package name, Default Agent, refers to the predefined deployment packages. The custom deployment packages that are 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 that 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 that you can use with the package, when launching it from a command line, see Package Options for Windows, Linux, and Macintosh
in ZENworks 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 ./filename command.
If you are using Web-Installer to install the agent, then run the following command:
./<filename>.bin -server <PS_IP> -port <port> -sslignore <true/false>
Filename: Name of the package that was downloaded in Step 3.
PS_IP: URL of the Primary Server (Example: pg-lin-up-ps.epm.blr.novell.com)
Port: Specify the client port configured for the Primary Server.
sslignore: Set to true to ignore the SSL checks.
(Conditional) If you want to view the ZENworks notify icon in the notification area, after the agent installation for the Linux device, log out and log in to the device.
In ZENworks Control Center, the device appears in the \Servers folder or \Workstation folder, on the Devices page.
You can deploy the ZENworks Agent to a Macintosh device by downloading the deployment package from the ZENworks download page.
IMPORTANT:
You can install the ZENworks Agent on a Macintosh device if you have root or administrator permissions.
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:
Network: This package requires network access to the ZENworks Server to download the necessary PKG files.
Standalone: 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 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 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 Agent on a Macintosh device, /opt/microfocus/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/microfocus/zenworks/bin:
Re-login to the device.
Specify the complete path to access the command.
For example: /opt/microfocus/zenworks/bin/zac.