MicroStrategy ONE
OEM Silent Installations
You can use silent installation to easily embed MicroStrategy products with other applications. The steps below show you how to use a silent installation to deploy an OEM application on a Windows environment. For additional information on silent installations, see Automated Installation on Windows.
You can follow the steps below to perform a silent installation on a Windows environment. To perform a silent installation on a Linux environment, see Silent Installation.
Ensure that the MicroStrategy installation files are accessible on the machine in which the installation is being performed. If a required installation file is not accessible, the installation can fail, often providing a warning about missing requirements.
To Perform an OEM Silent Installation
When MicroStrategy products are installed as software bundled with another product, the following procedure is strongly recommended:
-
Create an installation response file (
response.ini
) for the MicroStrategy products to install. The table that follows shows which sections of the file are mandatory and which are optional.For detailed information regarding the contents of the
response.ini
file, see Configuring a response.ini File to Install MicroStrategy.Response File Section
Selection
[Installer]
Required
HideAllDialogs =
Required
PreventReboot =
Optional
StopAllServices =
Optional
StopIIS =
Optional
CheckRenameOperations =
Optional
[UserRegistration]
Required
[ComponentSelection]
Required
EnterpriseManagerSelect =
Required
[InitialPaths]
Required
EnterpriseManager =
Required Setting
HideAllDialogs = TRUE
causes the script for the response file to:Use default values as specified in the
response.ini
file.Not require user input.
Keep the dialog flow consistent from one instance to the next. Consistency in the response file script from one instance to the next is necessary; if
setup.iss
detects an inconsistency in the dialog flow, installation is terminated and a log file for the failure is created.The only dialog flow modifications pertinent to silent installation are specific to file location. Therefore, the only portion of the
response.ini
that may need to be modified is the[InitialPaths]
section.The rest of this procedure assumes you have saved the
response.ini
file to the file pathC:\
. If you save it to another file path, replaceC:\response.ini
with the file path of yourresponse.ini
file.You must save the
response.ini
file as ANSI encoding. -
Create the
setup.iss
file to use in conjunction with theresponse.ini
file for the silent installation. Use a text editor to create thesetup.iss
file with the following information:Copy[InstallShield Silent]
Version=v7.00
File=ResponseFile
[File Transfer]
OverwrittenReadOnly=NoToAll
[Application]
Name=MicroStrategy
Version=x.y.z
#x.y.z represent the version of the MicroStrategy platform
Company=MicroStrategy
Lang=LanguageValue
[{8CCF3F6C-55B7-4A27-8C68-ADF21D0585A2}-DlgOrder]
Count=0You must save the
setup.iss
file as ANSI encoding.The version in the
setup.iss
file must match the MicroStrategy version you are installing exactly. For example, if you are installing version 10.7.0 you must enterVersion=10.7.0
. Entering a version asVersion=10
orVersion=10.7.x
causes an error when trying to perform a silent installation of version 9.3.0.For an explanation of the
LanguageValue
parameter within the lineLang=
LanguageValue
, see Language Settings for Silent Installations. -
From the Windows Start menu, select Programs, then select Accessories, and then right-click Command Prompt and select Run as Administrator. The User Account Control dialog box opens.
The steps to open a Windows command prompt with administrator privileges may be different depending on your version of Windows.
- Click Yes to open the command prompt with administrator privileges. The command prompt is displayed.
-
Run the silent install with the
response.ini
file in conjunction with thesetup.iss
file as follows:For an explanation of the
LanguageValue
parameter, see Language Settings for Silent InstallationsINSTALL_PATH
\setup.exe -L
LanguageValue
--ResponseFile="C:\response.ini" -s -f1"c:\setup.iss" -f2"c:\setup.log"
In the syntax shown above, the
-s
parameter indicates that the installation is to be completely silent. If the-s
parameter is not included in the command, then an interface is displayed during the installation that shows the progress of the installation.If the setup program encounters an invalid value for an installation requirement, the setup terminates and the silent installation is ended. You can review any errors in the
setup.log
file. - If a restart is required after the installation is complete, a restart of the machine is automatically triggered. Power the machine back on to allow for the completion of any configurations that are required after the restart of the machine.
- After the installation is complete, you can check the result of the installation process. If the silent installation is successful, the resulting code value is zero (
ResultCode=0
) in thesetup.log
file. This is the only indication of the installation being completed if the installation is completely silent and a restart of the machine is not required.
Language Settings for Silent Installations
In the final steps of the procedure to run an OEM silent installation:
- You can set MicroStrategy Developer language settings by setting the language value in the
setup.iss
file. - You can bypass the language prompt by running
setup.exe
with the command line option for the language.
The following table lists the values for the different languages that MicroStrategy supports:
Language |
Value |
|
0006 |
|
0019 |
|
0009 |
|
0012 |
|
0007 |
|
0016 |
|
0017 |
|
0018 |
|
0022 |
|
2052 |
|
0010 |
|
0029 |
|
1028 |
For example, to select English as the language:
- For the setup.iss file, change
Lang=
LanguageValue
to:Lang=0009
- To run the silent install, use the command line option as follows:
Path
\setup.exe -L0009
For the command line option, you must type -L
in front of the language code to signify that you are entering a language.