SmartPlant Instrumentation Setup

Maintenance and Database Selection

Table of Contents
Overview .........................................................................................................................................2

Software Components....................................................................................................................2
Installing SmartPlant Instrumentation Components.................................................................2
Modifying Component Selection..............................................................................................4
Repairing Installed Components...............................................................................................5
Uninstalling SmartPlant Instrumentation .................................................................................6

Installing Different Versions of the Software on the Same Machine ........................................7

Requirements ............................................................................................................................7

Installing Several Versions of SmartPlant Instrumentation 7.0 on the Same Machine..........8

Requirements for Installing Another Version of SmartPlant Instrumentation 7.0 to the
Same Home Folder ...................................................................................................................8
Requirements for Installing Another Version of SmartPlant Instrumentation 7.0 to a
Different Folder ........................................................................................................................9

Activating Databases ...................................................................................................................11

SmartPlant Instrumentation Databases ...................................................................................11
Switching to Another Default Standalone Database ..............................................................11
Switching from Standalone Demo Database to Standalone Empty Database ............................... 12
Switching from Standalone Empty Database to Standalone Demo Database ............................... 12
Enabling Database Selection When Logging on to SmartPlant Instrumentation ...................12
SmartPlant Instrumentation Setup Maintenance and Database Selection 2

Overview
This document explains how to perform Setup maintenance. You need to run Setup on a
machine where you have installed SmartPlant Instrumentation. Setup maintenance involves
a modification of the existing software component selection, restoration of corrupted software
components, or complete deletion of all of the components.
The document provides an explanation on how to install several versions of SmartPlant
Instrumentation 7.0 on the same application client or server machine without overwriting the
existing installation.
Also, in this document, you will learn how to switch from one database to another using the
INTOOLS.INI file.

Software Components
The following section provides information on:
• the software components you need to install
• how to modifying the component selection of the previously installed components
• how to repair previously installed corrupted components
• how to uninstall the software

Installing SmartPlant Instrumentation Components

The table below lists and describes the components you need to install to be able to work
with SmartPlant Instrumentation. This table also describes optional components that you can
install. You need an appropriate license to install some of these optional components.

Component Details Required Optional License-

Dependent

Program Files Common Files

Access
Database

Deployment Kit

Internal Setup
Utility

Admin Module Administration (for the Admin

module files station)

Catalog (for the Admin

databases station)

Demonstration (for the Admin

database station)
SmartPlant Instrumentation Setup Maintenance and Database Selection 3

Component Details Required Optional License-

Dependent

Merger Merger Utility (for Merger)

Import Import Utility (for Import)

Module ODBC Drivers

DBF Samples

Merger Utility

Documentation Q&A

User’s Guides

Online Help

CAD SmartSketch

AutoCAD

MicroStation

DB Setup Database setup (for Oracle

Utility and SQL
Server Admin
station)

CAD Sample AutoCAD

Block Drawings Samples

MicroStation
Samples

Shell Library

Standard
Library

Loop Blocks
Library

PSR Library
SmartPlant Instrumentation Setup Maintenance and Database Selection 4

Component Details Required Optional License-

Dependent

Databases Template
Database

Catalog
Database

Demo
Database
} at least one of
these databases

TEF sample
database (for
the Engineering
Framework)

Empty
Database

Enhanced SmartPlant See Enhanced

Report Utility Instrumentation Report Utility
Enhanced Installation Guide
Report Utility

Caution

• If you installed SmartPlant Instrumentation for Sybase Adaptive Server

Anywhere, you need to also install all the components which are required for the
Administration module.

Modifying Component Selection

After installing SmartPlant Instrumentation, you can run Setup again and remove some of the
installed components, or install new components.

To modify the component selection

1. Insert the CD into your CD-ROM drive. The SmartPlant Instrumentation CD Browser
launches automatically if AutoPlay is enabled on your system. The CD Browser allows
you to display the Installation Guide, and to install SmartPlant Instrumentation and other
CD extras.

Note

• If the CD Browser does not launch automatically, run Windows Explorer to

open the SmartPlant Instrumentation CD window. Then, in the root folder,
double-click the SETUP.EXE file.

2. Click SmartPlant Instrumentation Installation.

SmartPlant Instrumentation Setup Maintenance and Database Selection 5

3. On the Welcome page, click Modify to open the Select Components page.

Note

• On the Select Components page, the software selects all the installed
components by default.

4. Do the following to modify your component selection.

a) Select check boxes for new components you want to add to the existing installation.

b) Clear check boxes for components you want to uninstall.

5. Click Next.

6. On the Maintenance Complete page, click Finish.

Repairing Installed Components

Use this option if you need to repair corrupted software components. Setup reinstalls all the
program components installed in the previous Setup session. Setup overwrites the existing
components without adding any new components.

Caution

• Setup overwrites the demonstration and empty databases. You will lose any
user-defined data you have in the IN_DEMO.DB and INTOOLS.DB files. If you
used the empty database to define your domain data, and set this database
to be your active database, you lose all the existing domain data if you
overwrite the old INTOOLS.DB file. Therefore, if you need to use the old
IN_DEMO.DB and INTOOLS.DB files, you must backup these files before
repairing the installed components.
SmartPlant Instrumentation Setup Maintenance and Database Selection 6

To repair the installed components

1. Insert the CD into your CD-ROM drive. The CD Browser launches automatically if
AutoPlay is enabled on your system. The CD Browser allows you to display the
Installation Guide, and to install SmartPlant Instrumentation and other CD extras.

Note

• If the CD Browser does not launch automatically, run Windows Explorer to

open the SmartPlant Instrumentation CD window. Then, in the root folder,
double-click the SETUP.EXE file.

2. Click SmartPlant Instrumentation Installation.

3. On the Welcome page, click Repair.

4. Click Next to overwrite all the existing software components with new components.

5. On the Maintenance Complete page, click Finish.

Uninstalling SmartPlant Instrumentation

The following procedure describes how to uninstall SmartPlant Instrumentation. When
uninstalling SmartPlant Instrumentation, Setup permanently deletes all of the software
components. If you want to uninstall specific components only, you need to modify your
component selection. For details, see page 4.

Note

• Setup does not uninstall Enhanced SmartLoop. If you want to uninstall

Enhanced SmartLoop, you must run a separate procedure.

Caution

• To uninstall the software successfully, before running the following procedure,

ensure that SmartPlant Instrumentation and database files are closed.

To uninstall SmartPlant Instrumentation

1. Use the standard Windows Add/Remove option to open the SmartPlant Instrumentation
Setup Maintenance wizard.

2. On the Welcome page, click Remove.

3. Click Next.

4. On the Maintenance Complete page, click Finish.

SmartPlant Instrumentation Setup Maintenance and Database Selection 7

Installing Different Versions of the Software on the

Same Machine

Requirements
If you need to install and run multiple versions or service packs on the same machine, for
example 06.00.01.00 and 07.00, the following requirements apply:
• SmartPlant Instrumentation 7.0 must be installed after the earlier version of the software
(not earlier than 5.2)
• If you created a database profile in a version prior to 7.0, after installing version 7.0, you
must recreate the profile using the Internal Setup Utility.
• You must connect to the correct IN_TEMPL.DB. This is because with each new installation,
the software overwrites the registration of the IN_TEMPL.DB, and as a result, in your
Windows registry, the path to the IN_TEMPL.DB always points to the latest installation of
the software.
• When installing SmartPlant Instrumentation 7.0 on the machine that has a previous
version of INtools, the software changes the name of the ODBC driver for the database
profiles IN_TEMPL, IN_DEMO, INTOOLS and PATTERN in the registry. Even after
switching from SmartPlant Instrumentation 7.0 to a previous version of INtools, you
cannot execute procedures that require a connection to the IN_TEMPL.DB database,
such as initializing or backing up a domain, running the Import Utility, and so forth.
Therefore, to be able to use such procedures, in the Registry Editor, for the values
IN_TEMPL, IN_DEMO, INTOOLS and PATTERN of the ODBC Data Sources key, you
must change the data string settings.
After switching from SmartPlant Instrumentation 7.0 to INtools 6.0, change the value
data strings as follows:
Adaptive Server Anywhere 7.0 for INtools
After switching from INtools 6.0 to SmartPlant Instrumentation 7.0, change the value
data strings as follows:
Adaptive Server Anywhere 7.0 for SmartPlant Instrumentation

Caution

• The use of the incorrect IN_TEMPL.DB may result in an unintentional database

upgrade.
SmartPlant Instrumentation Setup Maintenance and Database Selection 8

Installing Several Versions of SmartPlant

Instrumentation 7.0 on the Same Machine
On the same application client or server machine, you can have only one active version of
SmartPlant Instrumentation 7.0. However, you can install several versions of SmartPlant
Instrumentation 7.0 and then activate or deactivate the required version. If you do not want
Setup to overwrite the existing installation, before installing another version of SmartPlant
Instrumentation 7.0, you must perform one of the following procedures:
• Rename the SmartPlant Instrumentation home folder (if you want to install a new version
to the same home folder with the same name as the original folder).
• Rename the SmartPlant Instrumentation home folder and update the paths in Registry
Editor (if you want to specify a new destination folder for a new installation).

Note

• After you perform one of the following procedures, Setup does not detect the
existing installation when installing a new version of SmartPlant Instrumentation
7.0, so you need to perform a complete installation of the software.

Requirements for Installing Another Version of SmartPlant

Instrumentation 7.0 to the Same Home Folder
SmartPlant Instrumentation home folder is a folder where you installed the software. The
default folder path is C:\Program Files\SmartPlant\Instrumentation. We recommend that you
always install each new version of the software to the home folder with the same name as the
original folder. This way you do not need to update the registry.

To install another version of 7.0 to the same home folder

1. Rename the folder where your SmartPlant Instrumentation installation is located. For
example, if you installed SmartPlant Instrumentation 7.0 in C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION, rename the home folder to C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_1.

2. When running Setup for a new installation, on the Choose the Destination Folder page,
set the path to the destination folder to C:\PROGRAM FILES\SMARTPLANT\INSTRUMENTATION.
SmartPlant Instrumentation Setup Maintenance and Database Selection 9

Note

• After you complete the installation, your previous version becomes inactive. To
switch to the previous installation, you need to rename the home folder from
C:\PROGRAM FILES\SMARTPLANT\INSTRUMENTATION to C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_2 and then rename C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_1 back to C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION.

Requirements for Installing Another Version of SmartPlant

Instrumentation 7.0 to a Different Folder
When performing this procedure, you must update path registries in the Registry Editor.
Therefore, we recommend that you use the following procedure only if you do not want to
install another version of SmartPlant Instrumentation 7.0 to the default home folder where
you last installed the software. The default home folder is C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION.

To install another version of SmartPlant Instrumentation 7.0 to a different folder

1. Rename the folder where your previous installation is located. For example, if you
installed SmartPlant Instrumentation 7.0 in the folder C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION, rename the home folder to C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_1.

2. When running Setup for a new installation, on the Choose the Destination Folder page,
set the path to the required destination folder. For example, C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_2.

3. Complete the new installation.

4. From the Windows command line, type regedit.

5. In the Registry Editor tree, navigate to

..\HKEY_LOCAL_MACHINE\Software\ODBC\ODBC.INI\IN_TEMPL

6. Change the value data of the original paths as in the following examples:
“C:Program Files\SmartPlant\Instrumentation\IN_TEMPL.DB”
“C: Program Files\SmartPlant\Instrumentation \DBODBC7.DLL”
“C: Program Files\SmartPlant\Instrumentation \DBEng7.exe -d -u -c 4096”

to the value data that corresponds to the paths you set for the new installation:

“C: Program Files\SmartPlant\Instrumentation_2\IN_TEMPL.DB”

“C: Program Files\SmartPlant\Instrumentation_2\DBODBC7.DLL”
“C: Program Files\SmartPlant\Instrumentation_2\DBEng7.exe -d -u -c 4096”
SmartPlant Instrumentation Setup Maintenance and Database Selection 10

Note

• After you complete the current installation, your previous installation of Version
7.0 located in the folder C:\PROGRAM FILES\SMARTPLANT\
INSTRUMENTATION_1becomes inactive. To switch to the previous installation of
Version 7.0, you need to rename the home folder from C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_2 to C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION and then rename C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_1 to C:\PROGRAM
FILES\SMARTPLANT\INSTRUMENTATION_2.
SmartPlant Instrumentation Setup Maintenance and Database Selection 11

Activating Databases
In this section, you learn how to set your default standalone database in the INTOOLS.INI file.
Also, this section provides an explanation of how to switch to another database without
having to change various parameters in the INTOOLS.INI file. The following section explains
how to modify the appropriate parameters the INTOOLS.INI file only once to enable switching
from one database to another when logging on to SmartPlant Instrumentation.

SmartPlant Instrumentation Databases

The standard SmartPlant Instrumentation database file that can be used for building
databases is called INTOOLS.DB. In addition, SmartPlant Instrumentation is supplied with a
database called IN_DEMO.DB for practice and as a reference. On Oracle and SQL Server
platforms, only the System Administrator can access the INTOOLS.DB and IN_DEMO.DB
databases.
For details of how to use these databases, see Appendixes > Appendix C > SmartPlant
Instrumentation Database Technical Review in this Installation Guide.

Switching to Another Default Standalone Database

When installing SmartPlant Instrumentation on Sybase Adaptive Server Anywhere, you are
prompted to specify your default standalone database. For details, see Installation Guide,
Installing SmartPlant Instrumentation on Sybase Adaptive Server Anywhere 7.0. Setup
installs the following standalone databases:
• Demo database IN_DEMO.DB — Use this database to run a demonstration version of
SmartPlant Instrumentation.
• Empty database INTOOLS.DB — Use the empty database to back up a domain from Oracle
or SQL Server platforms. This standalone database does not contain any SmartPlant
Instrumentation domains.
You can switch from one database to another using the INTOOLS.INI file.
SmartPlant Instrumentation Setup Maintenance and Database Selection 12

Switching from Standalone Demo Database to Standalone Empty Database

If your default database is the demo database, and you want to switch to the empty
database, you need to deactivate the demo database and activate the empty database in the
INTOOLS.INI file.

To switch from a demo database to an empty database

1. In the [DATABASE] section of your INTOOLS.INI file, insert a semicolon (;) at the beginning of
the following statement:
dbparm=connectstring='dsn=in_demo;uid=in_dbamn;pwd=in_dbamn'

2. Remove the semicolon at the beginning of the following statement:

dbparm=connectstring='dsn=intools;uid=in_dbamn;pwd=in_dbamn'

Switching from Standalone Empty Database to Standalone Demo Database

If your default database is the empty database, and you want to switch to the demo
database, you need to deactivate the empty database and activate the demo database in the
INTOOLS.INI file.

To use the empty SmartPlant Instrumentation database

1. In the [DATABASE] section of your INTOOLS.INI file, insert a semicolon (;) at the beginning of
the following statement:
dbparm=connectstring='dsn=in_demo;uid=in_dbamn; pwd=in_dbamn'

2. Remove the semicolon at the beginning of the following statement:

dbparm=connectstring='dsn=intools;uid=in_dbamn; pwd=in_dbamn'

Enabling Database Selection When Logging on to SmartPlant

Instrumentation
This option allows you to switch from one database to another when logging on to SmartPlant
Instrumentation without having to change various parameters in the INTOOLS.INI file. After
performing the following procedure, you can select a desired database and log on to it
directly from the Logon Information dialog box.

Caution

• To enable this option, make sure that you have installed your SmartPlant
Instrumentation databases on the same platform and that these databases
belong to the same version and service pack. If your databases are of different
versions, when switching from one database to another you will be prompted to
upgrade the database. Do not upgrade the database; if you do, the database will
no longer be available.
SmartPlant Instrumentation Setup Maintenance and Database Selection 13

To enabling database selection when logging on to SmartPlant Instrumentation

1. In the INTOOLS.INI file, create a [PROFILES] section to store the list of all available database
profiles and the default profile name.

2. In the [PROFILES] section, add a line for each database, including the default database.
Add a profile name label to each database.
For example,
[Profiles]
Database1=IN_DEMO
Database2=AS_BUILT
Default=IN_DEMO

3. Copy the [DATABASE] section as many times as needed. There has to be a [DATABASE]
section for each existing database. Do the following in each [DATABASE] section:
a) Do not change the [DATABASE] label for the default database.

For example, if your default database is IN_DEMO, ensure that the default [DATABASE]
section is configured as follows:
[database]
DBMS=ODBC
LogId=IN_DBAMN
LogPassword=IN_DBAMN
ServerName=
Database=IN_DEMO
UserId=
DatabasePassword=
TableDir=0
StayConnected=1
AutoCommit=0
DBParm=ConnectString='DSN=IN_DEMO;UID=IN_DBAMN;PWD=IN_DBAMN'
Prompt=110
Commit=100
;INIT_TABLE_CONT=
SmartPlant Instrumentation Setup Maintenance and Database Selection 14

b) For the remaining profiles, change each [DATABASE] label to the label corresponding
to the database profile that you created in the [PROFILE] section.

For example, if you have created a new IN_DEMO profile, create a new [DATABASE]
section and change the [DATABASE] label to [IN_DEMO]:
[IN_DEMO]
DBMS=ODBC
LogId=IN_DBAMN
LogPassword=IN_DBAMN
ServerName=
Database=IN_DEMO
UserId=
DatabasePassword=
TableDir=0
StayConnected=1
AutoCommit=0
DBParm=ConnectString='DSN=IN_DEMO;UID=IN_DBAMN;PWD=IN_DBAMN'
Prompt=110
Commit=100
;INIT_TABLE_CONT=

If you have created a new AS_BUILT profile, create a new [DATABASE] section and
change the [DATABASE] label to [AS_BUILT]:
[AS_BUILT]
DBMS=ODBC
LogId=IN_DBAMN
LogPassword=IN_DBAMN
ServerName=
Database=AS_BUILT
UserId=
DatabasePassword=
TableDir=0
StayConnected=1
AutoCommit=0
DBParm=ConnectString='DSN=AS_BUILT;UID=IN_DBAMN;PWD=IN_DBAMN'
Prompt=110
Commit=100
;INIT_TABLE_CONT=
SmartPlant Instrumentation Setup Maintenance and Database Selection 15

4. Save the INTOOLS.INI file.

5. Start SmartPlant Instrumentation.

6. In the Logon Information dialog box, select a database from the Database list.

Note

• The database you select in the Logon Information dialog box becomes the
default database.