Merak Dbtools Help: December, 2006
Merak Dbtools Help: December, 2006
December, 2006
COPYRIGHT
Copyright © 2006 Schlumberger. All rights reserved.
The information in this document is subject to change without notice. The software described in this document is furnished
under a license agreement. This software may be used or copied only in accordance with the terms of such agreement. It is
against the law to copy the software on any medium except as specifically allowed in the license agreement. No part of this
document may be reproduced or transmitted in any form, or by any means, electronic or mechanical, including
photocopying and recording, for any purpose without the express written permission of Schlumberger.
Merak™ is a trademark of Schlumberger.
Merak Peep, Merak PetroDesk, Merak Portfolio, Merak Decision Tool Kit, Merak VOLTS, Merak Capital Planning,
Merak Petroleum Financials, Merak DBTools, Avocet™ Data Manager, Avocet Capture, Avocet Allocation, Avocet
Nomination, Avocet Mobile, Avocet Exchange, Avocet Import/Export, Avocet Integrated Asset Modeler, OFM, FieldBA,
and FieldViz are marks of Schlumberger.
Microsoft® is a registered trademark of Microsoft Corporation.
BackOffice®, Internet Explorer®, Windows®, Windows 98®, Windows NT®, Windows 2000®, Windows XP®, MS-
DOS®, Word®, Excel®, ActiveX®, ODBC®, OLE®, COM®, Terminal Server®, Microsoft Access®, Visual C++®, and
Microsoft SQL Server® are registered trademarks of Microsoft Corporation.
Oracle ® is a registered trademark of Oracle Corporation.
Crystal Reports™ is a trademark of Business Objects.
All other names and trademarks are the property of their respective owners.
Contents
Caution: Before upgrading your databases, please read the DBTools v4.4 Upgrade and the
RS_SUMMARY RESULT_SET table section to determine whether you must perform some pre-
upgrade steps to prevent loss of data related to the RS_summary_result_set table.
www.sis.slb.com 1
Merak DBTools Help
• If columns have been added to the default table, the upgrade will delete these columns,
potentially resulting in a loss of data and also resulting in a disconnect between the
MERAK_RESULT_VAR table and the default result set table.
Prior to running the upgrade, detect if this situation exists:
1. As the schema owner in SQLPLUS, run the script “RS_SUMMARY_TEST.sql” which will
indicate if any columns have been added and/or deleted from the standard
RS_SUMMARY_RESULT_SET table. If changes were made, proceed with the pre-upgrade
instructions.
2. If no custom changes have been made, proceed with the upgrade.
OR,
If custom changes have been made:
• complete the pre-upgrade instructions;
• perform the standard DBTools database upgrade;
• complete the post-upgrade instructions.
Setting up DBTools
You are required to set up the following items before using DBTools:
Note:
Use of software versions outside of those identified for the Merak Suite of
software will likely cause application failure and are not supported. This includes
versions of Oracle, SQL Server, ODBC, and MDAC other than those specified in
this guide. Please ensure that the version you are attempting to run complies with
www.sis.slb.com 2
Merak DBTools Help
the supported versions in the install guide. If unsure, or looking for the latest
update please contact our support desk.
www.sis.slb.com 3
Merak DBTools Help
Notes:
• if you are upgrading a VOLTS database you will also need to upgrade
your Peep database to the same version. DBTools will check for this
and display a message if all of the appropriate databases are not
upgraded to the correct version.
• starting with the v4.0 release in 2003 the user is allowed to select the
version number for the MERAK database objects (shared tables).
Ensure that you receive the proper version numbers for the release.
12. Click Next. DBTools creates a transaction log that records the progress of the database
creation.
13. Type the path where you want to store the log file.
14. Click Next. If you are installing an Oracle database, you are prompted for the Data and
Index tablespace you want to populate using the Oracle Parameters dialog box. The fields for
each Tablespace are detected from the Oracle database.
15. Select the appropriate tablespace from the Data Tablespace and Index Tablespace drop-
down lists. DBTools will verify that there is enough free space available in the tablespace(s)
selected before allowing you to continue.
16. Click Next. You are prompted to confirm all of the settings entered into DBTools.
Note:
Please take a moment at this time to confirm that all of the information is
correct before proceeding.
17. If an item requires modification, click Back to return to the appropriate dialog box.
18. When you are sure that all the information is correct, click Finish to update the database.
Note:
If an error occurs during the upgrade process the upgrade must be stopped,
the schema restored from backup, and the upgrade restarted. It is advisable
to retain the upgrade log and consult with SLB resources if you encounter this
problem.
www.sis.slb.com 4
Merak DBTools Help
selected. Consult the System Requirements section in the Introduction for information about
which databases are supported by a particular application.
25. Click Next. The Database Type Select dialog box opens.
26. Click Next. DBTools creates a transaction log that records the progress of the database
creation.
27. Type the path where you want the log file installed and click Next.
28. If you are installing an Oracle database, you are prompted for the Data and Index tablespace
you want to populate in the Oracle Parameters dialog box. The list of available tablespaces
is read directly from the Oracle database along with the amount of free space available within
each tablespace. Fields for each tablespace are detected from the Oracle database.
29. Select the appropriate tablespace from the Data Tablespace and Index Tablespace drop-
down lists. DBTools will verify that there is enough free space available in the tablespace(s)
selected before allowing you to continue.
30. Click Next. You are prompted to confirm all of the settings entered into DBTools.
31. If an item requires modification, click the Back button to return to the appropriate dialog box.
32. When you are sure that all the information is correct, click Finish to create the database.
Database privileges
To properly install or upgrade a database to include the new security components, DBTools must
now perform additional security tasks including creating database roles and users. Before
DBTools attempts to install or upgrade a VOLTS or Peep database, it will check to see if the
database login name has the appropriate privileges. If the appropriate privileges have not been
granted then you will see a message similar to this:
When DBTools performs these security checks, it writes the results to a file called CHECK.LOG,
created in the same directory as the DBTools executable. You can check this log file to see what
permissions are missing. are The minimum set of permissions required for Oracle and SQL Server
database users are listed at the end of this chapter.
Notes:
• DBTools should no longer be executed directly from the Merak Suite CD. All
of the files must first be copied to your local hard drive before attempting to
install or upgrade your database.
www.sis.slb.com 5
Merak DBTools Help
• For Oracle databases, the xxx prefix is replaced by the name of the schema
owner. For example, if you connect to the database using the Oracle user
name SCOTT then the roles and users created would be named:
SCOTT_ADMIN_ROLE, SCOTT_BOOT_USER and SCOTT_APP_USER. For
SQL Server databases, these objects are automatically named
MERAK_ADMIN_ROLE, MERAK_BOOT_USER and MERAK_APP_USER.
It should also be noted that although user and role passwords are stored
within the security tables, they are always stored in an encrypted format and
in most cases are never decrypted but used for comparison to other
encrypted passwords to ensure that they match.
Security options
A new option has been added to DBTools to allow administrators to add new database
users/logins, to reset the password of one of the database users, or to reset the password for the
database roles. As the following indicates, this option is only for those applications that have
implemented the new security components (VOLTS and Peep).
When you select this option, you are presented with the same login screen that you would
normally see when installing or upgrading a database. You must connect to the database as the
owner of the database objects in order to perform any of the security functions. Once connected,
select the option you want to perform from the Operation drop-down list and type in the
necessary fields for that operation.
To complete the operation, click Save to commit your changes to the database. Only once you
have completed all of the security operations you want to perform should you click Finish.
Permissions
Oracle
The following is a list of permissions required in order to install or upgrade an Oracle database:
• CREATE USER
• ALTER USER
• CREATE SESSION WITH ADMIN OPTION;
• CREATE ROLE
www.sis.slb.com 6
Merak DBTools Help
SQL Server
To install or upgrade a SQL Server database the SQL Server login must have the db_owner
database role for the database you are installing or upgrading, and the Security Administrators
server role to enable the creation of the database logins and roles.
www.sis.slb.com 7
Merak DBTools Help
This message is a result of a disconnect between the database username and password stored in the
MERAK_USER_MAP table in the database and the actual "sa" login for the database. During the
DBTools installation, the database is setup as non-secure and the "sa" user and password are
www.sis.slb.com 8
Merak DBTools Help
typically mapped to the Administrator and Merak users. If you are not using the Peep security
features you do not need to proceed any further.
Note: VOLTS must always access security, so you must resolve any issues you have in security
the demo database.
www.sis.slb.com 9
Merak DBTools Help
3. Select the Add and reset database security accounts option. The Select Data Source dialog
box opens.
4. Log in to the data source with the "sa" password and click Next. The Security Manager
dialog box opens.
www.sis.slb.com 10
Merak DBTools Help
5. From the Operation drop-down list, select the Reset Merak database user password
option.
6. From the Username drop-down list, a list of database IDs that are currently stored in the
MERAK_USER_MAP table is displayed. Select the "sa" Username.
7. Reset the password by entering the current SQL Server/MSDE password in the Password and
Confirm Password boxes.
Note: a blank "sa" password will not be accepted. You must set your SQL Server password to
some value other than blank.
8. To retain the changes click Save.
9. Click Finish to complete the operation.
You have now adjusted the "sa" password stored in the MERAK_USER_MAP table to
coincide with the "sa" password that has been set for the SQL Server/MSDE Server. The next
step requires that you adjust the users in the MAC and map them to the MERAK_APP_USER
and MERAK_ADMIN_ROLES. This final step will completely enable your security on the
Merak demo database.
10. Launch the MAC and log in as the Administrator.
11. Open the User Administration document. For each application username that has the
Database User set to "sa" you must re-map the application user to the MERAK_APP_USER
and MERAK_ADMIN_ROLE accounts.
12. Select the user and click Edit. The User Details dialog box opens.
www.sis.slb.com 11
Merak DBTools Help
www.sis.slb.com 12
Merak DBTools Help
How to reach us
United States
E-mail: [email protected]
www.sis.slb.com 13