In this section: |
This section describes WebFOCUS migration considerations and provides the procedures for migrating WebFOCUS data and settings.
Note: For information on migrating Reporting Server configuration settings, see the Server Administration for UNIX, Windows, OpenVMS, IBM i, and z/OS manual.
How to: Reference: |
The following types of Authentication and Authorization models can be migrated from WebFOCUS 7.x to WebFOCUS 8. Note that the security settings are not migrated, but MR authorization rules from these types of authorization scenarios are migrated.
In WebFOCUS 8, the migration:
Note:
Hex 20 = , ' & * ( ) | ; " ? /
During the migration process, these characters are converted to an underscore (_).
You are prompted for the WebFOCUS version from which you are migrating.
The script exports the current 7x basedir, such as Domains, procedures, content, users, Groups, and role information, to a WebFOCUS7x\utilities\mr\export directory.
Any authorization information stored externally using the Realm Driver (SQL Repository or AD/LDAP), is retrieved and extracted as well.
Note: The Managed Reporting authorization rules implemented in Technical Memo 4624, Configuring the Managed Reporting Repository Filter are not migrated.
Logs are written to the WebFOCUS7x\utilities\mr\export directory by default and named mr_migrate_export.log.
Note: If you are using the Realm Driver with an SQL repository, you must add your JDBC driver or drivers to the script file.
The directory structure looks like the following:
WebFOCUS80\migration_import\export\groups.xml WebFOCUS80\migration_import\export\psets.xml WebFOCUS80\migration_import\export\repos.xml WebFOCUS80\migration_import\export\roles.xml WebFOCUS80\migration_import\export\rules.xml WebFOCUS80\migration_import\export\users.xml WebFOCUS80\migration_import\export\root WebFOCUS80\migration_import\export\root\WFC\UserInfo WebFOCUS80\migration_import\export\root\WFC\Repository (All content below this)
The following table describes the parameters in the export script file.
Parameter |
Description |
---|---|
WFCDIR |
Location of the WebFOCUS root to be exported. Defaults to ..\..\ since the entire 80 Managed Reporting directory is placed in the WebFOCUS7x\utilities directory. |
EXPDIR |
Location of the export files. This last directory does not need to exist, but the path does need to exist. The default directory name is export. If the path is not specified, it is created in the current directory. |
XMLFILE |
Location of roletoudr.xml, including the file name. The default file name is roletoudr.xml. If the path is not specified, it is accessed from the current directory. Do not modify this value. |
PROCTICKET |
Migrates Managed Reporting Deferred Tickets. The default value is NO. |
LOGFILE |
Location of the migrate log file, including name. The default file name is migrate.log. If the path is not specified, it is created in the current directory. |
WEBXML |
Location of the web.xml file, including name. Is used for migrating WebFOCUS 7.1 and WebFOCUS 7.6. For WebFOCUS 7.1, the value defaults to %WFCDIR%\webapps\webfocus71\WEB-INF\web.xml. For WebFOCUS 7.6, the value defaults to %WFCDIR%\webapps\webfocus76\WEB-INF\web.xml. This script assumes that the mr directory from WebFOCUS 8 is copied to the %WFCDIR%\utilities directory. |
JDBC_DRIVER |
If using the Managed Reporting Realm Driver, add JDBC_DRIVER below. If your JDBC driver consists of more than one JAR file, separate multiple JAR file paths with a semicolon (;). For example: JDBC_DRIVER=C:\Program Files\Microsoft SQL Server 2000 Driver for JDBC\lib\mssqlserver.jar; C:\Program Files\Microsoft SQL Server 2000 Driver for JDBC\lib\msutil.jar; C:\Program Files\Microsoft SQL Server 2000 Driver for JDBC\lib\msbase.jar |
The logging level options are displayed, as shown in the following image.
The logging level options are displayed.
Note: Logs are written to the WebFOCUS80\migration_import\export directory. The log file name is import_migration.log.
The following table describes the parameters in the import script file.
Parameter |
Description |
---|---|
USERNAME |
UOA username. The default value is admin. |
PASSWORD |
UOA password. If you are using a trusted authentication method, this password will be blank. The default value is admin. |
INSTALLDIR |
Base installation directory. The default value is ../../. |
IBFSIMPORTPATH |
UOA location in which to import a migrated environment. This value should always be set to "IBFS:\WFC" for migration. The default value is IBFS:\WFC. |
WITHRULES |
The import should create rules. This value should always be set to 1 to import rules for a migration. The default value is 1. |
WITHPRIVATES |
The import should import private content, which is the WebFOCUS 7.x user My Reports and Custom Reports. Always set to true for a migration. The default value is true. |
FILETYPE |
File types to be imported. Always set to -1 for a migration. The default value is -1. |
RUNOPTIONS |
Flag to specify validation or run the import. The options are: 1 - To check the import structure and not run the import. 0 - To run the import. The default value is 1. |
IMPORTFROM |
Name of the folder to import. The default folder is migration_import\export. |
JDBC_DRIVER |
Full path to JDBC driver JAR files. If your JDBC driver consists of more than one JAR file, separate multiple JAR file paths with a semicolon. You must provide a value. Note: You must provide a value for the JDBC_DRIVER parameter. |
WebFOCUS |