BP-How to Install a SmartPlant Materials Service Pack

SmartPlant Materials How to Install a SmartPlant Materials Service Pack

Version 2007.2 (6.2.3)

January 2007 / April 2007

DMAR1-PE-200062A-Updated

Copyright Copyright © 2006-2007 Intergraph Corporation. All Rights Reserved. Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license agreement; contains confidential and proprietary information of Intergraph and/or third parties which is protected by copyright law, trade secret law, and international treaty, and may not be provided or otherwise made available without proper authorization.

Restricted Rights Legend Use, duplication, or disclosure by the government is subject to restrictions as set forth below. For civilian agencies: This was developed at private expense and is “restricted computer software” submitted with restricted rights in accordance with subparagraphs (a) through (d) of the Commercial Computer Software - Restricted Rights clause at 52.227-19 of the Federal Acquisition Regulations (“FAR”) and its successors, and is unpublished and all rights are reserved under the copyright laws of the United States. For units of the Department of Defense (“DoD”): This is “commercial computer software” as defined at DFARS 252.227-7014 and the rights of the Government are as specified at DFARS 227.7202-3. Unpublished – rights reserved under the copyright laws of the United States. Intergraph Corporation Huntsville, Alabama 35894-0001

Warranties and Liabilities All warranties given by Intergraph Corporation about equipment or software are set forth in your purchase contract, and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or amendment of such warranties. Intergraph believes the information in this publication is accurate as of its publication date. The information and the software discussed in this document are subject to change without notice and are subject to applicable technical product descriptions. Intergraph Corporation is not responsible for any error that may appear in this document. The software discussed in this document is furnished under a license and may be used or copied only in accordance with the terms of this license. No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not supplied by Intergraph or its affiliated companies. THE USER OF THE SOFTWARE IS EXPECTED TO MAKE THE FINAL EVALUATION AS TO THE USEFULNESS OF THE SOFTWARE IN HIS OWN ENVIRONMENT.

Trademarks Intergraph, the Intergraph logo, SmartSketch, FrameWorks, SmartPlant, INtools, MARIAN, PDS, and IntelliShip are registered trademarks of Intergraph Corporation. Microsoft and Windows are registered trademarks of Microsoft Corporation. Other brands and product names are trademarks of their respective owners.

Table of Contents

Table of Contents Preface.................................................................................................................................4 Overview .............................................................................................................................5 Document Scope...........................................................................................................6 Assumptions and Dependencies, Constraints & Exclusions............................................... 6 Purpose of this Document................................................................................................... 6

Service Pack Process and Files .........................................................................................7 Application Server Updates..........................................................................................9 Database Server Updates ............................................................................................10 Evaluating the Impact of Service Packs ........................................................................12 Index..................................................................................................................................13

SmartPlant Materials How to Install a SmartPlant Materials Service Pack 3

Preface

Preface This document is a system administrator’s guide for SmartPlant Materials 2007.2 (6.2..3) It describes how to install a SmartPlant Materials Service Pack. Send documentation comments or suggestions to [email protected].

4 SmartPlant Materials How to Install a SmartPlant Materials Service Pack

Overview

Overview Periodically, the SmartPlant Materials Product Center releases Service Packs for the software that update crucial new areas of development and any customer-requested service or trouble requests. It is important for each customer to stay current by evaluating and/or installing each new Service Pack and major release. This document describes an overview of the process behind installing a new SmartPlant Materials Service Pack with minimal customization.

SmartPlant Materials How to Install a SmartPlant Materials Service Pack 5

Overview

Document Scope The audience for this document is SmartPlant Materials Administrators and Oracle Developers or Database Administrators (DBA).

Assumptions and Dependencies, Constraints & Exclusions Assumptions regarding the subject matter of this document are as follows: •

The administrators and developers have access to the appropriate sample database(s) through the software required.

•

The actual Service Pack sample files are available.

•

Not covered in this document are any customer-specific examples of any custom configuration. All examples are for demonstration purposes only.

Purpose of this Document The purpose of this document is to instruct the DBA and the development personnel how to install a SmartPlant Materials Service Pack. This document will use SmartPlant Materials Service Pack 10 as an example to illustrate the needed steps.

6 SmartPlant Materials How to Install a SmartPlant Materials Service Pack

Service Pack Process and Files

Service Pack Process and Files SmartPlant Materials customers are notified every time a new SmartPlant Materials Service Pack is issued. The Intergraph Product Center released SmartPlant Materials Service Pack 10 on September 7th, 2005. This Service Pack 10 will be used to show all the appropriate steps that need to be taken to install this Service Pack. Once you have been notified about a new Service Pack from Intergraph, you can use the link provided in the email sent to all customers to download a zip file containing the Service Pack files. For example (Service Pack 10 link): http://www.intergraph.com/applications/downloads/marian/MARIAN612Serv icePack10.zip

SmartPlant Materials Service Packs are delivered in a packaged zip file. They are cumulative so each Service Pack contains all the updates to bring your SmartPlant Materials installation up to date with the latest Service Pack. The following is an example of the contents of the Service Pack file:

The files in each Service Pack should be extracted to a pre-determined location for software updates. Once extracted, you can begin the Service Pack evaluation and installation process. In addition to the actual Service Pack files, Intergraph sends a link to a readme file with installation instructions.

SmartPlant Materials How to Install a SmartPlant Materials Service Pack 7

Service Pack Process and Files For example (Service Pack 10 link): http://www.intergraph.com/applications/downloads/marian/612SP10_readm e.txt

An example of the contents in the readme file is shown above.

8 SmartPlant Materials How to Install a SmartPlant Materials Service Pack

Service Pack Process and Files

Application Server Updates Every Service Pack is broken down into two main parts. One of the two main parts of every SmartPlant Materials Service Pack is the Application Server update file, which is zipped in the main download file. When extracted from the main Service Pack file, the contents of the Application Server zip file (ex: 612ServicePack10_appserver.zip) just need to be placed in the SmartPlant Materials Software installation location on the Application Server. Note •

Before applying ANY Service Packs, a backup should be made of the current Service Pack files on the Application Server.

The extraction process should use the following settings (activate the ‘Overwrite existing files’ and ‘Use folder names’ WinZip options to extract the files into the appropriate folders):

SmartPlant Materials How to Install a SmartPlant Materials Service Pack 9

Service Pack Process and Files

Database Server Updates The other main part of every SmartPlant Materials Service Pack is the Database Server update file, which is also zipped in the main download file. The Database Server zip file (for example: 612ServicePack10_appserver.zip) should be extracted into a separate folder, which can be used as the SQL*Plus working directory. The updates to the Database Server (as opposed to the Application Server) are scriptbased because the updates are actually being made to the SmartPlant Materials physical database objects. When extracting the zip file, activate the ‘Use folder names’ WinZip option to extract the files into the appropriate folders. Once the files have been extracted, it should look as follows:

The Service Pack updates for the Database Server are prepared to be run from an SQL*Plus session with the “Start in” location set to the above mentioned working directory. Once the SQL*Plus session is opened and connected to the target database as M_SYS, just execute the following: •

The scripts will have various processes and prompts that will need to be followed to successfully install the database updates. Be prepared to enter the passwords of SYS, M_SYS, and DISCO.

•

The Oracle utilities imp and loadjava must be available on the machine from which the Service Pack installation is performed.

•

Be aware that all Custom Packages (CIPs) modified with the Service Pack will be saved in the form of files in the installation_logs folder. These files might be used to implement the changes to the customized procedures after finishing the Service Pack installation.

10 SmartPlant Materials How to Install a SmartPlant Materials Service Pack

Service Pack Process and Files Note •

Before applying ANY Service Packs, a backup should be made of the current Service Pack files on the Database Server.

SmartPlant Materials How to Install a SmartPlant Materials Service Pack 11

Evaluating the Impact of Service Packs

Evaluating the Impact of Service Packs It is crucial that every customer evaluate each Service Pack to determine the impact (if any) to their current configuration or any customization that has been done to the delivered product. Intergraph has made this process possible by including documentation about the updates in each Service Pack. This documentation is included in the main Service Pack file download. An example is shown below for Service Pack 10. The file name of this example document is 61SP10_DBDiff.pdf.

These files contain the actual changes to all the objects in the SmartPlant Materials database. Also included in each Service Pack is a Release Notes document that gives additional information related to the updates that are addressed in the Service Pack. The file name of this example document is 612SP10_RelNotes.pdf.

[LAH1]These

files list the updates addressed, based on the official Intergraph service request or applicable number. If the information about a specific update is lengthy, there will be a reference to an additional file included in the Service Pack files that will explain the update in more depth. These additional files will be stored in a folder underneath the SmartPlant Materials home directory.

12 SmartPlant Materials How to Install a SmartPlant Materials Service Pack

Index

Index application server, 9 database server, 10 document purpose, 6 scope, 6 documentation service packs, 12 impact service packs, 12 overview service packs, 5 purpose

document, 6 scope document, 6 service packs documentation, 12 files, 7 impact, 12 overview, 5 process, 7 updates application server, 9 database server, 10

SmartPlant Materials How to Install a SmartPlant Materials Service Pack 13