ZENworks Reporting 5.6.1

December 2015

The information in this Readme pertains to the Novell ZENworks Reporting 5.6.1 release.

1.0 Platform Support

Item

Requirements

Processor

Speed:2.0 GHz or faster

Multi-core processor 4 to 8

Type: Server-class CPU such as AMD64 dual core or Intel EM64T dual core or faster

RAM

4 GB minimum; 8 GB and above recommended

Disk Space

60 GB minimum

Additional hard disk 10 GB minimum; 15 GB and above recommended

Supported Hypervisors

Primary server software can be installed in the following virtual machine environments:

  • VMware Workstation 6.5

  • XEN (Citrix XenServer 5.x, 6.0, 6.1)

  • VMware ESXi 5.0.x, 5.1, 5.5, and 6.0

  • Microsoft Hyper-V Server Windows 2008 R2 and 2012

Web Browser

The following web browsers are supported:

  • Internet Explorer 10 and 11

    Internet Explorer versions prior to version 10 are not supported.

  • Firefox ESR version 24.x and 31.x

  • Firefox version 30 onwards (including any patches)

2.0 Important information about replacing Logo

To replace the image in a report manually:

  1. Launch Jaspersoft Studio.

  2. Upload the image in the Repository Explorer as follows:

    1. Right click on the corresponding report unit (folder) in the Repository Explorer.

    2. Select New > Image and then click Next.

    3. Specify Name, ID for the new image and press Next.

    4. Upload the new image and then click Finish.

  3. Open the .jrxml file for the report requiring the new image.

    1. Click on the image (default logo) and go to Properties panel.

    2. Go to Image and change the Expression attribute to "repo:<Name of the new image>"

  4. Save the jrxml file to get these changes published.

To replace the default logo automatically:

  1. Open the Terminal.

  2. Go to /var/adm/reporting.

  3. Type ./change-logo.sh and press Enter. Specify the path of the new image.

Logo is replaced only for ZENworks Reporting predefined reports.

3.0 What’s New

For information about the new features in ZENworks Reporting 5.6.1, see What’s New in ZENworks 11 SP4 .

4.0 Known Issues

This section contains information about issues that might occur while you work with ZENworks Reporting 5.6.1:

4.1 ZENworks Reporting Appliance System Requirements

For optimum results we recommend at least a 2.5 GHz multi-core processor.

4.2 Problem connecting to Microsoft SQL Server running on a named instance

During ZENworks Reporting configuration, you need to configure a ZENworks database as ZENworks Reporting datasource. If the ZENworks database is Microsoft SQL Server running on a named instance, the associated port is getting picked up incorrectly from the ZENworks configuration. This leads to datasource connectivity problem in ZENworks Reporting server which will then not function as expected.

Workaround: Before configuring ZENworks Reporting perform the following:

  • Windows:

    1. Go to %zenworks_home%\conf\datamodel

    2. Open the zdm.xml and zenaudit.xml files.

    3. Search for the <entry key="Port"> text and update the value with the correct port number at which the named instance is listening.

    4. Restart ZENworks services.

  • Linux:

    1. Go to /etc/opt/novell/zenworks/datamodel

    2. Open the zdm.xml and zenaudit.xml files.

    3. Search for the <entry key="Port"> text and update the value with the correct port number at which the named instance is listening.

    4. Restart ZENworks services.

For information, see Restarting the ZENworks Services in the ZENworks 11 Primary Server and Satellite Reference.

4.3 Predefined report schedules with the input controls option might not work as expected after migration

If you had been scheduled a report with "input controls" in ZENworks Reporting 5, after migrating to ZENworks Reporting 5.6.1 that scheduled report will display with no data.

Workaround: Reschedule the report after migrating to ZENworks Reporting 5.6.1.

4.4 User Source usernames and user-groups named with special characters might not work as expected

User Source usernames and user-groups named with special characters might not work as expected.

Recommendation: Use alphanumeric characters and underscores for usernames and user-groups.

4.5 Rights associated with a particular user-group will be applicable for all the groups with the same name

Rights associated with a particular usergroup will be applicable for all the groups with the same name.

For example, there are two usergroups companyname/companybu1/managers and companyname/companybu2/managers. You have assigned a set of rights to the first group, then the other group will also get these rights.

Workaround: Use unique name for usergroups.

4.6 After migrating to 5.6.1, Distinguished Name format may not be maintained for user-groups from the User Source

After migrating from ZENworks Reporting 5 to ZENworks Reporting 5.6.1, Distinguished Name format may not be maintained for user-groups from the User Source.

Workaround: Using Groups Configuration delete the migrated groups and reconfigure them.

4.7 Double Byte language characters might not appear in report export outputs after migration

Double Byte language characters might not appear in report export outputs after migration if the ZENworks-Reporting-5-patch was not applied.

Workaround: Apply the ZENworks Reporting 5 patches before migration.

4.8 In the Audit domain the comparison filters might not work as expected

In the audit domain the string comparison filters such as 'starts with’ might not work as expected.

Recommendation: Use other filters to reduce the report data set.

4.9 The Import option to move ZENworks Reporting resources from ZENworks Reporting 5 to ZENworks Reporting 5.6.1 might not work as expected

Using the import option to move ZR resources from ZR 5 to ZR 5.6.1 might not work as expected.

Recommendation: Use the ZENworks Reporting migration utility to migrate ZENworks Reporting resources from ZENworks Reporting 5 to ZENworks Reporting 5.6.1.

4.10 The Ad Hoc View might not display as expected if data policies have large datasets

When handling large datasets from a Domain source in the Ad Hoc Editor, fields summarized by distinct count are computationally intensive and Ad-hoc view might not display as expected.

Workaround: To design the Ad-hoc view as expected with large data:

  1. Log into the ZENworks Reporting server, as an administrator.

  2. Go to /opt/novell/zenworks-reporting/js/apache-tomcat/webapps/jasperserver-pro/WEB-INF

  3. Open the applicationContext-adhoc-dataStrategy.xml file.

  4. Search for the Bean – CountDistinct and search for tag Property name ="calcMethod"

  5. Change the property to value ="sqlGroupBy"

  6. Restart the ZENworks Reporting server.

4.11 Increasing the crosstab.bucket.measure.limit value makes the generated report export operation failure

Increasing the default value of crosstab.bucket.measure.limit makes the generated report export (pdf and Excel) operation failure.

Workaround: By default, the limit set by ZENworks Reporting measure is 100000. If the number of records exceeds the default limit, then 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. Hence, it is not recommended to change the default value instead increase the number of filters to reduce the output data.

4.12 When you run a large number of reports on a regular basis, the ZENworks Reporting server might hang

When you run a large number of reports on a regular basis, based on the configuration, the ZENworks Reporting server might hang.

Workaround: Restart the ZENworks Reporting services.

4.13 If the local administrator configured during ZENworks Reporting migration is also a ZENworks Reporting 5 administrator configured through user source, the administrator rights of both users might get revoked

ZENworks Reporting 5 requires a user source to be configured. Consider a scenario in which a ZENworks Reporting 5 administrator called admin1 exists in the configured user source. During ZENworks Reporting migration, you are prompted to configure a local ZENworks Reporting administrator. If the credentials of this administrator conflict with admin1, then the administrator privileges of both the administrators might get revoked.

Workaround: After migration, reconfigure the local Administrator from the ZENworks Reporting Appliance summary page.

5.0 Additional Documentation

This Readme lists the issues specific to ZENworks Reporting 5.6.1. For all other ZENworks 11 SP4 documentation, see the Novell ZENworks 11 SP4 documentation website.

6.0 Legal Notices

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 © 2015 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.