The information in this Readme includes the following:
The platforms that are supported in ZENworks Reporting 5 include the following:
Operating System Support
Windows Server 2003 SP2 x86_64 (Enterprise and Standard editions)
Windows Server 2003 R2 SP2 x86_64 (Enterprise and Standard editions)
Windows Server 2008 SP2 x86_64 (Enterprise and Standard editions)
Windows Server 2008 R2 x86_64 (Enterprise and Standard editions)
Windows Server 2008 R2 SP1 x86_64 (Enterprise and Standard editions)
Windows Server 2012 Server Standard x86_64 (Foundation, Essential, and Standard edition)
Windows Server 2012 Server R2 (Primary Server)
SUSE Linux Enterprise Server 10 (SLES 10) SP3/SP4 x86-_64 (Intel and AMD Opteron processors)
SLES 11 SP1/SP2/SP3 x86_64 (Intel and AMD Opteron processors)
SLES 11 SP2 and SP3 for VMware X86_64
Red Hat Enterprise Linux 5.8, 5.9, 6.3, and 6.4 x86_64
Red Hat Enterprise Linux 6.0/6.1/6.2 x86_64
Browser Support
Firefox ESR version 10 and 17
Firefox version 20, 22, and 23
Internet Explorer versions 8, 9, and 10
The following installation files are available for download on the ZENworks 11 SP3 website:
ZENworks_Reporting_5.iso: Download the ZENworks Reporting installer files from Novell Web site, and extract on your device where you want to install ZENworks Reporting.
ZENworks_Reporting_5_patch .zip: You must apply the ZENworks Reporting patch after installing ZENworks Reporting. Download the ZENworks_Reporting_5_patch.zip file from Novell Web site for ZENworks Reporting 5. This contains audit related fixes. For information on applying the patch, see the ZENworks Reporting 5 Installation Guide.
For information on installation, see the ZENworks Reporting 5 Installation Guide.
For all ZENworks 11 SP3 documentation, see Novell ZENworks 11 SP3 documentation Web site.
The languages that are supported in ZENworks Reporting 5 include the following:
For ZENworks Reporting Installer and ZENworks Reporting Configuration Tool
Chinese Simplified - zh_CN
Chinese Traditional - zh_TW
English - en
French - fr
German - de
Italian - it
Japanese - ja
Spanish - es
ZENworks Reporting UI Console
Chinese Simplified - zh_CN
Chinese Traditional - zh_TW
English - en
French - fr
German - de
Italian - it
Japanese - ja
Romanian - ro
Spanish - es
ZENworks Reporting Predefined reports
Chinese Simplified - zh_CN
Chinese Traditional - zh_TW
English - en
French - fr
German - de
Italian - it
Japanese - ja
Spanish - es
To replace the Novell logo manually, perform the following:
Launch .jrxml file.
and open theClick image (Novell logo) and go to properties.
In the image
, change the path of the image, that needs to be replaced.Replace the old .jrxml file with the modified .jrxml file.
Launch the report.
To replace the Novell logo automatically, perform the following:
Download the ZENworks_Reporting_change_logo.zip file from Novell Web site.
Extract the ZENworks_Reporting_change_logo.zip file on to ZENworks Reporting device.
Perform the following:
For Windows:
Open a Command prompt.
Go to the path where you extracted the ZENworks_Reporting_change_logo.
Type change-logo.bat and press .
Specify the path of the new image.
For Linux:
Open a Terminal.
Specify the path where you downloaded the ZENworks_Reporting_change_logo.
Type chmod -R 777 ZENworks_Reporting_change_logo.
Type cd ZENworks_Reporting_change_logo.
Type ./change-logo.sh and press .
Specify the path of the new image.
Logo is replaced only for ZENworks Predefined reports.
IMPORTANT:If you are reconfiguring the datasource through ZENworks Reporting Configuration tool, then you must follow above steps to change the logo automatically.
This section contains information about issues that might occur while you work with ZENworks Reporting 5:
Section 1.7.1, Unable to log in as an eDirectory user in ZENworks Reporting
Section 1.7.2, Missing languages in the ZENworks Reporting installation wizard
Section 1.7.3, An error message is displayed if you filter the Input Control with the All option
Section 1.7.4, ZENworks Reporting administrator role is not mapped to the nested groups
Section 1.7.5, Custom patches are not displayed correctly in the report
Section 1.7.11, Crosstab reports does not display more than 50 rows
Section 1.7.12, Invalid Credentials Supplied error message is displayed
Section 1.7.14, Some of the field data might not appear in the Crosstab report
Section 1.7.16, ZENworks Reporting Web Interface does not login for a user with no password
Section 1.7.17, ZENworks Reporting install does not create the default Topics folder
Section 1.7.19, Crosstab report Totals of the measure fields with Distinct count does not match
Section 1.7.22, Using Prefilters in an Ad Hoc report sometimes displays an error
Section 1.7.24, ZENworks Reporting Installer hangs if available space is low in the Windows drive
Section 1.7.25, Some reports might fail to generate due to a default limit
Section 1.7.26, Dashboard displays multiple reports with the same name
Section 1.7.29, ZENworks Reporting Install fails in CLI mode
Section 1.7.31, Error displayed when logging in with eDirectory user
Section 1.7.32, Scheduling fails when one of the recipient does not exist
Section 1.7.35, Audit Predefined Reports display an error message in the jasperserver.log file
Section 1.7.37, ZENworks Reporting does not allow blank password for SMTP during Installation
NOTE:In the ZENworks Reporting Solution, some strings are not localized.
You cannot log in as an eDirectory user in ZENworks Reporting when eDirectory contains multiple user instances with the same user name.
Workaround: None
In the ZENworks Reporting installation wizard, double byte languages that are supported by ZENworks Reporting are not displayed in the language drop-down list on single byte device or vice-versa.
Workaround: Execute the ZENworks Reporting application by using the setup.sh -L <locale> command. The <locale> is code for the language you want. (en_US - English, fr-French, it-Italian, es-Spanish, de-German, ro-Romanian, ja-Japanese, zh_TW-Chinese(Taiwan), and zh_CN-Chinese (China). For example, run the setup.sh -L fr to install in French.
In ZENworks Reporting, if you filter the Input Control, by using the
option, sometimes the following error message is displayed:.
Also, a blank report is generated or an
message is displayed. This occurs due to the limit on the number of parameters supplied to the underlying database.Workaround: Filter the Input Control, using the
option. The results are the same as those displayed when you select the option.In the ZENworks Reporting installer or the ZENworks Reporting Configuration Tool, if you navigate to the Configure User Source wizard and map the parent group with administrator rights, nested groups that are under the parent group will not be mapped with administrator rights.
For example, a Finance group has the sub-groups, finance_account, finance_purchase, finance_administration and a finance_manager user. If the Finance group is selected, only the finance_manager user will have the mapped rights. None of the sub-groups will have these rights. The rights will not flow to the nested groups.
If you want to specify rights to nested groups, you must map these groups (finance_account, finance_purchase, and finance_administration) separately.
Workaround: Map the sub-groups separately.
Custom patches created from a bundle in the ZPM folder do not display correctly in the report. The original patch bundle gets associated with the bundle instead of with the custom patch.
Workaround: None.
While creating an Ad Hoc report, you will be unable to create a custom measure object by using a ZENworks Domain. ZENworks Reporting will not support custom measure on the measure objects for which aggregation function is Count or Distinct count.
Workaround: None.
When you choose the
option, an incorrect data count is displayed.Workaround: None.
Unable to import resources in ZENworks Reporting, by using the
option ( ).Workaround: Use the CLI mode to import resources.
To import Schedule jobs, specify the following --everything in the import command:
Open a command prompt.
Go to the following path:
For Windows: %ZRS_HOME%\js\buildomatic
For Linux: /opt/novell/zenworks-reporting/js/buildomatic
Run the following js-import –-input-zip "path" command.
Where "path" is the path of the exported zip file. You can use the following js-import –-input-zip “path” --update command to update your repository.
When you export any report in to DOCX or RTF formats, the report format is lost.
Workaround: Select other supported formats in ZENworks Reporting.
On a device if the Symantec Endpoint Protection installer is in progress and if you try to install ZENworks Reporting, it fails. ZENworks Reporting installer internally calls the VC++ library installer that causes the ZENworks Reporting installation failure.
Workaround: Do not install ZENworks Reporting on a device when Symantec Endpoint Protection installer is in progress.
When creating an Ad Hoc View as a Crosstab, the total number of rows are restricted to 50 (even though the report contains more than 50 rows). Even the measure objects added in this case do not add up to the aggregated total values displayed in the Ad Hoc View. However, when the report is exported to output format (MS Excel, PDF and so on), the correct values are displayed.
Workaround: Change the default configuration settings in the applicationContext-adhoc.xml file.
Perform the following steps to change the default settings:
Go to the following path:
For Windows: %ZRS_HOME%\js\apache-tomcat\webapps\jasperserver-pro\WEB-INF\applicationContext-adhoc.xml
For Linux: /opt/novell/zenworks-reporting/js/apache-tomcat/webapps/jasperserver-pro/WEB-INF/applicationContext-adhoc.xml
Backup the applicationContext-adhoc.xml file.
Open the applicationContext-adhoc.xml file.
Search for <property name="safeMemberCount" value="50"/>
Change the safeMemberCount value.
It is recommended to retain the default settings of the applicationContext-adhoc.xml file.
When you log in to ZENworks Reporting, an
error message is displayed.Workaround: If the problem persists even if after specifying valid credentials, check whether the LDAP server is down or not reachable.
The
message is displayed, while using ZENworks Reporting.Workaround: Delete all the browser cookies specific to the ZENworks Reporting server.
When you create a Crosstab report by using ZENworks Audit Domain, some of the field data might not appear.
Workaround: None.
Active Directory allows to create Organization Unit and User name with some special characters. However, when the credentials are passed to the ZENworks Reporting installer (
Wizard), it is prevented from proceeding further.Workaround: If you are using these special characters \ ; = , + < >" then append with backslash “\”. For example, specify userfirstname,userlastname as userfirstname\,userlastname.
Some LDAP directories, such as NetIQ eDirectory, support creating a user without a password. However, logging in without a password is not supported in ZENworks Reporting.
Workaround: None.
After installing ZENworks Reporting, the
folder is not created under ( ) by default, which is mandatory to create a topic.Workaround: Manually create the
folder under .If you create a custom report, sometimes the report might not display complete data.
For example: If you create a report with bundle information, some bundles are not displayed in the report.
Workaround: Increase the
.To increase the Ad Hoc Dataset Row Limit:
Click
.Increase the
, then click .On a Crosstab report, the Totals of the measure fields with a Distinct count does not match the actual sum.
Workaround: To match the Totals, you can also use the
option. To enable right click the and to .If you save the Ad Hoc View, a report, or a dashboard by using special characters, an error message appears.
Workaround: It is recommended to create the Ad Hoc Views, reports and Dashboards only by using alphanumerics, and ‘-’, ‘_’ in special characters.
If you run a schedule job initially on the server, any subsequent jobs created (output report that have same name), or rerun of the same job, then subsequent iteration of the same job throws the following error message:
. .Workaround: In the
panel, under , select , or .Sometimes while creating the Ad Hoc reports an error message appears as
.Workaround: When creating the Ad Hoc report, use
rather than .When installing ZENworks reporting using the CLI method, if LDAP Groups in the configured LDAP server contain these characters (; , ( ) and [ ] ) then the groups do not appear in the
panel.Workaround: The LDAP Groups which have that contain the characters indicated above can be configured as administrator groups by modifying the %ZRS_HOME%\js\apache-tomcat\webapps\jasperserver-pro\WEB-INF\applicationContext-multiTenancy-security.xml file.
Perform the following to configure the LDAP group as an administrator group:
Stop the server.
Backup the applicationContext-multiTenancy-security.xml file outside of ZENworks Reporting %ZRS_HOME%.
Open the file %ZRS_HOME%\js\apache-tomcat\webapps\jasperserver-pro\WEB-INF\applicationContext-multiTenancy-security.xml.
Go to the <property name="rootOrganizationRolesMap"> <map> node, then add an entry in the following format:
<entry><key><value> Name of the group which contains the listed special characters</value></key><value>ROLE_ADMINISTRATOR</value></entry>
Perform Step 4 to add more groups.
Restart the server.
When you are installing ZENworks Reporting, if the space available on Windows drive is low, the installer hangs.
Workaround: When installing ZENworks Reporting on any other drive, ensure that at least 2 GB space is available in the Windows drive.
When generating some of the Crosstab reports, a report might fail and display the following error:
.Workaround: Add more filters to reduce the output data. By default, the limit set by ZENworks Reporting measure is 100000. For more information, see Increasing the "crosstab.bucket.measure.limit" value makes the generated report export operation fail.
Multiple reports with the same name might appear when creating a dashboard for ROLE_ADMINISTRATOR.
Workaround: Choose any report and create a dashboard.
Increasing the default value of
makes the generated report export (pdf, Excel and so on) operation fail.Workaround: By default, the limit set by ZENworks Reporting measure is 100000. If the number of records exceeds the default limit, the report fails to generate. Increasing the default ZENworks Reporting measure limit might able to generate the report. However, the export operation of the generated report might fail. Therefore, changing the default value is not recommended. Instead, increase the number of filters to reduce the output data.
Some Ad Hoc report create actions (such as a adding column, creating a filter, and so on) take a long time to complete or sometimes fail to complete the action. As a result, the specified operation does not time out.
Workaround: Refresh the browser.
If you are installing ZENworks Reporting, in SLES devices by using CLI mode, the ZENworks Reporting fails to install.
Workaround: Cleanup ZENworks Reporting, change the Loopback address to 127.0.0.1, then restart install. For cleanup information, see TID 7014143 in the Novell Support Knowledgebase.
If you are creating an Ad Hoc View by using a filter on a policy name that contains a semicolon (;) special character, then an error message might display.
Workaround: While creating a filter, do not create or use objects that have a semicolon (;).
You cannot log in as an eDirectory user in ZENworks Reporting when eDirectory contains a group that has the same name as the eDirectory user.
Workaround: You must modify the applicationContext-security.xml as follows:
Go to the following path
For Windows: %ZRS_HOME%\js\apache-tomcat\webapps\jasperserver-pro\WEB-INF
For Linux: /opt/novell/zenworks-reporting/js/apache-tomcat/webapps/jasperserver-pro/WEB-INF
Backup the applicationContext-security.xml file.
Open the applicationContext-security.xml file.
Search for <value>(cn={0})</value> and replace with <value>(&(objectClass=user)(cn={0})</value>
Restart the ZENworks Reporting Services. For information about ZENworks Reporting Services, see the ZENworks Reporting 5 Installation Guide.
If you are scheduling a report and one of the recipient does not exist, then that schedule fails.
For example, if you are scheduling a report to william@abc.com,chris@abc.com, and chris@abc.com does not exist, then even the valid user does not receive an email.
Workaround: Specify valid recipient while scheduling a report.
If you are using Time filters other than “Any time” it displays inconsistent results.
Workaround: Ensure that you use only “Any time” filter.
If your report exceeds 50,000 characters for such report
error message is displayed.Workaround: You must increase the default length of an SQL query in security.properties as follows:
Go to the following path
For Windows: %ZRS_HOME%\js\apache-tomcat\webapps\jasperserver-pro\WEB-INF\classes\esapi
For Linux: /opt/novell/zenworks-reporting/js/apache-tomcat/webapps/jasperserver-pro/WEB-INF/classes/espai
Backup the security.properties file.
Open the security.properties file.
Search for sqlQueryExecutor=Alpha,ValidSQL,50000,true,SQL_Query_Executor_context and replace with required value.
Restart the ZENworks Reporting Services. For information about ZENworks Reporting Services, see the ZENworks Reporting 5 Installation Guide.
If you run the Audit predefined reports, the report provides correct information but it displays the ERROR EasyXML,http-8443-6:318 - attribute showTableGrandTotalOnly of element unifiedState doesn't match any property in class com.jaspersoft.ji.adhoc.AdhocUnifiedState error message in the jasperserver.log file.
Workaround: Ignore the error message displayed in the jasperserver.log file. Since, it does not impact the functionality.
When installing ZENworks Reporting, you may not be able to use more than one User Source.
Workaround: To configure more than one User Source after ZENworks Reporting installation, see TID 7014511 in the Novell Support Knowledgebase.
When installing ZENworks Reporting the reporting server does not allow for a blank password under
wizard in the field.Workaround: To enable blank password for SMTP settings, see TID 7014545 in the Novell Support Knowledgebase.
Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.
Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classification to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in the U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical biological weaponry end uses. Please refer to the Novell International Trade Services Web page for more information on exporting Novell software. Novell assumes no responsibility for your failure to obtain any necessary export approvals.
Copyright © 2014 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.
For Novell trademarks, see the Novell Trademark and Service Mark list.
All third-party trademarks are the property of their respective owners.