|
ALL Consulting
|
|
Instructions
for Administrators of the Prepared for the Ohio Department of Natural Resources September 1997
CONTENTS
1.0 RBDMS Hardware and Software Requirements The following tables detail the minimum required and recommended hardware and software requirements to operate RBDMS.
2.0 Installing RBDMS The RBDMS application is split into two Access database files (mdbs). The RBDMS97.mdb contains all non-table objects such as forms, queries, reports, and program modules. The RBDMSD97.mdb is used to store the data tables. The RBDMS97D.mdb file is not needed if you are connected to the SQL Server RBDMS database. In addition to the mdbs, RBDMS uses two ActiveX controls that must be installed with a setup program. The ActiveX controls that must be installed are comdlg32.ocx and comctl32.ocx. The comdlg32 (common dialog) ActiveX control is used to provide the standard windows File, Open and File, Save dialog box. The comctl32 (common control) is used to provide the tree control used for controlling access to the RBDMS menu structure. Run the setup.exe program provided to install these controls. In all cases, the ActiveX controls will be installed on each computer that will be using RBDMS. Several options exist for the location of the mdbs. For a field inspector using an Access mdb for the data tables, both mdbs will be contained on the local computers hard disk. Users connected to a Local Area Network (LAN) can use both mdbs from a network file server or each user could have a local copy of the RBDMS97.mdb file and have a shared connection to RBDMSD97.mdb (or SQL Server) on the network. Using the local copy of the RBDMS97.mdb will decrease network traffic (and increase performance) but will make upgrading RBDMS more difficult. The RBDMS application can be installed from a variety of data sources including CD-ROM, zip disks, or zip files via the Internet. The RBDMS mdb and setup files can be loaded onto the LAN to allow installation of the system onto any LAN-compatible computer. 3.0 RBDMS Security RBDMS uses the security system included with Microsoft Access to control update, delete, and read privileges to objects in RBDMS. When initially installed, all objects in RBDMS are fully accessible by users in the group RBDMS_ADMIN. The administrator is given a Personal Identification Number (PIN) associated with the RBDMS_ADMIN group. To gain full access to all RBDMS objects, use the Tools/Security/User and Group Accounts menu to create a new group with a name of RBDMS_ADMIN using the secret PIN. Make the account you use to login to Access a member of the RBDMS_ADMIN group. You will have full access to all RBDMS objects after you exit and reload Access with your login. As a minimum, it is recommended that the administrator create a RBDMS_READ group that has read/execute only access to all objects and create privileges for new queries. All non-administrative users should be made members of this group. The RBDMS Administrator will need to add users, groups, and security as needed. All table security privileges should be assigned in SQL Server unless you are connecting to an Access mdb database. To simplify system administration, grant access to tables by groups and then assign users to individual groups. To grant access to objects within RBDMS97.mdb, open the file with Access while holding down the shift key. Then use the Tools/Security/User and Group Permissions menu to grant permissions to each group. Setting table securities depends on whether the database will be in an Access mdb (RDBMSD97.mdb) or SQL server. If the database is in Access, open the RBDMSD97.mdb and use the Tools/Security/User and Group Permissions menu to grant the appropriate permissions for each group. If the database is in SQL Server, use the Enterprise Manager program included with SQL Server to create security groups and grant access rights. For further information on setting security options, refer to the documentation provided with Microsoft Access and/or SQL Server. 4.0 RBDMS Menu Maintenance The standard RBDMS menu includes access to all features available in RBDMS including administrative options. Users will not be able to use the menu picks if they do not have security rights to the objects represented by the menu picks. Therefore, menu picks should not be visible to users if they cannot access the option. RBDMS includes a menu administration form displayed below that manages the availability of menu items to users. RBDMS controls menu item availability depending on the Microsoft Access security group to which the user is assigned. Menu availability is controlled through security groups beginning with "menuRBDMS_". The RBDMS administrator should create as many groups as necessary to handle all of the variations of menus that will be made available. After creating the security groups, open the menu administration form and select the security group name from the combo box on the right. A tree view control will be displayed on the left with a "light on" icon when the menu item is visible for the group and a "light off" icon when the menu item is not visible. The icon can be toggled between the two states by double clicking. For example, you might create a menu security group called menuRBDMS_UIC and assign users to the group. If you do not want users in this menu group to see the "Admin" menu, then open the menu administration form, select the menuRBDMS_UIC group from the combo box and double click the "Admin" menu item to turn-off the light bulb.
Be sure to assign each user to only one menu group. It is okay if you assign more, however, if you assign more than one group to a user and a menu item is turned on in one group but not in the other, the user will have access to that menu item. 5.0 Table Relationships Microsoft Access is a relational database management system. That means you store related data in separate tables. Then you define relationships between the tables, and Microsoft Access uses the relationships to find associated information stored in your database. To set up the relationship correctly, you must first determine the nature of the relationship. There are three types of relationships between tables:
A one-to-many relationship is the most common type of relationship in a relational database. In a one-to-many relationship, a record in Table A can have more than one matching record in Table B, but a record in Table B has at most one matching record in Table A. In a many-to-many relationship, a record in Table A can have more than one matching record in Table B, and a record in Table B can have more than one matching record in Table A. In a one-to-one relationship, a record in Table A can have no more than one matching record in Table B, and a record in Table B can have no more than one matching record in Table A. One-to-one relationships between tables are unusual because in many cases, the information in the two tables can simply be combined into one table. The graphic displayed below is a snapshot of the Access Relationship Editor Screen. The lines between fields in the tables represent table relations. If you need to temporarily disable a referential integrity check perform the following steps.
6.0 Attaching Tables to RBDMS
The data tables for RBDMS are stored in a separate Access mdb file (RBDMSD97.mdb) or in an ODBC data source. The RBDMS Database Attachment Utility displayed below is used to "connect" RBDMS to its data source. If the data source is an Access mdb file, then select the "Access mdb" toggle button. If the data source is an ODBC data source such as SQL Server, then select the "ODBC" toggle button. Depending on the toggle button selected, you will be prompted for an "Access mdb file" or a "ODBC Data Source Name." For a mdb file, use the builder button to select the database with a File, Open dialog box. For an ODBC data source, select the data source from the list of ODBC sources in the dropdown combo box. The RBDMS Directory box is used to specify the location of the home directory. For the path to the mdb file and the RBDMS home directory, specifying the path with the Universal Naming Convention (UNC) is preferable. To use the UNC within the File Open dialog form, be sure to specify the path by expanding the network neighborhood. 7.0 Maintaining RBDMS Codes Table RBDMS makes extensive use of codes in the database to specify types of actions, results of actions, types of equipment, etc. Rather than creating a new table for each type of code, a master codes table is used for storing all code types and a description of each.
Using a master codes table gives RBDMS users increased flexibility. Administrators can easily add new types of equipment or testing methods by accessing the RBDMS Codes form displayed below to add a record to the Codes table. Each type of code is identified by another code. For example, the form displayed above lists all of the codes available for "ACTION." If another type of action needed to be added, simply add a new line (code = 6) and a definition. Be sure that the code is the appropriate data type for the associated field and, if it is text, that is doesnt exceed the maximum field length. The tag and value are optional fields that are used to store text and/or numeric information when needed for special codes. If a code will not to be used anymore, turn its active status off. If it is required, check its required field. The ability to change codes should be reserved for the RBDMS administrator. Adding, updating, or deleting codes should be done with great care. It is possible to make the output of some reports such as the EPA 7520 invalid by improper adjustments to the codes. 8.0 Maintaining RBDMS Report Filter
The report system in RBDMS was designed to be easily extensible. New reports can be added and selection and sorting criteria can be added and updated using the "Edit Report Filters" option on the Admin menu. As with all of the Admin menu options, this form should only be used by someone who is qualified to make updates to RBDMS. The "Edit Report Filters" menu displays the "Report Design" form. Each report is displayed as a record on the main form. A subform in datasheet view displays selection and sorting criteria that will be available for each report. The "Name" field is the name property of the report. Opening the list box for the combo box will display all report names in the current system. To add a new report to the RBDMS report form, perform the following steps:
New and existing reports can be added and updated by modifying the information stored in the records. A description of each field and its purpose is listed below:
9.0 RBDMS Startup Implementation Converting an existing data management system to RBDMS or starting RBDMS from scratch can be a daunting task, and populating the RBDMS tables with data is a significant effort. This topic is intended to give you some guidelines for developing your own RBDMS implementation plan. Try to break up the implementation into smaller, more manageable tasks. Some suggested startup tasks are as follows: Note: When populating "Pool,"other tables are necessary prior to its completion. You do not have to populate all fields in each of the tables. Some database fields may be updated later or may not be needed at all for your state. All of the tables listed above do not need to be populated if you do not intend to use the corresponding field in the Well table. For example, the Pool table can be left empty if the pool numbers will not be entered into the Well table. Please refer to the Table Relationships topic for a graphic of table relationships and referential integrity checks. If you are converting from an existing data management system, you can eliminate a significant amount of manual data entry by using Access append queries. For fields that use different codes than those used by RBDMS, the codes will need to be translated to RBDMS codes. A table called tblTranslate has been created in RBDMS.MDB to store translated codes. The COMPANY table stores information on drillers, operators, etc. Each company is specified by a unique key composed of an integer part to specify the company (e.g., 1001 might be AMOCO) and a number after the decimal point to indicate the location for the company (e.g., 1001.01 might be AMOCO in Houston, TX). If the company information exists in paper form only, then you will need to use the Company form in RBDMS to enter the information manually. Once relevant code and reference data has been populated in RBDMS, other operational and well specific information may be populated. This includes information such as individual wells, tests and inspections performed on those wells, permit applications, etc. The WELL table is the core table in RBDMS. Most other tables have relational linkages to the Well table. Its unlikely that you will have all of the information for the fields that exist in the WELL table. The only required fields are the API_WELLNO and the owning/operating Company number. You should consider building this table with the information that is readily available and adding other items as appropriate. The sequence of building additional tables will depend on availability of data and agency priorities. Tables for internal MIT's, external MIT's, Area of Review's, Compliance, and UIC Permits can all be developed independently. 10.0 Backup, Restore and Maintenance Procedures An adequate backup procedure must be implemented to protect from potential disasters such as theft, fire, flood, hardware failure, operator error, etc. A SQL Server task has been created to automatically backup the RBDMS database to a data file every evening. The backup file is then copied to tape by the CIS group. The RBDMS Administrator should check the task history periodically to ensure that the backups are being performed properly. The transaction logs are being truncated at each checkpoint. If you wish to apply the transaction logs after a restore to recover additional data, then the truncate after checkpoint option should be turned off and the transaction log dumped after the backup each evening. The RBDMS Administrator will need to add users, groups, and security as needed. The administrator should also monitor database and log space usage and increase the size when needed. The two primary reasons for performing a restore of the database are hardware failure that makes the disk unreadable or operator error, such as deleting all records in the Well table. To restore the RBDMS database, repair any hardware as needed and use the restore option in the SQL Enterprise Manager to restore the previous nights backup. Keep in mind, however, all data changes since the previous backup will be lost. Other RBDMS files such as RBDMS97.MDB need to be backed up only after updates such as adding a new form or report to the RBDMS97.MDB file. The System.mdw (Access security) file should be backed up after new users or groups are created or edited. 11.0 SQL Server Maintenance In addition to the backup, two additional tasks have been scheduled each evening. A "dbcc checkdb (RBDMS)" command is run to check and repair any problems with the RBDMS database. A stored procedure to update table statistics is also run to improve the ability of SQL Server to optimize queries. The administrator should check the history for these tasks periodically to ensure that they are operating correctly. The RBDMS Administrator will need to add users, groups and security as needed. All table security privileges should be assigned in SQL Server unless you are connecting to an Access mdb database. To simplify system administration, grant access to tables by groups and then assign users to individual groups. The administrator should periodically monitor database and log space usage and increase the size when needed. 12.0 Enhancing Performance The performance of RBDMS is dependent on the software and hardware environment in which it operates. Microsoft makes the following recommendations for optimizing Access 97 performance. * Note that the optimal setting for each item may vary with the type of computer on which you run Microsoft Access. It is usually best to change only one setting at a time and then monitor database performance for improvement.
The performance of RBDMS is dependent on the software and hardware environment in which it operates. Microsoft makes the following recommendations for optimizing Access 97 performance. * Note that the optimal setting for each item may vary with the type of computer on which you run Microsoft Access. It is usually best to change only one setting at a time and then monitor database performance for improvement.
13.0 Using NetMeeting for Support Microsoft NetMeeting 2.0 is a powerful tool that enables real-time communications and collaboration over the Internet or corporate Intranet, providing standards-based audio, video, and multipoint data conferencing support. NetMeeting provides a mechanism for remote support and training for RBDMS. From a Windows 95 or Windows NT desktop, users can communicate over the network with real-time voice and video technology. They can share data and information with many people through true application sharing, electronic whiteboard, text-based chat, and file transfer features. Application sharing: A user can share a program running on one computer with other participants in the conference. Participants can review the same data or information, and see the actions as the person sharing the application works on the program (for example, editing content or scrolling through information.) Participants can share Windows-based applications transparently without any special knowledge of the application capabilities. The person sharing the application can choose to collaborate with other conference participants, and they can take turns editing or controlling the application. Only the person sharing the program needs to have the given application installed on their computer. Shared clipboard:The shared clipboard enables a user to exchange its contents with other participants in a conference using familiar cut, copy, and paste operations. For example, a participant can copy information from a local document and paste the contents into a shared application as part of a group collaboration. File transfer:With the file transfer capability, a user can send a file in the background to one or all of the conference participants. When one user drags a file into the main window, the file is automatically sent to each person in the conference, who can then accept or decline receipt. This file transfer capability is fully compliant with the T.127 standard. Whiteboard:Multiple users can simultaneously collaborate using the whiteboard to review, create, and update graphic information. The whiteboard is object-oriented (versus pixel-oriented), enabling participants to manipulate the contents by clicking and dragging with the mouse. In addition, they can use a remote pointer or highlighting tool to point out specific contents or sections of shared pages. Chat:A user can type text messages to share common ideas or topics with other conference participants, or record meeting notes and action items as part of a collaborative process. Also, participants in a conference can use chat to communicate in the absence of audio support. A new "whisper" feature lets a user have a separate, private conversation with another person during a group chat session. 14.0 RBDMS Object Naming Standards The RBDMS development team has adopted the Hungarian notation system recommended by Microsoft. The Hungarian notation system uses prefix and suffix codes on object names to identify object characteristics, for instance all form names should be prefixed with "frm". Some RBDMS objects were created in Access before the adoption of Hungarian notation and were "grand-fathered" in.
15.0 RBDMS Design Criteria
|
||||||||||||||||||||||||||||||||||||||||