EducationSoftwareStrategy.com
StrategyCommunity

Knowledge Base

Product

Community

Knowledge Base

TopicsBrowse ArticlesDeveloper Zone

Product

Download SoftwareProduct DocumentationSecurity Hub

Education

Tutorial VideosSolution GalleryEducation courses

Community

GuidelinesGrandmastersEvents
x_social-icon_white.svglinkedin_social-icon_white.svg
Strategy logoCommunity

© Strategy Inc. All Rights Reserved.

LegalTerms of UsePrivacy Policy
  1. Home
  2. Topics

KB16575: How to specify a temporary directory for MicroStrategy Intelligence Server on Linux / UNIX?


Community Admin

• Strategy


MicroStrategy Intelligence Server uses the system environment variable $TMPDIR for the temporary file location

Strategy Intelligence Server running in Linux or UNIX environments uses the system's temporary directory for pipe files that are used for database communication. System administrators may wish to segregate the Strategy Intelligence Server Universal temporary files into a separate location, so that they do not interfere with other processes' temporary files.
Interprocess communication can also be done through shared memory, which does not have to use named pipes. However, if users choose to, they can continue using named pipes for interprocess communication.
 
Strategy Intelligence Server uses the system environment variable $TMPDIR for the temporary file location. Thus, the location may be changed manually by changing the value of the variable prior to starting the Strategy Intelligence Server from the commandline. For example, using the tcsh shell:
 
...> set TMPDIR "/path/to/temp/directory"
Following this, Strategy Intelligence Server may be started using the mstrctl command from the commandline.
 
...> mstrctl -s IntelligenceServer start
The precise syntax to set the environment variable varies according to the shell that is in use. If users are not sure of the command, they should check with the UNIX system administrator.
 
Setting the environment variable is local to the shell session in which Strategy Intelligence Server is started. If Strategy Intelligence Server needs to be restarted from a different shell session (for instance, after logging into the server machine again), the environment variable will need to be set again.
 
If it is required to set this location for every Strategy Intelligence Server startup, the temporary file location may be set in the Principal.sh script, located in /env. In the section at the top (identified by the comment "define principal variables"), the following may be added:
 
TMPDIR=/path/to/temp/directory
export TMPDIR
The Principal.sh script is executed when launching any of the Strategy UNIX executables, thus ensuring that all Strategy Intelligence Server components will use the specified directory for temporary files.
 
Note: Strategy Intelligence Server shell scripts are written for the ksh shell, so the above syntax should be used regardless of the user's shell preference.
 
Note: It is never recommended to change the temporary directory location while Strategy Intelligence Server is running. Always stop the server prior to making this environment change.
 
WARNING:
Modifying environment variables, or Strategy shell scripts, incorrectly may cause serious, system-wide problems that may prevent the proper functioning of Strategy Intelligence Server Universal, or of the UNIX operating system. Any such modifications are done at the user's own risk. Since these are user-initiated changes, they are not covered by any Strategy warranty.
 


Comment

0 comments

Details

Knowledge Article

Published:

June 12, 2017

Last Updated:

June 12, 2017