MicroStrategy ONE
Response Configuration Parameters and Options
MicroStrategy recommends that you always create the response file through the GUI mode of the Configuration Wizard. However, you can also modify a response file with a text editor to make minor changes such as entering different user login and password information.
If you are manually editing the response file, make sure to save the file using ANSI encoding.
Upgrading Intelligence Server Components and Projects
The response file parameters in the [UpgradeServer]
section upgrade Intelligence Server components and projects. The table below lists the available parameters and the functionality of available options for each parameter. The options marked with Removed from 11.3.1 are ignored in the Configuration Wizard when upgrading Intelligence Server components using 11.3.1 and above.
Options |
Description |
|
In this section you can upgrade Intelligence Server components and the projects for an Intelligence Server. |
|
Defines whether to upgrade Intelligence Server components and projects, as determined by the following values:
|
|
Defines whether to upgrade the metadata, as determined by the following values:
|
Removed from 11.3.1 |
Defines whether to upgrade administrative privileges, as determined by the following values:
|
|
Defines whether to migrate History List from a flat file to a database, as determined by the following values:
|
|
Defines whether to upgrade projects, as determined by the following values:
|
|
Provide the user name for the MicroStrategy user to connect to the Intelligence Server to upgrade. |
|
Provide the password for the MicroStrategy user to connect to the Intelligence Server to upgrade. |
|
Provide the password for the metadata to upgrade. |
Removed from 11.3.1 |
If you have previously upgraded the metadata but not upgraded the privileges, provide the version of the metadata that you most recently upgraded your privileges to, from the following list of options: 9.4 9.5 9.5.1 10 10.1 10.2 10.3 10.4 10.5 10.6 10.7 10.8 10.9 10.10 10.11 |
HLTarget= |
If performing a History List migration, the type of History List to migrate to: File Database Hybrid |
|
If performing a History List migration, defines the directory location of the History List flat file to migrate to a database. |
HybridPath= |
If performing a History List migration to a hybrid History List, defines the directory location where the hybrid History List files are to be stored. |
|
If performing a History List migration, defines the DSN of the database to migrate the History List tables to. |
|
If performing a History List migration, defines the user name to connect to the database for the History List migration. |
|
If performing a History List migration, defines the password to connect to the database for the History List migration. |
|
If performing a History List migration, defines the table prefix for History List tables. |
|
Defines whether to drop existing tables in the database used for the History List migration, as determined by the following values:
|
|
Defines whether to delete the file based History List after the migration is complete, as determined by the following values:
|
|
Defines whether UTF-8 encoding should be used for the History List migration on Windows, as determined by the following values:
|
|
Defines whether UTF-8 encoding should be used for the History List migration on UNIX/Linux, as determined by the following values:
|
|
Defines the database name to create or migrate History Lists stored in DB2 z/OS. This option should be used if connecting to a DB2 z/OS database. |
|
Defines the table name to be used in the database when creating or migrating the History List. This option should be used if connecting to a DB2 z/OS database. |
ThreadNumber |
If performing a History List repository upgrade to a hybrid History List, defines the number of database threads to use for the upgrade. |
|
Defines the projects to update their schedules that send reports and documents to caches, History Lists, and MicroStrategy Mobile as subscriptions. These subscriptions are part of the integrated subscription and delivery features in Intelligence Server 9.0 and later versions. They provide the same ability to send reports and documents to caches, History Lists, and MicroStrategy Mobile as the schedules in MicroStrategy pre-9.0. This option also upgrades the reports and Report Services documents in the projects, which improves performance, reduces storage space requirements, and ensures that graphs display correctly in MicroStrategy Web 10 and Developer 10. To upgrade multiple projects, you must enclose the name of each project in curly braces
|
Removed from 11.3.1 |
Defines the projects to upgrade their schedules to the most recent version of MicroStrategy. To upgrade multiple projects' schedules, you must enclose the name of each project in curly braces
|
Removed from 11.3.1 |
Defines the projects to update their MDX source objects (MDX cubes) that were created in earlier versions of MicroStrategy to take advantage of increased performance and other updates. You can integrate MDX sources such as SAP BW, Microsoft Analysis Services, and Hyperion Essbase into your MicroStrategy environment. For information on integrating MDX sources into MicroStrategy, see the MDX Cube Reporting Guide. To upgrade multiple projects' MDX source objects, you must enclose the name of each project in curly braces
|
|
Defines the projects for which to update system objects so that objects can be moved between unrelated projects using MicroStrategy Object Manager. This is required for projects from pre-9.0.1 versions of MicroStrategy. To upgrade multiple projects' system objects, you must enclose the name of each project in curly braces
|
|
Defines whether to update the rest of the specified projects if one project update generates an error:
|
|
Defines whether the password is encrypted in the response file, as determined by the following values:
|
|
Defines the database name to update metadatas stored in DB2 z/OS. This option should be used if connecting to a DB2 z/OS database. |
|
Defines the table name to be used in the database when upgrading the metadata. This option should be used if connecting to a DB2 z/OS database. |
LeanObjects= Removed from 11.3.1 |
Defines whether to perform Lean Objects migration at the server level:
|
LeanObjectsProjects= Removed from 11.3.1 |
Defines whether to perform Lean Objects migration at the project level:
|
Upgrading Statistics Repositories
The response file parameters in the [UpgradeStats]
section upgrade statistics and Enterprise Manager repositories. The table below lists the available parameters and the functionality of available options for each parameter.
Options |
Description |
|
In this section you can upgrade statistics repositories to the most recent version of MicroStrategy. You can have more than one |
|
Defines whether to upgrade the statistics and Enterprise Manager repositories, as determined by the following values:
|
|
Defines whether the password is encrypted in the response file, as determined by the following values:
|
|
If performing a statistics repository upgrade, defines the DSN of the database that stores the statistics repository. |
|
If performing a statistics repository upgrade, defines the user name to connect to the database for the statistics repository. |
|
If performing a statistics repository upgrade, defines the password to connect to the database for the statistics repository. |
|
If performing a statistics repository upgrade, defines the database prefix for the statistics repository. |
Upgrading an Enterprise Manager Project
The response file parameters in the [EMProjectHeader]
section upgrade an Enterprise Manager project. The table below lists the available parameters and the functionality of available options for each parameter.
Options |
Description |
|
In this section you can upgrade an Enterprise Manager project to the most recent version of MicroStrategy. You can have more than one |
|
Defines whether to upgrade the Enterprise Manager project, as determined by the following values:
|
|
Defines whether the password is encrypted in the response file, as determined by the following values:
|
|
If performing an Enterprise Manager project upgrade, provides the MicroStrategy user name that can access and administer the Enterprise Manager project. |
|
If performing an Enterprise Manager project upgrade, provides the password for the MicroStrategy user that can access and administer the Enterprise Manager project. |
|
If performing an Enterprise Manager project upgrade, defines the DSN of the database that stores the statistics tables and Enterprise Manager repository. |
|
If performing an Enterprise Manager project upgrade, defines the user name to connect to the database for the statistics tables and Enterprise Manager repository. |
|
If performing an Enterprise Manager project upgrade, defines the password to connect to the database for the statistics tables and Enterprise Manager repository. |
|
If performing an Enterprise Manager project upgrade, defines the database prefix for the statistics tables and Enterprise Manager repository. |
Upgrading History List Repositories
The response file parameters in the [UpgradeHistoryList]
section upgrade a database-based History List repository. The table below lists the available parameters and the functionality of available options for each parameter.
Options |
Description |
|
In this section you can upgrade History List repositories to the most recent version of MicroStrategy. You can have more than one |
|
Defines whether to upgrade a History List repository, as determined by the following values:
|
|
Defines whether the password is encrypted in the response file, as determined by the following values:
|
|
If performing a History List repository upgrade, defines the DSN of the database that stores the History List repository. |
|
If performing a History List repository upgrade, defines the user name to connect to the database for the History List repository. |
|
If performing a History List repository upgrade, defines the password to connect to the database for the History List repository. |
|
If performing a History List repository upgrade, defines the database prefix for the History List repository. |
CopyContent= |
If performing a History List repository upgrade, upgrades existing History List messages to the specified format, as determined by the following values:
Regardless of this setting, the new database tables required for the new History List format are created, and any new History List messages are created in the new format. |
CompressData= |
If performing a History List repository upgrade, compresses all existing History List messages, as determined by the following values:
|
Migrating Web Delivery Subscriptions from Narrowcast Server to MicroStrategy Distribution Services
The response file parameters in the [UpgradeServer]
section migrate MicroStrategy Web delivery subscriptions from a Narrowcast Server environment to Distribution Services. MicroStrategy Web delivery subscriptions include email, file, and print subscriptions created from MicroStrategy Web. Migrating these subscriptions from Narrowcast Server to Distribution Services allows the subscriptions to be centralized in Intelligence Server rather than a separate Narrowcast Server. The table below lists the available parameters and the functionality of available options for each parameter.
Options |
Description |
||
|
In this section you can migrate MicroStrategy Web delivery subscriptions from a Narrowcast Server environment to Distribution Services. You can have more than one |
||
|
Defines whether to migrate MicroStrategy Web delivery subscriptions from a Narrowcast Server environment to Distribution Services, as determined by the following values:
|
||
|
Defines the DSN of the database that stores the Narrowcast Subscription Book Repository. |
||
|
Defines the user name to connect to the database for the Narrowcast Subscription Book Repository. |
||
|
Defines the password to connect to the database for the Narrowcast Subscription Book Repository. |
||
|
Defines the prefix used for the tables of the Narrowcast Subscription Book Repository. |
||
|
Defines the DSN of the database that stores the Narrowcast Object Repository. |
||
|
Defines the user name to connect to the database for the Narrowcast Object Repository. |
||
|
Defines the password to connect to the database for the Narrowcast Object Repository. |
||
|
Defines the prefix used for the tables of the Narrowcast Object Repository. |
||
|
Defines the project source that the Web delivery subscriptions are migrated to. |
||
|
Defines the user name to connect to the project source. |
||
|
Defines the user password to connect to the project source. |
||
|
Defines the projects, for a project source, to migrate Web subscriptions from Narrowcast Server to Distribution Services. You can select multiple projects, separating projects by the |
||
|
Defines whether to migrate all users of Web deliveries to Distribution Services, as determined by the following values:
|
||
|
If you choose to migrate all users of Web deliveries to Distribution Services, this option defines whether to grant the Use Distribution Services privilege for all Web delivery users that are migrated to Distribution Services, as determined by the following values:
|
||
|
Defines whether to migrate Narrowcast Server users and their addresses as contacts in Distribution Services, as determined by the following values:
|
||
|
These parameters specify the conflict resolution rules when migrating Narrowcast objects to Distribution Services. Conflicts occur when identical objects are present in both the Narrowcast Server system you are migrating from and the Intelligence Server metadata you are migrating to. Defining conflict resolution rules determines how these conflicts are resolved during the migration. You can use the following parameters to define how to resolve any conflicts during the migration:
For each object type listed above, you can define conflict resolution rules based on matching IDs. For transmitters, devices, and schedules you can also define conflict resolution rules based on matching definitions. These options are described in the table below. In the table below, "source" refers to your Narrowcast Server and "destination" refers to the new metadata tables. |
||
|
|||
|
|||
|
|||
|
|||
Match by ID or Definition |
Conflict Resolution |
Option Value |
|
Match by IDs Objects are matched by their ID only. |
Match by IDs, keep existing If objects with matching IDs are found, the object in the destination location is kept. The object in the source is not migrated to the destination. |
1 |
|
Match by IDs, replace If objects with matching IDs are found, the object from the source replaces the matching object in the destination. |
2 |
||
Match by Definition Objects are matched by their definitions. This enables objects that have the same definition, but different IDs to be defined as a match. These conflict resolution options are available for transmitters, devices, and schedules. |
Match by Definition, merge If objects with matching definitions are found, all dependent objects of the matching object in the source are migrated to the destination. The migrated dependent objects are defined as dependents of the matching object in the destination. |
3 |
|
Match by Definition, create new If objects with matching definitions are found, the matching object in the source is migrated to the destination as a new object. A separate object for the matching object in the destination is also kept. This results in two objects with matching definitions in the destination, which you can modify after the migration is complete. |
4 |
||
|
Defines whether the password is encrypted in the response file, as determined by the following values:
|