Skip to content

DataSplice Support Website

Sections
Personal tools
You are here: Home » Product Manuals DataSplice 3.0 » DataSplice MAXIMO 4.x Add-on Package Manual » Executing the DataSplice Scripts for Oracle

Executing the DataSplice Scripts for Oracle

Executing the DataSplice scripts for Oracle implements the necessary database views, packages, and procedures to allow the DataSplice views to successfully communicate with the MAXIMO® database. In preparation of the script execution, perform the following steps:

  • Copy the Scripts folder included in the add-on package zip file to a convenient location, such as C:\temp.
  • Log in to Oracle SQL Plus or a similar utility application.
    • User Name - The user name of the CMMS schema owner. This is typically maximo.
    • Password - The password corresponding to the given user name.
    • Host String - The database name, as referenced in the TNS listing file. Depending on the version of Oracle in place, the tnsnames.ora file may be located at C:\oracle\ora92\network\ADMIN or a similar location.

      SQL Plus Login

    • Click OK.

Executing the Scripts in a Batch Process

The DataSplice scripts for Oracle can be executed in a batch process. This is the preferred method because it simplifies the number of commands that need to be executed. To execute the scripts in a batch process, follow these steps:

  • Execute the max411_scripts.sql script file.
    • If the Scripts folder was copied to C:\temp, the command to execute the script would be @c:\temp\scripts\max411_scripts.sql;.

      SQL Plus Running Scripts

  • Executing the max411_scripts.sql script file automatically executes the following list of scripts in turn:
    • dsutility.plsql
    • equipment.plsql
    • inventory.plsql
    • workorder1.plsql
    • workorder2.plsql
    • workplans.plsql
    • tooltrans.plsql
    • dsviews.plsql
    • dsusers.plsql - This script is optional and will not be executed by default. The max411_scripts.sql file can be edited to remove the comment markers on the last two lines if this script is intended to run. See the explanation in the Pass Through Authentication Considerations section below for more information.
  • If an error is encountered during the script execution, refer to the details of the error message and consult with the Oracle documentation to identify the cause. If the script execution completes successfully, SQL Plus will return to the command prompt.

    SQL Plus Scripts Complete

Executing the Scripts Individually

If desired, the scripts can be executed individually. The only conditions are that the dsutility.plsql script is executed first, and that the execution of workorder1.plsql precedes that of workorder2.plsql.

To execute a script individually, enter the following two commands in Oracle SQL Plus:

                connect <schema_owner>/<schema_owner_password>@<oracle_tns>;
                start <directory_path>\dsutility.plsql;

Where the following information is valid:

  • <schema_owner> - The user name of the CMMS schema owner. This is typically maximo.
  • <schema_owner_password> - The password corresponding to the given user name.
  • <oracle_tns> - The database name, as referenced in the TNS listing file. Depending on the version of Oracle in place, the tnsnames.ora file may be located at C:\oracle\ora92\network\ADMIN or a similar location.
  • <directory_path> is the actual directory path to the dsutility.plsql file, such as C:\temp\scripts.

This process can be repeated in the same manner for the remaining scripts.

Pass Through Authentication Considerations

The last script, dsusers.plsql, is optional. It is only necessary to use if the Pass Through Authentication option is enabled. Pass Through Authentication is a connection profile option in the DataSplice Administration Client to determine the credentials passed to the database. If the Pass Through Authentication option is enabled, the credentials of the logged-in user on the Remote Client will be passed to the database. If the option is not enabled, the user name and password specified in the connection profile will be passed to the database. For additional information about the Pass Through Authentication setting, please see the ADO.NET Data Source Plug-in Configuration section of the DataSplice Administration Client manual.

Note: If the schema owner is not maximo, the dsusers.plsql script will need to be modified to use the correct schema owner prefix. After the dsusers.plsql script has been successfully executed, the DS_USER role can be granted to the desired set of CMMS users. The command to grant the DS_USER role to a CMMS user would resemble the following:

                GRANT DS_USER to CMMS_USER1;

See the contents of the dsusers.plsql script for an example SQL query for generating a script file of GRANT statements using the SPOOL option.

Additional Information

A readme.txt file is included within the Scripts folder. This file contains additional information and examples that may be helpful during the script execution process.

 


Last modified 2006-05-26 02:40 PM
 

Powered by Plone

This site conforms to the following standards: