4.1 Performing the Installation

  1. Start the ZENworks installation program by using one of the following methods:

    Graphical User Interface (GUI) Installation

    1. On the installation server, insert the Novell ZENworks 11 installation DVD.

      For Windows, the installation page where you can select the language is displayed. If it is not automatically displayed after inserting the DVD, run setup.exe from the root of the DVD.

      For Linux, mount the DVD, then run sh /media/cdrom/setup.sh. Using the sh command resolves rights issues.

    2. If you installed an external OEM Sybase server (see Section 3.3.4, Installing an External ZENworks Database), you must run the executable manually with the following parameter in order for that database to be properly updated during this Primary Server installation:

      DVD_drive\setup.exe -o

    3. Continue with Step 2 below.

      NOTE:When installing ZENworks 11 SP1SP2 on Windows, Strawberry Perl is installed in the root directory to meet the Perl runtime requirement for the ppkg_to_xml tool that should run on both Windows and Linux. This tool is required to read the RPM package files to extract the package metadata and create Linux bundles or Dependency bundles with these packages.

    Command Line Installation (Linux only)

    1. On the installation server, insert the Novell ZENworks 11 installation DVD.

    2. Mount the DVD.

    3. To start a command line installation, do the following:

      1. To a directory where all (including “others”) have read and execute access, either mount the DVD or copy the DVD’s files.

        This cannot be in /root or any directory under it.

        If you copy the DVD's files, make sure that all (including “others”) continue to have read and execute access to the destination directories.

      2. Run the following command:

        sh /mount_location/setup.sh -e

      For more information on installation arguments, see Section A.0, Installation Executable Arguments.

    4. Continue with Step 2 below.

  2. During installation, refer to the information in Table 4-1, Installation Information for details on the installation data that you need to know.

    If you are using the GUI installation, you can also click the Help button for similar information.

    For the command line method, you can type back and press Enter to return to a previous installation option to make changes.

  3. Do one of the following on the Windows device:

    • If you selected to reboot automatically (you selected the Yes, restart the system option during installation; see Rebooting (or not)), continue with Verifying Installation after the booting process has completed and the services have started.

    • If you selected to reboot manually (you selected the No, I will restart the system myself option during installation; see Rebooting (or not)), you must wait for the installation to complete and the services to start in order to verify it in Verifying Installation.

    NOTE:On Windows or Linux, part of completing the installation process is for the database to be updated and for the PRU to be downloaded and installed, both of which cause high CPU utilization during their processes. This can cause the services to start up slowly, which can also affect how long it takes for ZENworks Control Center to open.

  4. Continue with Section 4.3, Verifying Installation.

  5. Do any of the following that are applicable, then continue with Step 4:

The information you need is listed in the order of the installation flow.

Table 4-1 Installation Information

Installation Information

Explanation

Installation path

For Windows, the default is %ProgramFiles%. You can change it to any path currently available on the server except to the %systemdrive%/Program Files directory if the server is a 64-bit Windows device. However, the installation path that you specify must contain English characters only.

NOTE:On the Windows server, installation of ZENworks 11 from mapped drive is not supported.

The installation program creates the Novell\ZENworks directory here for the installation of the ZENworks software files.

IMPORTANT:If you want to install Reporting Server on a 64-bit Windows device that is using an Oracle database, you must specify a customized location to install ZENworks Configuration Management. This customized location must not include any parentheses in the pathname because Reporting Server fails to install in a path that has parentheses.

NOTE:If you want to install ZENworks Reporting Server, ensure that short MS-DOS (also called 8.3) style naming convention is available for the installation location of the ZENworks 11 Server. By default, 8.3 is enabled on the device. For more information on how to enable 8.3 see, Microsoft documentation

If you need more disk space for your content repository than is in the Windows path that is available during installation, you can change the path to another location after completing the installation. For more information, see .

For Linux, several fixed installation paths are used:

/opt/novell/zenworks/

/etc/opt/novell/zenworks

/var/opt/novell/zenworks

/var/opt/novell/log/zenworks/

If you are concerned about disk space on the Linux server, the /var/opt directory is where the database and content repository reside. Make sure it is on a partition large enough for them.

Response file path (optional)

If you started the installation executable with the -s parameter, you are required to provide a path for the file. The default path is C:\Documents and Settings\Administrator\, which you can change to any path available on the current server.

The Primary Server software is not installed when you run the program to create a response file. It only displays the installation pages necessary to identify and create the response file.

Prerequisites

If the required prerequisites are not installed, you are not allowed to continue with the installation. The requirements that are not fulfilled are displayed (GUI) or listed (command line). For more information, see Section 1.1, Primary Server Requirements.

If the .NET prerequisite is not fulfilled, you can click the ZENworks link in the description to install the runtime version that is bundled with ZENworks. After .NET is installed, the installation of ZENworks proceeds. This wizard might take a few seconds to launch.

Management Zone

New Zone: If you are installing to the first server in the zone, you need to know what name you want for the Management Zone and what you want to use for the zone’s password, which is used for logging in to ZENworks Control Center.

The zone name has a 20-character limit and should be a unique name. The zone name can contain only the following special characters: - (dash) _ (underscore) . (period). The zone name cannot contain special characters such as ~ ` ! @ # % ^ & * + = ( ) { } [ ] | \ : ; " ' < > , ? / $

The zone administrator password must contain at least six characters and is limited to a maximum of 255 characters. The password can contain only one instance of the $ character.

By default, the login username is Administrator. After completing the installation, you can use ZENworks Control Center to add other administrator names that can be used to log in to the Management Zone.

During the installation of the second (or subsequent) Primary Server, the server by default uses the ports used by first Primary Server. If the ports are in use on the second Primary Server, you are asked to specify another port. Note which port you specify because you will need to use it in the URL for accessing ZENworks Control Center.

Existing Zone: If you are installing to an existing Management Zone, you need to know the following information:

  • Server identification (either the DNS name or IP address). This is an existing Primary Server in the zone. We recommend using the DNS name to provide ongoing synchronization with certificates that are signed with DNS names.

  • SSL Port used by the existing Primary Server in the Management Zone. If this Primary Server uses a different port than the default (443), specify that server port.

  • The username for logging in to ZENworks Control Center. The default is Administrator. After completing the installation, you can use ZENworks Control Center to add other administrator names that can be used to log in to the Management Zone.

  • The administrator’s password. Specify the current password for the ZENworks administrative user specified in the Username field.

Database options

For ZENworks 11 , a database must be established. The database options are displayed only when the first server is installed to the zone. However, you can run the installation program specifically to install or repair a database (see Section 3.3.4, Installing an External ZENworks Database).

You have the following database options:

  • Embedded Sybase SQL Anywhere: Automatically installs the embedded database on the local server.

    If you select the embedded database option, no further database installation pages are shown.

  • Remote Sybase SQL Anywhere: This database must already exist on a server in your network. It can be on the current server.

    To select this option, you should already have followed the steps in Prerequisites for Remote Sybase SQL Anywhere.

    You also use this option for installing to an existing remote OEM Sybase database.

  • Microsoft SQL Server: You can create a new SQL database or specify an existing database that resides on a server in your network. It can be on the current server.

    Creating a new SQL database at this time provides the same results as the steps in Prerequisites for Microsoft SQL Server.

  • Oracle: Specifies a user schema that you can use to set up an external Oracle database schema for use with ZENworks.

    You can either create a new user schema or specify an existing one that resides on a server in your network.

    To select this option, you should already have followed the steps in Prerequisites for Oracle.

IMPORTANT:The following points must be considered for external databases:

  • The time on the server hosting the database must be synchronized with each of the Primary Servers in the Management Zone. The external database can also reside on the local machine.

  • If you have specified the database hostname, it must be DNS resolvable.

Database information

For the external database options (Remote Sybase SQL Anywhere, Microsoft SQL Server, and Oracle), you need to know the information listed below. Defaults are provided for some of this information, which can be changed as necessary.

  • All Databases: The database server must have a Sybase SQL Anywhere, Microsoft SQL, or Oracle database installed.

    • Server’s name. We recommend that you identify the server by its DNS name rather than its IP address, to be in sync with certificates that are signed with DNS names.

      IMPORTANT:If you later change your database server’s IP address or DNS name, make sure that your corporate DNS server is updated with this change to keep DNS for the database server in sync.

    • Port used by the database server.

      Port 2638 is the default for Sybase SQL Anywhere and port 1433 is the default for Microsoft SQL Server.

      Change the default port number if you have a conflict.

  • (Optional) SQL Server Only: Named instance that is the name of the SQL server instance that is hosting the existing ZENworks database. You must specify the named instance if you want it to be something other than the default of mssqlserver.

  • Oracle Only: The name of the tablespace where you want the database to be created. By default, it is USERS.

  • New Database:   

    • The database administrator (Username field) must have read/write permissions in order to successfully perform the required operations on the database.

    • The administrator’s database password.

  • SQL Server or New Database:   

    • If you are using Windows authentication, specify the Windows domain where the user you specified in the Username field exists. If you are not using a Windows domain, specify the server’s short name.

    • Whether to use Windows or SQL Server authentication. For Windows authentication, provide the credentials for a user on the current device or in the domain. For SQL authentication, provide credentials that match those of a valid SQL user.

    It is important to know whether you installed the SQL Server by using SQL authentication, Windows authentication, or mixed. Be sure to select the option that coincides with your SQL Server options or the authentication will fail.

Database access

For the external database options (Remote Sybase SQL Anywhere, Microsoft SQL Server, and Oracle), you need to know the information listed below. Defaults are provided for some of this information, which can be changed as necessary.

  • All Databases: This server must have a Sybase SQL Anywhere, Microsoft SQL, or Oracle database installed.

    • Database name. Replace zenworks_MY_ZONE with either the desired database name, or an existing database name.

    • Database username. This user must have read/write permissions to modify the database.

      If Windows authentication is also selected, the specified user must already exist when you create a new SQL database. The user is granted login access to SQL Server and read/write access to the ZENworks database that is created.

      For an existing database, specify a user with sufficient permissions to the database.

    • Database password. For a new database, this password is automatically generated if SQL authentication is selected. For an existing database, specify the password of an existing user with read/write permissions to the database.

  • Sybase Databases Only: The name of your Sybase SQL Anywhere database server.

  • Oracle Databases Only: The name of the tablespace where you want the database to be created. By default, it is USERS.

  • Microsoft SQL Databases Only:   

    • If you are using Windows authentication, specify the Windows domain where the user you specified in the Username field exists. If you are not using a Windows domain, specify the server’s short name.

    • Whether to use Windows or SQL Server authentication. For Windows authentication, provide the credentials for a user on the current device or in the domain. For SQL authentication, provide credentials that match those of a valid SQL user.

    It is important to know whether you installed the SQL Server by using SQL authentication, Windows authentication, or mixed. Be sure to select the option that coincides with your SQL Server options or the authentication will fail.

SSL configuration (shown only for first server installed in the Management Zone)

In order to enable SSL communications, an SSL certificate must be added to the ZENworks server. Select whether to use an internal or external certificate authority (CA).

For subsequent installations of Primary Servers to the Management Zone, the CA established by the first server’s installation is used for the zone.

IMPORTANT:After you install ZENworks 11 , you can only change the internal certificate to an external certificate on Primary Servers. For more information, see .

The Restore Default buttons restore the paths to those that were displayed when you first accessed this page.

Signed SSL certificate and private key

To enter a trusted CA-signed certificate and private key, click Choose to browse for and select the certificate and key files, or specify paths to the signed certificate to be used for this server (Signed SSL Certificate), and the private key associated with the signed certificate (Private Key).

For subsequent installations of Primary Servers to the zone, the CA established for the zone by the first server’s installation is used. If the zone is using internal CA, you must provide the IP address or DNS name of the Primary Server with CA role. Otherwise, the wizard will not proceed further.

For information on creating external certificates to select when installing to a Linux or Windows server, see Section 3.3.3, Creating an External Certificate.

For information on creating external certificates for installing to a server using a silent installation, see Section 4.2.1, Creating Your Response File.

Root certificate (optional)

To enter a trusted CA root certificate, click Choose to browse for and select it, or specify the path to the CA’s public X.509 certificate (CA Root Certificate).

License key for Configuration Management, Asset Management, Endpoint Security Management and Asset Inventory for UNIX/Linux

By default, the Evaluate check box is selected for all the ZENworks 11 products listed on the page. The products include:

  • ZENworks 11 Configuration Management

  • ZENworks 11 Asset Management

  • ZENworks 11 Asset Inventory for UNIX/Linux

  • ZENworks 11 Endpoint Security Management

If you choose to retain the default settings, all the products are installed with a 60-day trial license.

Additionally, you can choose to do any of the following:

  • Install the licensed version of the product: Specify the license key that you obtained when you purchased the product. The Evaluate check box is automatically deselected when you specify the license key.

  • Choose the products to be installed: If you do not want to install either the licensed version or the evaluation version of a product, manually deselect the Evaluate check box and do not specify the license key for the product. However, you must install the licensed version or the evaluation version of one of the following products:

    • ZENworks 11 Configuration Management

    • ZENworks 11 Asset Management

    • ZENworks 11 Endpoint Management

    Additionally, you can install the licensed version or the evaluation version of ZENworks 11 Asset Inventory for UNIX/Linux.

    If you choose to activate or evaluate only one of the ZENworks products, the other ZENworks products are also automatically installed; however, they are deactivated. You can activate them later through the ZENworks Control Center. For more information on how to activate the product, see .

License key for Patch Management

The ZENworks 11 Patch Management software is automatically installed. However, the product is activated for patch downloads only if the following conditions are met:

You can activate the subscription service later through the ZENworks Control Center. For more information, see .

If you specify the license key, you must additionally specify the company name and the e-mail address.

If you do not want to install ZENworks 11 Patch Management, manually deselect the Activate check box and do not specify the license key for the product. The product is automatically installed; however, it is deactivated.

Pre-installation summary

GUI Installation: To make changes to any information entered up to this point, click Previous. After you click Install, the installation of the files begins. During installation, you can click Cancel to stop, which leaves the files on your server that were installed up to that point.

Command Line Installation: If you want to make changes to any information entered up to this point, you can type back and press Enter as many times as necessary. As you progress forward through the commands again, press Enter to accept the decisions that you previously made.

Installation complete (roll back option)

If installation errors occurred, this page is displayed at this time; otherwise, it is displayed after the Post-Installation Actions page.

Installation Recovery: For both the GUI and command line installations, if there are serious installation errors you can roll back the installation to return your server to its previous state. This option is provided on a different installation page. Otherwise, you have two options:

  • If a previous installation was cut short and you install again, you might be given the option to reset the installation, depending on how far you got in the canceled installation. If you select to reset, this overwrites any configuration that might have occurred during the canceled installation.

  • To undo a successfully completed installation, follow the instructions in Section 6.0, Uninstalling ZENworks Software.

If there were serious installation errors, select Roll Back, which returns your server to its previous state. Upon exiting the installation program, the server is not rebooted. However, to complete the installation, you must reboot the server.

To determine whether to continue the installation or roll it back, review the log file that lists the errors to determine if any installation failures were significant enough for your action. If you select to continue, resolve the issues that are noted in the log after you have rebooted the server and completed the installation process.

To access the log file in the GUI installation, click View Log. In the command line installation, the path to the log file is displayed.

Post installation actions

Options are presented for selecting actions to perform after installation of the software has successfully completed:

  • For the GUI installation, a page displays the options listed below. Some items are selected by default. Click any check box to select or deselect the option, then click Next to continue.

  • For a command line installation, the options are listed with option numbers. Select or deselect an option by typing its number to toggle its selection status. After configuring the selections, press Enter without typing a number to continue.

Select from the following possible actions:

  • Run ZENworks Control Center: (GUI installation only) Automatically opens ZENworks Control Center in your default Web browser after rebooting (Windows only), or immediately if you select to reboot manually or you installed to a Linux server. For a Linux installation without a GUI, a GUI-enabled device must be used to run ZENworks Control Center.

    For the Oracle database, the administrator names are case sensitive. The default ZENworks administrator account automatically created during installation uses an initial capital. In order to log in to ZENworks Control Center, you must enter Administrator.

  • Place a shortcut to ZENworks Control Center on the Desktop: (Windows only) Places the shortcut on your desktop.

  • Place a shortcut to ZENworks Control Center in the Start Menu: (Windows only) Places the shortcut in your Start menu.

  • View Readme file: For GUI installations, opens the ZENworks 11 Readme in your default browser after rebooting (Windows only), or immediately if you select to reboot manually or you installed to a Linux server. For a Linux command line installation, the URL to the Readme is listed.

  • View Installation log: Displays the installation log in your default XML viewer (GUI installation) after rebooting, or immediately if you select to reboot manually. For a Linux command line installation, the information is simply listed.

ZENworks System Status Utility

Allows you to launch a ZENworks services heartbeat check prior to closing the installation program. Results are posted in the installation log.

Rebooting (or not)

Upon a successful installation, you can select between rebooting immediately or later:

  • Yes, Restart the System: If you select this option, log in to the server when prompted. The first time you log in to the server, it takes a few minutes because the database is being populated with inventory data.

  • No, I Will Restart the System Myself: If you select this option, the database is immediately populated with inventory data.

    NOTE:This option is displayed only for Windows devices.

The process of populating the database can cause high CPU utilization during rebooting or immediately after the installation program closes if you select not to reboot. This database updating process can slow down the starting of the services and access to ZENworks Control Center.

The Patch Management downloads might also cause high CPU utilization, usually shortly after rebooting.

Installation completion

The actions you selected previously are performed after all of the files have been installed for ZENworks 11 (if selected). These include:

  • (Windows only) Creating the ZENworks Adaptive Agent icon in the notification area (system tray)

  • (Windows only) Creating the ZENworks Control Center icon on the desktop or Start menu

  • Displaying the Readme

  • Displaying the installation log file

  • Opening ZENworks Control Center

IMPORTANT:If you installed to a Linux server using the command line, and if you plan to run any zman commands in the current session, you need to get the newly installed /opt/novell/zenworks/bin directory into your session’s path. Log out of your session and log back in to reset the PATH variable.