Configure logging settings for the BlackBerry Enterprise Server User Administration Tool

  1. On the computer that hosts the BlackBerry Enterprise Server User Administration Tool, in a text editor, open the BESUserAdminClient.exe.config file. The default location of the configuration file is <drive>:\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server Resource Kit\BlackBerry Enterprise Server User Administration Tool Client. If your computer's operating system uses UAC and does not permit you to modify the configuration file at this location, open the virtualized copy of the BESUserAdminClient.exe.config file in the application data folder for the current user (for example, <drive>\Users\<user_name>\AppData\Local\VirtualStore\Program Files (x86)\Research In Motion\BlackBerry Enterprise Server Resource Kit).
  2. In the <applicationSettings> section, perform any of the following tasks:

    Task

    Steps

    Change the location where the tool writes log files.

    Change the LogFolder value to the file path where you want the tool to write log files.

    Your user account must have permission to write data to the file path that you specify.

    Change the level of logging detail displayed by the tool when you run a command.

    Change the ConsoleLogLevel value to one of the following values:

    • To display no logging information, type 0.
    • To display error messages, type 1.
    • To display warning messages and all messages of higher severity, type 2.
    • To display informational messages and all messages of higher severity, type 3.
    • To display verbose information and all messages of higher severity, type 4.

    The default value is 3.

    Change the level of logging detail written to the log file.

    Change the FileLogLevel value to one of the following values:

    • To turn off logging, type 0.
    • To write error messages, type 1.
    • To write warning messages and all messages of higher severity, type 2.
    • To write informational messages and all messages of higher severity, type 3.
    • To write verbose information and all messages of higher severity, type 4.

    The default value is 3.

    Change the maximum size of log files.

    Change the LogFileSizeLimit value to the new maximum size for log files, in bytes.

    When a log file reaches the maximum size limit, the tool creates a new log file.

    The default value is 0 (no maximum size for log files).

    Change the maximum number of log files that the tool creates per day.

    Change the LogFilesPerDayLimit value to the maximum number of log files that you want the tool to create per day.

    When the maximum number of log files is reached, any additional logging information is written to the final log file that the tool created that day, regardless of the maximum size limit that you might have configured for log files.

    The default value is 0 (no maximum number of log files).

    Configure whether the tool organizes log files into daily folders.

    To organize log files into daily folders, change the LogFilesDailyFolders value to True.

    The default value is False (the log files are not organized into daily folders).

    Configure whether the tool creates log files, input files, and output files in a UAC-compliant file path.

    If you do not want the tool to create log files, input files, and output files in a UAC-compliant file path, change the UseUACPath value to No.

    The default value is Yes.

  3. Save and close the BESUserAdminClient.exe.config file.

Example applicationSettings section

<applicationSettings>
	<RIM.Enterprise.BRK.BESUserAdminClient.Properties.Settings>
		<setting name="InstallFolder" serializeAs="String">
			<value>C:\Program Files (x86)\Research In Motion\BlackBerry Resource Kit for BlackBerry PlayBook 
			Administration Service\BlackBerry Enterprise Server User Administration Tool Client\</value>
		</setting>
		<setting name="LogFolder" serializeAs="String">
			<value>C:\Users\besadmin\appdata\Roaming\Research In Motion\BlackBerry Resource Kit for BlackBerry PlayBook Administration
			Service\BlackBerry Enterprise Server User Administration Tool Client\Logs</value>
		</setting>
		<setting name="ConsoleLogLevel" serializeAs="String">
			<value>4</value>
		</setting>
		<setting name="FileLogLevel" serializeAs="String">
			<value>4</value>
		</setting>
		<setting name="LogFileSizeLimit" serializeAs="String">
			<value>5242880</value>
		</setting>
		<setting name="LogFilesPerDayLimit" serializeAs="String">
			<value>5</value>
		</setting>
		<setting name="LogFilesDailyFolders" serializeAs="String">
			<value>True</value>
		</setting>
		<setting name="UseUACPath" serializeAs="String">
			<value>No</value>
		</setting>
	</RIM.Enterprise.BRK.BESUserAdminClient.Properties.Settings>
</applicationSettings>


Was this information helpful? Send us your comments.