In Import mode, a configuration of an analysis realm is imported into PPM. The configuration is available in an XML file created in line with DTD rules.
During the import, you can replace (-replace) or overwrite (-overwrite) an existing analysis realm configuration.
For importing, runppmconfig is called with the following syntax.
runppmconfig –user <user name> -password <password> [-client <client name>] -mode import [-replace | -overwrite] –realm <file name>
The name of the imported analysis realm is the one used in the import file and does not need to be specified.
Each configuration imported is checked and validated. If they are invalid the configuration is not imported and an error message is output. If a warning is output, the import runs and a corresponding message is displayed.
After a successful import, the PPM server deletes the query cache and refills it with favorites queries.
If neither of the parameters -overwrite or -replace has been specified, the analysis realm configuration of the import file is added to the analysis realm configuration on the server. If the analysis realm already exists an error message is displayed. After successful import the new configuration is activated on the analysis server.
The -add parameter is not supported and results in an error.
Import a Cross analytics analysis realm
Under certain circumstances, the import process can take a long time, especially when importing a Cross analytics analysis realm. In this case, the analysis server is creating an internal data structure for the imported process table and perform indexing. The new structure is created when the Cross analytics analysis realm is imported for the first time or if the process table association has changed during another import.