Implementing Siebel eBusiness Applications on DB2 UDB for OS/390 and z/OS > Siebel Schema Installation on the DB2 Host > Preparing the Database Layout >

Validating the Storage Control File


You must validate the storage control file after you extract it or after you modify it. The validation will produce two output files in the log directory under SIEBSRVR_ROOT:

To validate the storage control file under Windows

  1. Run the Siebel Software Configuration Utility as you did in Extracting a Storage Control File from the DB2 Catalog.
  2. From the Database Utility Selection screen, choose Configure Database and click Next.
  3. The Configure Database screen appears with the following options:

  4. Choose Validate Storage Control File and click Next.
  5. On the ODBC Data Source screen, accept the default name of the ODBC data source after verifying that it is correct (make sure that this has the same name as the subsystem qualifier), or enter a different data source name.
  6. NOTE:  The Siebel Server installation process automatically creates the data source, using the format SiebSrvr_EnterpriseName. To find the name of your ODBC data source, navigate to Start > Settings > Control Panel > ODBC data source. Click the System DSN tab and you will find the name of your ODBC data source.

    To continue, click Next.

  7. On the Database User Name screen, indicate the source user name and password for your database:
  8. Database User Name. Type the ID allowed to log in to the Siebel Database. This user ID should have authorization to set CURRENT SQLID.

    Database Password. Type the password for the ID used to log in to the Siebel database.

    Database Password (confirm). Retype the password to confirm it.

    To continue, click Next.

    The configuration utility will validate your username and password before it will proceed to the next screen. If you entered a valid username and password, the Schema Qualifier screen appears.

  9. On the Siebel Schema Qualifier screen, type the up to eight-character identifier that designates Siebel Schema for your database. This is also an authorization ID. The schema qualifier must start with a letter and cannot contain special characters.
  10. To continue, click Next.

  11. On the Security Group ID screen, type the user ID of the group to whom schema access is granted, for example, SSEROLE.
  12. To continue, click Next.

  13. On the Schema File screen, type the directory paths for your schema file (for example, schema.ddl) and storage control file (for example, storage.ctl).
  14. If schema file verification succeeds, the Configuration Parameter Review screen appears.

  15. On the Configuration Parameter Review screen, review the configuration values you entered on the previous Configuration Utility screens.
  16. NOTE:  Passwords are encrypted and will not appear in plain text either in the user interface or in the upgrade configuration files (UCF files). After a password is entered, it will always appear in encrypted form. If you need to use another password, you must rerun the configuration utility.

    To apply the configuration now, press "OK".

    To apply the configuration later, press "Cancel".

  17. To validate that storage.ctl works, connect to catalog, run ddlimp in validation mode.
  18. Review the log file (ddlimp.log) that is generated in the log subdirectory under SIEBELSRVR_ROOT.

To validate the storage control file under UNIX

  1. Verify that all servers are stopped:
  2. Depending on your shell, source environment variables from $SIEBEL_ROOT by typing:
  3. Korn shell

    . siebenv.sh

    C shell

    source siebenv.csh

  4. Navigate to $SIEBEL_ROOT /bin and enter:
  5. dbsrvr_config.ksh

    This launches the Database Server Configuration Wizard.

  6. Review the values of the following environment variables and confirm whether or not the settings are correct by entering either Y or N.
  7. Specify the path of your Siebel Server root directory or accept the default by pressing Enter.
  8. Specify the path of your database server root directory or accept the default by pressing Enter.
  9. Enter the number that corresponds to IBM DB2 UDB for OS/390 and z/OS, then press Enter.
  10. In the Select Database Operation screen, choose Run Database Utilities (5).
  11. In the Database Utility Selection screen, choose Configure Database (3).
  12. In the Database Configuration Options screen, choose Validate Storage Control File (2).
  13. Enter your source ODBC connection name.
  14. NOTE:  This needs to be the same as the actual name of your subsystem. That is, your database alias within DB2 Connect must be the same as the actual name of your DB2 subsystem.

  15. Enter your source database username and password.
  16. Enter the schema qualifier for your existing database (enter this value in all uppercase characters).
  17. Enter the security group ID for your existing database, or accept the default (SSEROLE) by pressing Enter.
  18. Specify the storage control file that you would like to validate.
  19. The configuration parameters are listed.

  20. When the program asks if you would like to run srvrupgwiz, enter Y for Yes.
  21. The storage control file is validated.

  22. Review the log files generated by ddlimp (ddlimp.log) that is generated in the log directory under SIEBELSRVR_ROOT.

 Implementing Siebel eBusiness Applications on DB2 UDB for OS/390 and z/OS 
 Published: 18 April 2003