KB36417: How to configure the number of backup MicroStrategy log files to retain on a UNIX/Linux system using the MicroStrategy Control Utility

SUMMARY:
By default, the Strategy Intelligence Server writes information selected to be logged to a file named DSSErrors.log. The default configuration is to retain a single backup of this log, which rolls over as the size of the log reaches the maximum limit. This Knowledge Base article will explain how to use the Strategy Control Utility, mstrctl, from the command line to change how many backup files are retained.
 
ACTION:
In order to check the current settings on a machine, use Strategy Control Utility to get-server-configuration (gsc) by using the following command:

Php
​./mstrctl -s IntelligenceServer gsc | less

 
The output should be similar to the following:
 

Php
<?xml version="1.0"?>

<configuration>

<base_tcp_port_number>34952</base_tcp_port_number>

<log_path>/opt/MicroStrategy/Log</log_path>

<install_path>/opt/MicroStrategy/Install/IntelligenceServer</install_path>

<log_destinations>

<log_destination n="SystemLog" tp="2" callstack_message_ids="0x800438C7"/>

<log_destination n="ServerControl" tp="3" max_size="2048" max_backup="1" callstack_message_ids=""/>

<log_destination n="LicenseSummary" tp="3" max_size="4000" callstack_message_ids=""/>

<log_destination n="DebugOutput" tp="1" callstack_message_ids=""/>

<log_destination n="DSSPerformanceMonitor" tp="4" max_size="2000" callstack_message_ids=""/>

<log_destination n="DSSErrors" tp="3" max_size="2048" max_backup="1" callstack_message_ids="0x800438C7"/>

</log_destinations>

 

 
The section to focus on is the one starting with <log_destinations>. In the above sample output, the Strategy Intelligence Server is using the default backup setting of one file for the DSSErrors.log (note the following max_backup="1").
 

Php
<log_destination n="DSSErrors" tp="3" max_size="2048" max_backup="1" callstack_message_ids="0x800438C7"/>

To change the number of backup log files retained for the DSSErrors.log follow the steps below:

1. To change the current configuration, use the 'ssc' flag when running the mstrctl utility from the <MSTR_HOME>/bin directory: 
   
    
   

   
   Php
   ./mstrctl -s IntelligenceServer ssc
   

   
   
   
2. Modify the XML below to list the proper maximum number of backup files to retain. In the example below, this has been set to five (max_backups="5"). The size of the log in KB can also be modified here by changing the max_size parameter:
   
    
   

   
   Php
   <configuration>
   
   <log_destinations>
   
   <log_destination n="DSSErrors" tp="3" max_size="2048" max_backup="5" callstack_message_ids="0x800438C7"/>
   
   </log_destinations>
   
   </configuration>
   

   
   
   
3. Copy the XML from step two and paste it into the terminal where the mstrctl command from step one is waiting.
   
4. Close the mstrctl utility by closing the execution using Ctrl+D.
   
5. Restart Strategy Intelligence Server for the changes to take effect.
   
    
   

For more information about using the Strategy Control Utility, mstrctl, refer to the following Strategy Knowledge base article:
KB10941: What is the MSTRCtl utility and how is it used in MicroStrategy Intelligence Server 9.x - 10.x
KB36417