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:

  1. 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 path C:\. If you save it to another file path, replace C:\response.ini with the file path of your response.ini file.

    You must save the response.ini file as ANSI encoding.

  2. Create the setup.iss file to use in conjunction with the response.ini file for the silent installation. Use a text editor to create the setup.iss file with the following information:
    	[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=0

    You 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 enter Version=10.7.0. Entering a version as Version=10 or Version=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 line Lang=LanguageValue, see Language Settings for Silent Installations.

  3. 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.

  4. Click Yes to open the command prompt with administrator privileges. The command prompt is displayed.
  5. Run the silent install with the response.ini file in conjunction with the setup.iss file as follows:

    For an explanation of the LanguageValue parameter, see Language Settings for Silent Installations

    INSTALL_PATH\setup.exe -LLanguageValue --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.

  6. 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.
  7. 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 the setup.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

Danish

0006

Dutch

0019

English

0009

French

0012

German

0007

Italian

0016

Japanese

0017

Korean

0018

Portuguese

0022

Simplified Chinese

2052

Spanish

0010

Swedish

0029

Traditional Chinese

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.