Page Server and Cache Server

The Page Server and the Cache Server are controlled in much the same way from the command line. The command-line options determine whether the server starts as a Page Server, a Cache Server, or both. Options that apply only to one server type are noted below.

The default paths to the servers on Windows are:

C:\Program Files\Crystal Decisions\Enterprise 10\win32_x86\cacheserver.exe
C:\Program Files\Crystal Decisions\Enterprise 10\win32_x86\pageserver.exe

The default paths to the servers on UNIX are:

INSTALL_ROOT/crystal/enterprise/platform/crystalcachesd
INSTALL_ROOT/crystal/enterprise/platform/crystalpagesd

For a list of standard command-line options, see Standard options for all servers.

Option Valid Arguments Behavior

-cache

Enable Cache Server functionality.

-dir

absolutepath

Specify the cache directory for a Cache Server and the temp directory for the Page Server. The directories created are absolutepath/cache and absolutepath/temp

-deleteCache

Delete the cache directory every time the server starts and stops.

-psdir

absolutepath

Specify the temp directory for the Page Server. This option overrides -dir.

-refresh

minutes

Share cached pages for the specified number of minutes.

-maxDBResultRecords

number

Limit the number of database records that are returned from the database. The default limit is 20000 records. If a user views an on-demand report containing more than 20000 records, an error message indicates that the report contains too many database records. To increase the enforced limit, increase number accordingly; to disable the limit, replace number with 0 (zero).

-noautomaticdbdisconnect

Disable automatic database disconnection for the Page Server. By default the Page Server will automatically disconnect from the reporting database after retrieving data, to free up database licenses. This may affect performance if your site uses many reports with on-demand subreports, or group-by-on-server.

-report_ProcessExtPath

absolutepath

Specify the default directory for processing extensions. For details, see Applying processing extensions to reports.

-auditMaxEventsPerFile

number

On the Cache Server, specifies the maximum number of audit actions recorded in the audit log file. The default value is 500. If this maximum number of records is exceeded, the server will open a new log file.

Option	Valid Arguments	Behavior
`-cache`		Enable Cache Server functionality.
`-dir`	`absolutepath`	Specify the cache directory for a Cache Server and the temp directory for the Page Server. The directories created are `absolutepath/cache` and `absolutepath/temp`
`-deleteCache`		Delete the cache directory every time the server starts and stops.
`-psdir`	`absolutepath`	Specify the temp directory for the Page Server. This option overrides `-dir`.
`-refresh`	`minutes`	Share cached pages for the specified number of minutes.
-`maxDBResultRecords`	`number`	Limit the number of database records that are returned from the database. The default limit is 20000 records. If a user views an on-demand report containing more than 20000 records, an error message indicates that the report contains too many database records. To increase the enforced limit, increase `number` accordingly; to disable the limit, replace `number` with 0 (zero).
`-noautomaticdbdisconnect`		Disable automatic database disconnection for the Page Server. By default the Page Server will automatically disconnect from the reporting database after retrieving data, to free up database licenses. This may affect performance if your site uses many reports with on-demand subreports, or group-by-on-server.
`-report_ProcessExtPath`	`absolutepath`	Specify the default directory for processing extensions. For details, see Applying processing extensions to reports.
`-auditMaxEventsPerFile`	`number`	On the Cache Server, specifies the maximum number of audit actions recorded in the audit log file. The default value is 500. If this maximum number of records is exceeded, the server will open a new log file.

Page Server and Cache Server

Related topics