Bookshelf Home | Contents | Index | Search | PDF |
Upgrade Guide for UNIX > Postupgrade Tasks > Postupgrade Tasks for All Environments >
Migrating Custom Business Components and Resolving Conflicts
This procedure only applies to development environment upgrades from Release 6.x to Release 7.5.
CAUTION: Skip this procedure if you are upgrading a production environment or if you are upgrading from Release 7.x to Release 7.5.
After the Upgrade Siebel Database Schema phase, thoroughly review the post upgrade configuration to make sure that the object level definitions are preserved as expected.
The access control buscomp migration utility, upgcust.exe, is run on the Prior Customer Repository by the Upgrade Wizard during upgrade of the Siebel database schema. This utility reconfigures custom business component configurations on obsolete tables. However, you may need to perform manual steps to business component fields and joins, depending upon the complexity of your business component configuration, because in some cases, not all custom business component configurations are reconfigured by the access control buscomp migration utility. For example, complex customized business component configurations and customer business components which are based on customer extension columns or on Siebel columns in obsolete tables need to be identified and manually fixed after the upgrade.
During the upgrade, the access control buscomp migration utility, upgcust.exe, generates a log file titled
upgcust.log
that contains a list of business component joins and fields that need to be manually rectified. This particular log file, along with others generated by the upgrade process, can be found underSIEBEL_ROOT
/log.
The log file contains two distinct sections:
- Part 1
For extension columns on obsolete tables such as S_EMPLOYEE and S_ORG_INT, you need to reimplement the extension columns on the replacement tables. After you have done this, review the business component definition to verify proper operation.
The report generated by part 1 of the log file provides a list of the business component fields that are based on custom extension columns in obsolete tables such as S_EMPLOYEE and S_ORG_INT. This list displays the following properties:
- Business Component Name
- Field Name
- Column Name
The table S_EMPLOYEE is migrated to three tables, S_CONTACT, S_EMP_PER and S_USER. After you have determined and implemented the approach for previously defined custom extension columns on obsolete tables, you should manually configure the business component field to reference that database column. Any manual reconfiguration must be done in the New Customer Repository after the upgrade has been run.
- Part 2
After the repository merge has been run, there may be inconsistencies in the join names and joins set at the field level due to merge behavior. If you do not resolve these discrepancies, the application configuration may result in errors or result in incorrect behavior. The report generated by part 2 of the log file provides a list of joins that were not updated during the merge process. This list displays the following properties:
- Business Component Name
- Join Name
With this list, you must go to each of the Business Component definitions and manually change the join name from the current value to the value listed in the report. Make sure that there is consistency between the joins as defined by name and the joins defined for each of the fields. Again, any manual configuration must be done in the New Customer Repository after the upgrade has been run. For more information about working with Business Component definitions and joins, see Siebel Tools Online Help.
Bookshelf Home | Contents | Index | Search | PDF |
Upgrade Guide for UNIX Published: 20 October 2003 |