Log files for BlackBerry Enterprise Server components
You can use log files to record the activity of BlackBerry® Enterprise Server components and troubleshoot issues with the components. The BlackBerry Enterprise Server creates a log file for each BlackBerry Enterprise Server component and saves the log files on the computer that hosts the BlackBerry Enterprise Server. By default, the BlackBerry Enterprise Server saves the log files in C:\Program Files\Research In Motion\BlackBerry Enterprise Server\Logs. Each BlackBerry Enterprise Server instance saves the log files in folders that it creates daily and organizes by date. To prevent the BlackBerry Enterprise Server log files from taking up too much disk space, you can change how BlackBerry Enterprise Server components create and delete log files.
By default, the BlackBerry Enterprise Server names log files <server_name>_<component_identifier>_<instance>_<yyyymmdd>_<log_number>.txt (for example, BBServer01_MAGT_01_20070120_0001.txt). An event that the BlackBerry Enterprise Server writes to a log file begins with a five-digit number, where the first digit represents the logging level. For example, the following log file entry logs level 3, which are informational level events: [30000] (03/12 14:03:42.315):{0x18CC} [ENV] Computer Host Name: host_name.
Component identifiers for log files
You can identify the names for the BlackBerry® Enterprise Server log files using the following component identifiers:
Component identifier |
Logging component |
|---|---|
ACNV |
|
ADLSYNC |
|
ALRT |
|
APP |
|
ASCL |
|
ASMN |
|
ASRV |
|
BBAS-AS |
|
BBAS-NCC |
|
BBIM |
|
BBMS |
|
BBMS-APP |
|
BBMS-DCS |
|
BBMS-ENG |
|
CBCK |
backup connector |
CMNG |
management connector |
CNGW |
|
CONN |
|
CTRL |
|
CWPA |
|
CWQM |
|
DBNS |
|
DCS |
|
DISP |
|
EXTS |
extension connector |
GWCO |
|
GWSV |
|
GWSC |
|
HHCG |
|
MAGT |
|
MAST |
|
MDAT |
|
MDSS |
|
POLC |
|
ROUT |
|
SYNC |
|
TAT |
Change the location where BlackBerry Enterprise Server components save log files
- In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- Click Edit instance.
- In the General section, in the Log file path field, type the path where you want to save the log files.
- Click Save all.
- On each computer that hosts a BlackBerry® Enterprise Server component or BlackBerry Enterprise Server service, in the Windows® Services, restart the BlackBerry Enterprise Server services.
Store the log files for BlackBerry Enterprise Server components in one folder
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- Click Edit instance.
- In the General section, in the Create folder for daily logs drop-down list, click False.
- Click Save all.
- On each computer that hosts a BlackBerry Enterprise Server component or BlackBerry Enterprise Server service, in the Windows® Services, restart the BlackBerry Enterprise Server services.
Add a prefix to the file names of the log files for BlackBerry Enterprise Server components
- In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- Click Edit instance.
- In the General section, in the Log file prefix field, type the prefix that you want to add to the log files.
- Click Save all.
- On each computer that hosts a BlackBerry® Enterprise Server component or BlackBerry Enterprise Server service, in the Windows® Services, restart the BlackBerry Enterprise Server services.
Change the maximum size of the log file for a BlackBerry Enterprise Server component
When the log file for a BlackBerry® Enterprise Server component reaches its maximum size, the BlackBerry Enterprise Server either creates an additional log file for the component or overwrites the current one, depending on whether you turn on log auto-roll.
By default, log auto-roll is turned on for all BlackBerry Enterprise Server components, which means that the BlackBerry Enterprise Server creates an additional log file when the current log file reaches its maximum size.
You can specify a different maximum size for each log file.
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- On the Logging details tab, click Edit instance.
- In each section, in the Maximum size of daily log files (MB) field, type the file size.
- Click Save all.
- On the Servers and components menu, locate and restart the components that contain the logging settings that you changed.
Change the logging level for a BlackBerry Enterprise Server component
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- On the Logging details tab, click Edit instance.
- In each section, in the Log level drop-down list, click one of the following menu items:
- To write error messages to the log files, click Error.
- To write warning messages to the log files, click Warning.
- To write daily activities to the log files, click Information.
- To write additional information to the log files that can help you troubleshoot issues with your organization's environment, click Debug.
- Click Save all.
- On the Servers and components menu, locate and restart the components that contain the logging settings that you changed.
Create an additional log file for a BlackBerry Enterprise Server component when the current log file reaches its maximum size
If you turn on log auto-roll for a BlackBerry® Enterprise Server component, the BlackBerry Enterprise Server creates a new log file for the component when the current log file reaches the maximum size. If you turn off log auto-roll for a BlackBerry Enterprise Server component, the BlackBerry Enterprise Server overwrites the current log file for the component when the log file reaches the maximum size. By default, log auto-roll is turned on for all BlackBerry Enterprise Server components.
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- On the Logging details tab, click Edit instance.
- In each section, in the Log auto-roll drop-down list, click True.
- Click Save all.
- On the Servers and components menu, locate and restart the components that contain the logging settings that you changed.
Change the identifier of the log file for a BlackBerry Enterprise Server component
You can identify the log file for a BlackBerry® Enterprise Server component by the identifier that is included in the file name. For example, a log file that is named BBServer01_SYNC_01_20080120_001.txt uses the default component identifier SYNC to identify the BlackBerry Synchronization Service component.
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- On the Logging details tab, click Edit instance.
- In each section, in the Log identifier field, type a new identifier name.
- Click Save all.
- On the Servers and components menu, locate and restart the components that contain the logging settings that you changed.
Prevent a BlackBerry Enterprise Server component from creating a daily log file
- In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- On the Logging details tab, click Edit instance.
- In each section, in the Daily file creation drop-down list, click False.
- Click Save all.
- On the Servers and components menu, locate and restart the components that contain the logging settings that you changed.
Configure when the BlackBerry Enterprise Server deletes a log file
- In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- On the Logging details tab, click Edit instance.
- In each section, in the Maximum age of daily log files field, type the number of days that you want the BlackBerry® Enterprise Server to delete the log files after.
- Click Save all.
- On the Servers and components menu, locate and restart the components that contain the logging settings that you changed.
Change the character encoding of the log file for a BlackBerry Enterprise Server component
- In the BlackBerry Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that contains the logging settings that you want to change.
- On the Logging details tab, click Edit instance.
- In each section, in the Log encoding drop-down list, click one of the following character encodings:
- Click Save all.
- On the Servers and components menu, locate and restart the components that contain the logging settings that you changed.
Restore logging settings to default values for all components
- In the BlackBerry® Administration Service, on the Servers and components menu, expand BlackBerry Solution topology > BlackBerry Domain > Component view > Logging.
- Click the instance that you want to restore to default values.
- On the Logging details tab, click Edit instance.
- Click Reset logging defaults.
- Click Save all.
- For the changes to take effect, perform any of the following actions to restart the BlackBerry® Enterprise Server services:
- To restart services other than the BlackBerry Administration Service, on the Servers and components menu, locate and restart the services that you restored to default values.