Share this page

# Using exception files for manual database changes

This topic provides instructions for defining exception files. Use exception files if the organization's DBA added objects to database schemas, such as tables, indexes, stored procedures, columns, or other objects.

In this topic:

## Overview

Exception files instruct OpenText Software Delivery Management to ignore any errors issued because of manual additions to the database schema. These errors would typically stop the installation or upgrade process.

You can use exception files to ignore errors for extra tables, views, columns, and sequences. For any other problem, consult with your database administrator.

Caution: Using the exception file to ignore errors for objects that are added manually to the schema may compromise stability and the validity of the database user schema.

You can use the exception files during a new installation, when upgrading, and when creating a space.

(missing snippet link)

## Define exception files

Define exception files before installation, before upgrading, or before you create the new spaces.

To define exception files:

1. Copy both of the mqm_exception.xml files from the installation directories. You can rename them.

2. Locate the MQM_EXCEPTIONS part of the file.

       <MQM_EXCEPTIONS>
           <exceptions>
               <declaration>
                   <!--<object pattern="TABLE_1_EXAMPLE" type="missing" />-->
                   <!--<object pattern=" TABLE_1_EXAMPLE" type="extra" />-->
               </declaration>
           </exceptions>
       </MQM_EXCEPTIONS>

3. Change the <declaration> to one of the following. Add as many declarations as you need.

   - TableMissing

   - ViewMissing

   - ColumnMissing

   - ConstraintMissing

   - IndexMissing

   - PartitionFunctionMissing

   - PartitionSchemeMissing

   - ProcedureMissing

   - SequenceMissing

   - TriggerMissing

4. For each object pattern, you can specify one of the following types.

   Object | Description
   --- | ---
   missing | The object is needed but is missing.
   extra | The object is extra because it was created after installation or before upgrading.

### Examples

- For an extra table:

      <TableMissing>
               <object pattern="MY_Table" type="extra"/>
      </TableMissing>

- For an extra view:

      <ViewMissing>
               <object pattern="MY_VIEW" type="extra"/>
      </ViewMissing>

- For an extra column:

      <ColumnMissing>
               <object pattern="MY_COLUMN" type="extra"/>
      </ColumnMissing>

- For an extra sequence:

      <SequenceMissing>
               <object pattern="MY_SEQUENCE" type="extra"/>
      </SequenceMissing>

(missing snippet link)

## Set up use of the exception file

This topic explains how to use the exception file when installing OpenText Software Delivery Management, when upgrading, or when creating a new space.

### Use of the exception files during first-time installation

You can use exception files when installing OpenText Software Delivery Management using existing schemas/databases instead of having OpenText Software Delivery Management create new schemas for you. This is the FILL_EXISTING installation option and it is set in the octane.conf file.

1. During installation, when configuring the octane.conf file in the configuration folder, add these two settings using an editor.

   Setting | Description
   --- | ---
   MqmExceptionsSiteAdminPath | The exception file for the site. Linux: /opt/tmp/site/mqm_exceptions.xml Windows: C:/temp/site_admin/mqm_exception.xml
   MqmExceptionsSharedSpacePath | The exception file for the default space. Linux: /opt/tmp/shared_space/mqm_exceptions.xml Windows: C:/temp/shared_space/mqm_exception.xml

2. Continue installing.

3. Check that the server is up and that you have proper access to the site and the default space.

### Use of the exception files when upgrading

You can use exception files when upgrading OpenText Software Delivery Management.

After installation, the exception files are copied to the repository folder. So when upgrading, modify the copies of the exception files in the repository folder instead of the files in the configuration folder.

1. During the upgrade, when configuring the octane.conf file in the repository folder, add or modify these two settings using an editor.

   Exception file | Path
   --- | ---
   File for the site | Linux: /opt/octane/repo/storage/schema/maintenance/exceptions/site_admin/mqm_exception.xml Windows: C:\Program Files\octane\repo\storage\schema\maintenance\exceptions\site_admin\mqm_exception.xml
   File for the new space | Linux: /opt/octane/repo/storage/schema/maintenance/exceptions/shared_space/mqm_exception.xml Windows: C:\Program Files\octane\repo\storage\schema\maintenance\exceptions\shared_space\mqm_exception.xml

2. Continue upgrading.

3. Check that the server is up and that you have proper access to the site and the default space.

### Use of the exception files when creating a space

The exception files are also processed when adding new spaces.

After installation, the exception files are copied to the repository folder.

Before adding a new space, modify the copies of the exception files in the repository folder instead of the files in the configuration folder.

1. Add exceptions as necessary to the exception files using an editor.

   Exception file | Path
   --- | ---
   File for the site | Linux: /opt/octane/repo/storage/schema/maintenance/exceptions/site_admin/mqm_exception.xml Windows: C:\Program Files\octane\repo\storage\schema\maintenance\exceptions\site_admin\mqm_exception.xml
   File for the new space | Linux: /opt/octane/repo/storage/schema/maintenance/exceptions/shared_space/mqm_exception.xml Windows: C:\Program Files\octane\repo\storage\schema\maintenance\exceptions\shared_space\mqm_exception.xml

2. In OpenText Software Delivery Management Settings area, add the space using an existing schema. For details, see Create a space.

3. Check that you have proper access to the space.

(missing snippet link)

## See also

- Configure site settings
- Management

https://admhelp.microfocus.com Software Delivery Management 8942
Tips to improve your search results... OpenText™ Software Delivery Management Help Center OpenText™ Software Delivery Management Help 26.3 All View Local Help Center View Online Help Center Version: