Professional Documents
Culture Documents
Step: 1
Map
Process
Tools
Page 2 of 23
Adding a command line trace parameter to the CMS causes the
server to log the actions it performs. Writing a Timestamp and
ProcessID, the trace shows a range of information including
method calls and when the CMS interacts with the System
Repository.
Querytiming Parameter
This additional CMS command line parameter captures queries
made to the System Repository from the CMS.
3rd Party Tracing
As the System Repository can be installed on a several platforms,
the vendors database solution may also come with its own
tracing utilities. For example, Microsoft provides a utility called
Profiler that captures server load to SQL Server. Profiler displays
SQL Statements in addition to other metrics such as statement
duration, paging, deadlocks and locking
RegMon
Sysinternals produces a series of valuable tools including
RegMon. A monitoring tool for the registry, it will show in real
time which processes are working with the registry and the values
they are reading or writing.
http://www.sysinternals.com
Page 3 of 23
Step: 2
Map
Process
The Web Intelligence Job Server uses the same executables as other
Job Servers but does differ in the libraries that it loads on startup it
uses the procWebi library.
The Web Intelligence Job Server reuses or spawns a new child process
called Jobserverchild.exe and sends the job request to an available
Web Intelligence Report Server. Each child only processes one
document at a time but may remain in memory after it finishes the job,
saving it from unloading and reloading runtime files that may be used
by later processes. If the job server is set to process five jobs there will
be five Jobserverchild.exes spawned on the machine.
Tools
Config
Page 4 of 23
Switch
Arguments
Description
-lib
Library
Specifies the processing library for the Job server to use. This switch along with the
objectType switch determine the type of Job server this will be. For the WebI Job Server,
this switch uses the procWebi library.
-objectType
ObjectType
Specifies the type of object that this Job server will process. This is the program id of the
object that it will process. For the Web Intelligence Job Server, the object type is
CrystalEnterprise.Webi
-maxJobs
Number
Specifies the maximum number of concurrent jobs that this Job server can run.
requestJSChildPor
ts
LowerboundUpperbound
Specifies the range of ports that the Job server child processes can use. Handy in a
firewall configuration. For Example 6800-6804 would limit the JS children to only use
those 5 ports.
-port
Interface:port
Specifies which IP address and port the Job Server will listen on.
-requestport
Port
Specifies which port the Job Server will use for communication and requests.
-ns
CMS/Cluster Name
Specifies which CMS or Cluster this Job Server should use for its Name Server.
Turns on tracing/logging for the WebI Job Server.
-trace
-dir
Directory
Page 5 of 23
Step: 3
Map
Process
Page 6 of 23
DocumentVariable (leaf)
Description
Data insuring integrity of the file.
Description
Used by Cube.
DataSource objects: names and
hierarchies contained in the
document.
Description and data from
DataProviders or queries.
Main C3 document version (currently
2.0) and a string tag cdzDocument.
Document properties: some flags
including autoSynchronize=on/off.
List of anonymous formulas found in
document reports. (User may set a
formula without giving name.
List of variables, tokenized form,
also called serial form (format is
locale independent).
Page 7 of 23
DocumentVariable_Data
Domain for variables having custom
(leaf)
sort.
DATASOURCES (C3 sub-node)
Description
DataSource objects: names and hierarchies
contained in the document.
Number of DataSources, last key id (for
key generation).
For each DataSource (DS):
DSKey(DS0, DS1, DSn)
DS type (QT) and universe connection
string=Repold=12;UnivId=)
Hierarchies contained by the DS:
DS0.DH5
Database connection
string=4;ODBC17;SQLServer
Others DS info such as: repold, name, long
name, comments
DS properties: max =rowfetched,
maxfetchtime
Database (DB) date format, DB number
format, DB decimal separator,
maxOperandsForInList.
Flag: allowMultiSelectContext.
Description
Data coming from DataProviders.
Name of the DataProvider used in the
document. In case of multiple
providers there will be several storage
nodes such as DP0, DP1.
Page 8 of 23
Description (leaf)
DPManager (leaf)
SynchroManager (leaf)f
.wid version.
List of the Data Providers.
For each synchronization, include the
name, key and source objects.
SynchroManager_Data
For each synchronization object having
(leaf)
custom sort: domain (similar to
DocumentVariable_Data).
DPO (DATAPROVIDERS sub-node)
Description
Description
Page 9 of 23
CDZ (node)
SESSION (CDZ sub-node)
_PROPERTIES (leaf)
MDPWORKFLOWINFOS
(leaf)
Description
Used by Drill engine.
Drill Infos such as Drill Setting, and per
report: Report_Id, Drill_Bar. Per
Drill_Block: Block_Id and
Drill_Hierarchies. Per
Drill_Hierarchies: Dim_Key and
Hier_Key. Drill_Dimensions. Query
filters, Drill parameters.
Page 10 of 23
Node and/or leave name
RE (node)
DOCSPEC (leaf)
Tools
Description
Used by Repeng.
XML of the Report Specification and
formula tokenized form. Also called
serial form (cube team).
Page 11 of 23
keep=true;
FileMon
SysInternals provides a range tools to analyze a system. FileMon is a
tool that Monitors in real time the files that have accessed on the
system. During this step, FileMon would capture the creation of files
in the private and or shared cache.
http://www.sysinternals.com
Page 12 of 23
Step: 4
Map
Process
Page 13 of 23
WiReportServer
(communication, orchestration)
Query spec
(xml)
Report spec
(xml)
Cube
DP 8 Calculator
(orchestrate
data fetching)
Report output
(xml)
RepEng
(page rendering in xml)
9
Dico
4
2
QF
10
Facilitate communication
between RepEng and
Calculator using iterators
DP : Data provider
QT
CS
(generate SQL)
(execute SQL)
QF : Query facility
QT : Query technique
CS : Connection server
RepEng : Report Engine
Page 14 of 23
Tools
Page 15 of 23
Database Vender Tools
As the System Repository can be installed on several platforms,
the vendors database solution may also come with its own
tracing utilities. For example, Microsoft provider a utility called
Profiler. Capturing the server load, Profiler displays the SQL
Statements executed against the server in addition to a range of
metrics including statement duration, i/o, deadlocks and locking.
Configuration
Page 16 of 23
Web Intelligence Report Server.
4. The Web Intelligence Report Server requests the Web
Intelligence Document file and Universe from the Input
FRS and copies them to its working directory.
5. The Web Intelligence Report Server runs the Web
Intelligence Document against the reporting database.
The Web Intelligence Report Server then exports the Web
Intelligence Document file to Excel format.
6. The Web Intelligence Report Server sends a copy of the
complete .xls file to Output FRS.
7. The Web Intelligence Report Server notifies the Web
Intelligence Job Server that the job has completed
successfully and sends a copy of the .xls instance to the
Job Server Child.
8. The Job Server Child sends a copy of the instance to the
Inbox using inbox.dll and
dest_CrystalEnterprise_managed.dll plugins. Inbox
instances get sent to the Input FRS.
The Web Intelligence Job Server notifies the CMS that the job
was completed successfully
Page 17 of 23
Step: 5
Map
Process
Tools
BusinessObjects trace.
Adding a command line trace parameter to the Output FRS causes the
Server to log its actions. Writing a Timestamp and ProcessID, the trace
shows the location and name of the .wid file saved to the Server.
Classic Webi Trace
This is a trace is used to record Web Intelligence Report server
processes. This trace differs from trace parameter as it logs only its
own interactions in its own process rather then all the other CORBA
commands such as pings to the CMS. These traces also save the XML
generated by Web Intelligence sub components in a folder called
wicdztrace.
Page 18 of 23
Page 19 of 23
Step: 6
Map
Process
The Web Intelligence Report Server notifies the Web Intelligence Job
Server that the job has completed successfully.
Tools
Page 20 of 23
found easily as they are marked with an |E| and |W| respectively.
Working with this trace requires a BO_Trace.ini file to be created and
three optional environment variables to be set:
Environment Variables
BO_TRACE_CONFIGDIR = c:\mypath
BO_TRACE_CONFIGFILE=c:\mypath\BO_TRACE.INI
BO_TRACE_LOGDIR= C:\MyLogFolder
BO_TRACE.INI
active=true;
important=<<; (options are <<,<=,==,>=,>> where << logs
informational lines to >> which is critical/error lines)
size=10000;
keep=true;
Page 21 of 23
Step: 7
Map
Process
The Web Intelligence Job Server notifies the CMS that the job was
completed successfully.
Tools
Page 22 of 23
Step: 8
Map
Process
Tools
Page 23 of 23
deadlocks and locking