Novell Doc: ZENworks 10 Configuration Management Reporting Server Installation Guide

2.3 Installing ZENworks Reporting Server

Start the ZENworks Reporting Server installation program by using one of the following methods:
- Graphical User Interface (GUI) Installation
  On the installation server, insert the Novell ZENworks 10 Configuration Management with SP3 Reporting Server DVD for Windows.
  
  On a Windows device, the installation begins automatically after inserting the DVD. You can also select the language from the installation page that appears. If the installation does not begin automatically, run setup.exe from the root after inserting the DVD.
  
  On a Linux device, mount the DVD, then run sh /media/cdrom/setup.sh.
- Command Line Installation (Linux only)
  On the installation server, insert the Novell ZENworks 10 Configuration Management with SP3 Reporting Server Novell ZENworks 10 Asset Management with SP3 Reporting Server DVD for Linux.
  
  Mount the DVD.
  
  To start a command line installation to a directory where all (including “others”) have read and execute access, either mount the DVD or copy the DVD’s files to a temporary location other than the /root directory.
  
  Ensure that the copied files and their parent directories have read and execute access for all the users (including “others”).
  
  Run the following command:
  /mount_location/setup.sh -e
- Silent Mode Installation
  Create a silent install configuration file by using the following command:
  
  setup.exe/setup.sh -s
  
  Open the silent install configuration file in a text editor.
  
  Search for ADMINISTRATOR_PASSWORD=.
  
  Replace $lax.nl.env.ADMIN_PASSWORD$ with the actual password.
  
  For example, if the password is novell, then the entry will be as follows:
  ADMINISTRATOR_PASSWORD=novell.
  
  Save the silent install configuration file and exit the editor.
  
  Run the silent install configuration file by using the following command:
  
  setup.exe/setup.sh -s -f path_to_the_silent_install file
During installation, refer to the information in Table 2-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.

In either case, part of completing the installation process is for the database to be updated, which causes high CPU utilization during that process. This can cause the services to start up slowly.
(Conditional) On a Linux server, if you select the Oracle database, check to see if the environment variable LD_LIBRARY_PATH is set to the path of the directory containing $ORACLE_HOME/lib or $ORACLE_HOME/lib32. If the environment variable LD_LIBRARY_PATH is not available, add it to the environment and set its value to the path of the directory containing $ORACLE_HOME/lib32. If the path to $ORACLE_HOME/lib32 is not a valid path, set the value of the environment variable to the path of the directory containing $ORACLE_HOME/lib.
Restart the device after installing ZENworks Reporting Server.

If you have installed ZENworks Reporting Server through the Graphical User Interface (GUI) Installer, you can find all the installation logs at the following locations:

On Windows:
- %zenworks_home%\logs\ZENworks Reporting Server_date time.log.xml
- %zenworks_home%\logs\wdeploy-date-time.log
- %zenworks_home%\logs\ZENworks_Reporting_Install_CheckOracleClient_dd_MMM_yyyy_HH-mm-ss.log
On Linux:
- /var/opt/novell/log/zenworks/ZENworks Reporting Server__date time.log.xml
- /var/opt/novell/log/zenworks/wdeploy-date-time.log
- %zenworks_home%\logs\ZENworks_Reporting_Install_CheckOracleClient_dd_MMM_yyyy_HH-mm-ss.log

IMPORTANT:You can install ZENworks 10 Configuration Management SP3 ZENworks Reporting Server only through media.You cannot install it by mapping to a network drive.

2.3.1 Installation Information

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

Table 2-1 Installation Information

Installation Information	Explanation
Installation path	ZENworks Reporting Server is installed within the ZENworks 10 Configuration Management SP3 install folder %ZENWORKS_HOME%\share\boe (Windows) or $ZENWORKS_HOME/share/boe (Linux). For more information, see Installation Information in the ZENworks 10 Configuration Management Installation Guide.
Prerequisites	The installer prompts for username and password. Specify the super administrator’s username and password for the ZENworks zone. The installer checks to see if a ZENworks 10 Configuration Management Server is installed on the device. If the credentials are correct, the installer checks for other prerequisites such as available disk space, operating system, and system architecture on the device. Also, if ZENworks 10 Configuration Management (SP3) is installed to an Oracle database, ZENworks Reporting Server installer checks to see if Oracle client is installed on the device. If no Oracle client is found, an error is displayed and the installation exits. If the required prerequisites are not met, you cannot continue with the installation. The prerequisites that are not met are displayed (GUI) or listed (command line).
	IMPORTANT:After you install ZENworks Reporting Server, you cannot change the Certificate Authority (CA) type of the ZENworks Primary Server from Internal CA to External CA or vice-versa. The Restore Default buttons restore the paths to those that were displayed when you first accessed this page.
Pre-installation summary	GUI Installation: To modify any information that you have entered up to this point, click Previous. Click Install to begin the installation. Click Cancel to exit the installation. No rollback occurs on cancelling the installation. Command Line Installation: To modify any information that you have entered up to this point, type back and press Enter. Press Ctrl+C to exit the installation. No rollback occurs on cancelling the installation.
Installation completion	A confirmation is displayed upon successfully completing the installation. If you are on ZENworks 10 Configuration Management SP3, a boe folder is created in the installation directory.
ZENworks Reporting Server version	On Linux: The version of the zone when ZENworks Reporting Server was first installed is available in the ZENworksReportingServerVersion.txt file located in the /opt/novell/zenworks/share/boe/version # directory. The version of the currently published reports and universe is available in the ZENworksReportingServiceComponentsVersion.txt file located in the /opt/novell/zenworks/share/boe-publish/version directory. On Windows: The version of the zone when ZENworks Reporting Server was first installed is available in the ZENworksReportingServerVersion.txt file located in the %ZENWORKS_HOME%\share\boe\version # directory. The version of the currently published reports and universe is available in the ZENworksReportingServiceComponentsVersion.txt file located in the %ZENWORKS_HOME%\share\boe-publish\version directory. In ZENworks Control Center, the version information that is displayed for ZRS in the Installed Packages dialog box displays the version of ZENworks Configuration Management on which ZENworks Reporting Server was first installed.