Siebel Reports Administration Guide > Restructuring the Reports Server Encyclopedia >

Restructuring the Report Encyclopedia


The following describes the usage of the actrestruct6.exe utility.

The administrator should run the utility actrestruct6.exe from a Windows Command prompt on a machine where Actuate Management Console is installed. The syntax for running this utility is:

actrestruct6.exe -u <user name> -p <password> -m <machine> - n <starting folder> -r <root level folders> -s <subfolders>

Flag
Type
Description
-u
Required
Reports Server administrator login name.
-p
Required
Reports Server administrator password.
-m
Required
Reports Server host name.
-n
Optional
Integer specifying the root-level folder to start with for creating subfolders. If omitted, subfolders will be created starting with the first root-level user folder.
It is important to specify an appropriate value for this parameter if this utility is run periodically.
-r
Optional
Number of root-level folders (of the form foldernnn) that will be created. Existing folders will not be affected. Default value is 50.
-s
Optional
Number of subfolders per root-level folder. Default value is 250.

The following examples represent sample usage scenarios.

Example 1: The administrator synchronizes 8,000 users on the Reports Server and then run the actrestruct6.exe utility as shown below:

actrestruct6.exe -u administrator -p admin -m Server1 -n 1 -r 40 -s 400

Result:

Forty folders are created at the root level in the Server1 Reports Server encyclopedia of the form folder001, folder002, ...., folder040. Each of these root level folders contains the folders of 400 users. The first 400 user folders are created in folder001, the next 400 user folders are created in folder002 and so on. The root-level folders are created first, so all 40 folders will be created at the root level. However, only 20 of them will be used to create subfolders. The remaining root-level folders can be used to populate subfolders when this utility is run subsequent times.

Example 2: A couple of weeks later, 500 new employees join the company. As usual, the administrator synchronizes these 500 users on the Reports Server. Then, the administrator run the actrestruct6.exe utility using the following command.

actrestruct6.exe -u administrator -p admin -m Server1 -n 21 -s 400

Result:

At the root level in the Reports Server encyclopedia of Server1, folder021 and folder022 are used to create subfolders for the new users. The folder021 contains the first 400 user folders, and folder022 contains the remaining 100 user folders.

NOTE:  In Example 2, if the administrator specifies -n 20, 400 new user folders will be added to folder020, which will then contain 800 folders. The folder021 will contain the remaining 100 user folders.


 Siebel Reports Administration Guide, Version 7.5, Rev B 
 Published: 18 April 2003