Chapter 7: Using the SafeWord 2008 Management Console
Reporting
170
Report worksheet generation
The SafeWord 2008 Management Console will sometimes generate more than
one worksheet for a given report template. When a report template contains
more then one categories (e.g. users and tokens), an Excel worksheet file will
be created for each data type. In addition, the
Number_of_lines_per_Excel_sheet
property in the Console configuration file
(
client.ini
) governs the number of rows that will be written to any one particular
worksheet file. By default, this property is set to 5000. For example, if you
export 15000 audit logs during the report generation process, the first 5000
rows will be stored in one worksheet file (e.g. with the name “weekly-logs.xls”)
and the remaining 10000 rows will be stored in a second and third worksheet
file with a similar name (e.g. “weekly-logs_0.xls”). The client.ini file is located in
the Administration Console directory (...\SafeWord\AdminConsole).
Whenever the Console creates more than one worksheet file for a single
report, it will also create a
VBScript
file that can be used to merge all of the
individual files into one file with a worksheet for each file. This VBScript can
only be used on Windows platforms. This script file will be named similarly to
the generated worksheet files. To continue the example, this script file would
be called “merge-weekly-logs.vbs”. The output of this script would be a single
Excel worksheet file called “merged-weekly-logs.xls”.
Note:
If you change the value of the Number_of_lines_per_Excel_sheet property
in the Console configuration, you must restart the Console for the new value to
take effect.
Generating reports from the command line
In addition to using the Console to generate reports, you may also generate
reports using a command line tool that is packaged with the Console. This
gives you the ability to create your own shell scripts that can trigger the
creation of several reports in one pass. Additionally, you can use your
operating system’s native scheduling features to call your custom shell scripts
on scheduled intervals. By doing so, you can automate the process of
generating periodic reports (for example, to track authentication activity on a
weekly basis).
The command line reporting tool, called
report.bat
can be found in the Console
installation directory (
...\SafeWord\AdminConsole
). In the same way that the
Console can be installed and executed on a remote machine (i.e. executing on
a machine other then the SafeWord server machine), so can the command line
reporting tool.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
