Strategy ONE

CPU Affinity for Intelligence Server on Linux

CPU affinity behaves in a similar manner in both Windows and Linux environments. This section describes details for setting up CPU affinity for running Intelligence Server in a Linux environment.

The ability to set CPU affinity on Linux requires special system-level privileges. MicroStrategy must be run under the root Linux account, otherwise an error message appears.

If the target machine contains more than one physical processor and the MicroStrategy license key allows more than one CPU to run Intelligence Server Universal Edition, you are prompted to provide the number of CPUs to be deployed. The upper limit is either the number of licensed CPUs or the physical CPU count, whichever is lower.

Each Linux platform exposes its own set of functionality to bind processes to processors. However, Linux also provides commands to easily change the processor assignments. As a result, Intelligence Server periodically checks its own CPU affinity and takes steps whenever the CPU affinity mask does not match the overall CPU licensing. Whenever your licenses do not match your deployment, CPU affinity is automatically adjusted to the number of CPUs necessary to be accurate again.

This automatic adjustment for CPU affinity attempts to apply the user's specified CPU affinity value when it adjusts the system, but it may not always be able to do so depending on the availability of processors. For example, if you own two CPU licenses and CPU affinity is manually set to use Processor 1 and Processor 2, the CPU affinity adjustment may reset CPU usage to Processor 0 and Processor 1 when the system is automatically adjusted.

Changing CPU Affinity in Linux

You can specify CPU affinity either through the MicroStrategy Service Manager, or by modifying Intelligence Server options. If you want to view and modify Intelligence Server's options, it must be registered as a service. You can register Intelligence Server as a service using the Configuration Wizard by selecting the Register Intelligence Server as a Service option; alternatively, you can follow the procedure below.

To Set Up Intelligence Server to Run as a Service

  1. Navigate to the bin directory in the installation location.

  2. Enter the following command:

    Copy 
    mstrctl -s [IntelligenceServerName] rs

Whenever you change the CPU affinity, you must restart the machine.