jdbc connector file for ZRS

  • 7010228
  • 28-Feb-2012
  • 06-Nov-2012

Environment

Novell ZENworks 11 Configuration Management Support Pack 2 - ZCM 11 SP2 Business Objects Reporting

Situation

How does ZRS connect to the ZEN database?

How to possibly resolve WIS 10901 errors connecting to the database.

Resolution

In 11.x, ZRS Business Objects uses JDBC.  In 11.2, a new configuration file can be created that has settings for that connection.  If that file does not exist, then zdm.xml is used.
 
File location:
Windows:
ZENWORKS_HOME/conf/datamodel/boe_jdbc_url.txt
Linux:
/etc/opt/novell/zenworks/datamodel/boe_jdbc_url.txt

Additional Information

Format of jdbc_url for MSSQL server:

jdbc:sqlserver://DbserverIP:port;DatabaseName=dbname;InstanceName=dbinstance;integratedSecurity=true

DbserverIP, dbname, dbinstance should be changed if the database is moved.

Instancename and integratedSecurity=true is not required in all cases. It's only required when using a SQL instance name and Windows authentication.

Format of jdbc_url for Oracle RAC:
 
jdbc:oracle:thin:@(DESCRIPTION=
(ADDRESS=(PROTOCOL=tcp)(HOST=Ipaddress1)(PORT=1521)) 
(ADDRESS=(PROTOCOL=tcp)(HOST=IpAddress2)(PORT=1521)) 
(CONNECT_DATA=(SERVICE_NAME=OracleServiceName)))

Or
 
jdbc:oracle:thin:@//hostname:1531/servicename
 
If the jdbc_url file is missing, zdm.xml will be used instead.
 
After creation or modification to jdbc_url file, the following must be run to update the ZRS:
 
novell-zenworks-configure -c UpdateBOE
 
Note: ZCM recommend using static ports and not dynamic ones. If zmd.xml file is used make sure the ports match with the database server and are static.