In this section: How to: |
A utility is provided to migrate the Business Intelligence Dashboard (BID). The Dashboard migration utility copies Dashboard files for use with the latest WebFOCUS release from the following directory:
/install_directory/ibi/WebFOCUS7x/worp
The entire worp directory is not migrated. Only the following selected files and directories are migrated.
Folders
.../worp/worp_users
.../worp/worp_custom
.../worp/components/userdata (if folder exists)
Custom Templates
The template directories must be prefixed with custom_ under the\worp\worp_html directory. Otherwise, the custom templates need to be copied manually to the WebFOCUS80\worp_html directory.
Files Migrated From /worp/conf
mpv.xml
xxx.tbx (if file exists)
To properly migrate, you must use the Dashboard migration utility. Manually copying directories and files into the WebFOCUS80 directory structure does not guarantee a functioning Dashboard environment.
Note:
/install_directory/ibi/WebFOCUS80/worp/worp_users/[username]
Migration Steps
The migration consists of the following steps:
This step extracts data from the earlier (source) release into a file named migrate.zip.
This step loads the data in the migrate.zip file.
The following WebFOCUS 8 directory must be copied to the \ibi\WebFOCUS7x\utilities directory prior to the start of migration:
\ibi\WebFOCUS80\utilities\mr
The following migration utility file is used to migrate:
Windows
\ibi\WebFOCUS80\utilities\mr\bidmigrate.bat
UNIX
/ibi/WebFOCUS80/utilities/mr/bidmigrate
After the extraction process, your source data is placed in the migrate.zip file under a newly created export directory found under the \utilities\mr directory.
For example:
\ibi\WebFOCUS77\utilities\mr\export\migrate.zip
The .zip file contains the extracted contents. A bid_extract.log file is also created in the export directory.
The migrate.zip file must be copied to the \ibi\WebFOCUS80\migration_import directory on the WebFOCUS 8 machine, so the bidmigrate utility finds it when loading data into WebFOCUS 8.
drive:\ibi\WebFOCUS77\utilities\mr>bidmigrate extract WebFOCUS_worp_directory_location WebFOCUS_Release_to_be_migrated
For example,
C:\ibi\WebFOCUS77\utilities\mr>bidmigrate extract
C:\ibi\WebFOCUS77\worp 77
or
drive:\ibi\WebFOCUS77\utilities\mr>bidmigrate
The main menu opens, as shown in the following image.
You are prompted for the Dashboard directory for the release that you are migrating. A directory may appear by default if the worp directory exists under the WebFOCUS installation directory.
The migration utility also migrates three directories outside of the worp directory under the /ibi_html directory (publish, template, prepared).
When the extract completes, you receive the following message.
The migrate.zip and bid_extract.log files are created under:
\ibi\WebFOCUS77\utilities\mr\export\migrate.zip
Execute the following:
/install_directory/ibi/WebFOCUS77/utilities/mr ./bidmigrate extract WebFOCUS_worp_directory_location WebFOCUS_Release_to_be_migrated
For example,
/install_directory/ibi/WebFOCUS77/utilities/mr ./bidmigrate extract /ibi/webfocus77/worp 77
or
/install_directory/ibi/WebFOCUS77/utilities/mr ./bidmigrate
The following prompt is displayed:
You are prompted for the Dashboard directory for the release that you are migrating. A directory may appear, by default, if the worp directory exists under the WebFOCUS installation directory.
Note: The migration utility also migrates three directories outside of the worp directory under the /ibi_html directory (published, template, prepared).
The utility prompts for the WebFOCUS release number that you are migrating from, as shown in the following image:
When the extract completes, you receive the following message:
The migrate.zip and bid_extract.log files are created under:
/ibi/WebFOCUS77/utilities/mr/export/migrate.zip
The load step loads the contents of migrate.zip for the new WebFOCUS release.
You must copy the migrate.zip file from the /ibi/WebFOCUS7x/utilities/mr directory to the \ibi\WebFOCUS80\migration_import directory on the WebFOCUS 8 machine.
To run the load step on the Windows platform:
C:\ibi\WebFOCUS80\utilities\mr>bidmigrate load Release_of_WebFOCUS_to_be_migrated
For example:
C:\ibi\WebFOCUS80\utilities\mr>bidmigrate load 77
or
C:\ibi\WebFOCUS80\utilities\mr>bidmigrate
The main menu appears, as shown in the following image.
When the load completes, you receive the following message:
The bid_load.log file is created under the ibi\WebFOCUS80\migration_import directory.
Execute the following
/install_directory/ibi/WebFOCUS80/utilities/mr ./bidmigrate load 77
or
/install_directory/ibi/WebFOCUS80/utilities/mr ./bidmigrate
The following prompt is displayed:
When the load completes, you receive the following message:
The bid_load.log file is created under the /install_directory/ibi/WebFOCUS80/migration_import directory.
How to: |
The following section describes the BI Dashboard post-migration steps.
Public user configurations performed from View Builder in releases prior to WebFOCUS Version 8 are not migrated. This included defining a Public user for Public Views other than the Public ID and a Public user Reporting Server ID and password.
Public user authorization in a Public view is based on user permissions. In WebFOCUS Version 8, the Public ID is migrated and automatically assigned the WF_Role_Public role. An alternate user ID designated as the Public user needs to be assigned the WF_Role_Public role.
Defining a Public user for Public Views other than the default Public ID and assigning a Public user Reporting Server ID and password require the following post-migration steps.
The Administration Console opens.
Note: This will enable the UDR (User Default Role) tab in the Security Center User dialog box.
WebFOCUS |