RIS Installation Guide
RIS Installation Guide
RIS Installation Guide
Installation Guide
Version 6.0
November 2009
DNA1151A0
Copyright
Copyright 1989-2009 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 from Intergraph Corporation.
Terms of Use
Use of this software product is subject to the End User License Agreement and Limited Product Warranty ("EULA") delivered with this
software product unless the licensee has a valid signed license for this software product with Intergraph Corporation. If the licensee has a valid
signed license for this software product with Intergraph Corporation, the valid signed license shall take precedence and govern the use of this
software product. Subject to the terms contained within the applicable license agreement, Intergraph Corporation gives licensee permission to
print a reasonable number of copies of the documentation as defined in the applicable license agreement and delivered with the software
product for licensee's internal, non-commercial use. The documentation may not be printed for resale or redistribution.
Trademarks
Intergraph, the Intergraph logo, PDS, SmartPlant, FrameWorks, I-Convert, I-Export, I-Sketch, SmartMarine, IntelliShip, INtools, ISOGEN,
MARIAN, SmartSketch, SPOOLGEN, SupportManager, and SupportModeler are trademarks or registered trademarks of Intergraph
Corporation or its subsidiaries in the United States and other countries. Microsoft and Windows are registered trademarks of Microsoft
Corporation. Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its affiliates. MicroStation is
a registered trademark of Bentley Systems Inc, all rights reserved. Other brands and product names are trademarks of their respective owners.
Contents
Preface PDS ................................................................................................................................................ iii
Architecture and Configuration Overview............................................................................................... 1
RIS Architecture..................................................................................................................................... 1
Environment Overview .......................................................................................................................... 3
Schema Definition and Database Connection ........................................................................................ 4
Integrated Data Dictionary ..................................................................................................................... 5
Networking............................................................................................................................................. 5
The RIS Products ................................................................................................................................... 7
RIS Client ........................................................................................................................................ 7
RIS Development Platform ............................................................................................................. 7
RIS Utilities ..................................................................................................................................... 8
RIS Data and Net Servers ................................................................................................................ 8
Interoperability and Upgrading ................................................................................................................ 9
Multiple Versions of RIS on One System .............................................................................................. 9
System Requirements ............................................................................................................................... 11
Hardware Needed ................................................................................................................................. 11
Software Needed .................................................................................................................................. 11
Installing RIS ............................................................................................................................................ 13
Starting Setup ....................................................................................................................................... 13
Personalizing Your Intergraph Software .............................................................................................. 15
Selecting the Product Destination Path ................................................................................................ 16
Selecting the Installation Type for RISDP ........................................................................................... 17
Creating Configuration Files ................................................................................................................ 18
RIS Orphan Processes .......................................................................................................................... 18
Orphan Process Symptoms ............................................................................................................ 19
Changing the Wait Time................................................................................................................ 19
RIS License List Utility ............................................................................................................................ 21
Removing RIS Products ........................................................................................................................... 23
Running the RIS Executables .................................................................................................................. 25
Redistribution of RIS Runtime and RIS Utilities .................................................................................. 27
Directory Structure ............................................................................................................................... 27
Setup Files ............................................................................................................................................ 27
Installing the RIS Shared Component .................................................................................................. 29
Contents
Index .......................................................................................................................................................... 31
ii
Preface PDS
This document provides command reference information and procedural instructions for the
Relational Interface System (RIS) task.
iii
Preface PDS
iv
SECTION 1
RIS Architecture
The following figures illustrate how the RIS pieces fit into the connection between an
application and a database.
Since the application and RIS client usually run on the same system, they use shared memory for
fast interprocess communication. When the database is local, the client and server run on the
same machine and also use shared memory to minimize the communication overhead.
For RIS connections to database systems running on platforms not supported directly by RIS
(Unix or 64-bit Windows operating systems), the network products of the RDBMS vendors can
be used within the framework of RIS.
In the Windows environments, only the RIS library linked with the application is on the Intel
system to minimize resource usage on that system. The client process always runs on a
workstation or server, and it connects to the RIS server as in the other configurations.
Environment Overview
The following figures show the environments supported by RIS. A figure is provided for each
key piece (application/development platform, client, and data servers) in a configuration as well
as some special case connections for IBM and others. A client can connect to several databases
and database systems in various environments simultaneously.
Networking
RIS includes networking capabilities that let applications store data on different network nodes
or to isolate all data on one central node. This capability is especially useful in a network
environment where numerous workstation applications need to share data. In this configuration,
only one copy of the RDBMS is needed for the server node.
Network connections vary, depending on the hardware platform. Among the protocols currently
supported by RIS are TCP/IP.
The server products are network independent. There is no need to obtain different server
products to support different protocols. As long as the platform has the appropriate network
products installed, a single server will handle multiple network protocols. Refer to the
configuration figures in the section Environment Overview.
SECTION 2
RIS Client
RIS is based upon a client/server architecture. The client requests information from the server.
The server then retrieves the information from the database and returns it to the client.
The RIS Client and Runtime package contains the RIS Client executable and runtime support
files that are needed for all workstations or servers that are acting as clients to a RIS data server
machine. The features provided by the RIS Client and Runtime package are documented in the
RIS SQL User's Guide.
RIS Utilities
The RIS Utilities contains several RIS utilities that let users perform tasks such as schema
management, adhoc queries, and bulk loading of data. The RIS Utilities product includes the
following:
risunlod and rislod Utilities
The risunlod utility copies data definition statements and data from one or more RIS
schemas into one or more text files.
The rislod utility can then use these text files torecreate and restore the information into the
schemas. This capability is useful for archiving or transferring schema definitions and large
amounts of data from one database to another.
These programs are not meant to replace the database vendor backup utilities and
should not be used for backup or archiving purposes.
Other RIS utilities include:
risbatch (RIS command-line program)
risclnsr (RIS clean server)
risdcode (RIS decode)
risdtype (RIS data types)
risplbck (RIS playback)
risrecrd (RIS record)
rliclist (RIS license list utility)
SECTION 3
10
SECTION 4
System Requirements
Hardware Needed
The following hardware is needed to run RIS products in the Windows NT environment:
A PC with the following minimum hardware:
386 processor
12 MB of RAM (16 MB recommended)
A hard disk drive with at least 15 MB of free disk space (for complete installation of all
products).
Software Needed
The following software is needed to run RIS products:
Windows Operating System (2000 and above; check the readme.txt file for supported
operating systems.)
Microsoft Visual C++ Compiler (Development Platform only).
11
System Requirements
12
SECTION 5
Installing RIS
Use the setup program to install software products on a PC.
You must have administrative privileges to run setup. Also, if you install the RIS product
onto a clean system, you must reboot to initialize the system path variable for the product.
Otherwise, the system cannot see the executables and returns an error when you attempt to use a
RIS utility.
You can use setup to install an Intergraph product as follows:
1. Insert the delivery medium and start setup.
2. Record customer information in the software.
3. Select the product destination path.
4. Select the type of installation (compact, typical, or custom). This option applies only to the
RIS Development Platform installation.
The setup program copies product files to the system, then creates or modifies system
configuration files. If for some reason the installation fails, risdp.log or risds.log and risrem.log
are copied to TEMP directory.
Starting Setup
Insert the delivery media into the appropriate drive, and start setup as follows:
1. Select Run from the File menu in the File Manager window.
2. Key in one of the following commands on the command line:
drive:\setup
drive:\directory\setup
\\server\share\directory\set
up
13
Installing RIS
You first see the Welcome dialog box. Then, if an existing version is already on your
system, a prompt lets you continue or cancel installation. If you select Continue, setup deletes
the existing version and continues with the current installation. Select Cancel Setup to quit.
Then, if an existing version is already on your system, a prompt lets you continue or cancel
installation. If you select OK, setup deletes the existing version and continues with the current
installation. Select Cancel to quit.
14
Installing RIS
15
Installing RIS
Key in your username and your company name; click Next.
The following list shows the default installation locations for the products described in this
document:
RIS Development Platform: C:\ Program Files\ RISDP directory.
RIS Oracle Data Server: C:\ win32app\INGR\RISORADS_X.X directory (where X.X
represents the version number).
16
Installing RIS
In addition to displaying the installation options, this dialog box displays the amount of
additional disk space required for the selected installation. Ifthe product you are installing
already resides on the system, this value may be 0 blocks, indicating that no additional disk
space is required for the installation.
Select from the following installation options:
Compact - Installs only the files and tools that you need to develop RIS SQL applications.
Typical - Installs the minimum configuration and the files that you need to develop
loader/unloader and forms applications, sample files, and RIS packaging files that you need to
redeliver RIS.
17
Installing RIS
Custom - Installs the minimum configuration and lets you select which parts of the complete
configuration to install.
See Also
Orphan Process Symptoms (on page 18)
Changing the Wait Time (on page 19)
18
Installing RIS
RIS Client and RIS Data Server processes continue to exist on the RIS client machine when
a user re-boots their RIS application machine while connected to the database through RIS.
This happens when a RIS application is connected to the RIS client through TCP/IP.
Because the RIS client process exists, all RIS server processes connected to the RIS client
process exist.
RIS Data Server processes continue to exist on the RIS server machine when a user reboots
their RIS client machine while connected to the database through RIS. This happens when
the RIS client machine is connected to an RIS Data Server through TCP/IP.
In the version ofthe RIS Client delivered with RISDP, orphan processes are no longer a problem.
Also, the RIS Data Server orphan process problem is fixed in the RIS Data Server version 5.3.1
or higher products.
The default wait time for an orphan process is 2 hours. Thus, after the RIS application or RIS
client machine is re-booted, the orphan process waits for 2 hours before it goes away. The wait
time can be changed and the procedure for this change is platform specific.
The side-effect of changing the wait time is that it affects all applications using the
TCP/IP KeepAlive feature. Do not set the KeepAlive wait time to less than 30 minutes.
19
Installing RIS
20
SECTION 6
The utility queries the system for RIS data server usage. If no data server is active, no usage
message is displayed. License user limits and database connections are displayed only if
there is a current RIS data server user.
2. Click the Refresh button to repeat the query.
3. To monitor peak license usage, click the Peak Usage button.
21
This function allows the administrator to view the maximum number of connections that
have occurred since the log was started or cleared. Clearing the log file begins a new
monitoring period.
When the license user limit is exceeded, a note is posted in the rliclist display area.
Typically, this only happens during the initial 90-day grace period.
4. Click the Save As button to save the log information to a text file.
22
SECTION 7
23
24
SECTION 8
In the previous directory path, major and minor version numbers are determined as
follows: In the product release number 05.01, the major number is 05, and the minor number is
01
You can also start the RIS utilities from Start > Programs.
25
26
APPENDIX A
Directory Structure
The RIS Shared Component is delivered as part of the RIS Development Platform to the c:\
Program Files\ risdp\ shared directory. This directory includes files to be delivered to the user
system, and other setup and packaging files as described in the following section.
Setup Files
Use the following setup files to build the setup media for your application:
rissetup.lyt - This file is the Microsoft Setup layout file for the RIS Shared Component files.
Append your application's .lyt file to this file.
Use the combined .lyt file to create a .inf file with the dsklayt2 utility (which is part of the
SETUP SDK product). Your setup program uses the .inf file to download the necessary files
to the end-user's system.
rissetup.lib - The functions in this library install the RIS Shared Component on the end-user's
system. You must link your setup program with this library, and call the following functions, in
order:
a. ReadInfFile();
Call this function once before calling any other setup functions for the RIS Shared
Component.
b. SetupRIS();
This function determines the version of the RIS Shared Component that is already
installed, if any. You must use the value returned by this function as input to the
RegEdtRIS function.
Status Returns
0 - Existing version is newer than your version. RIS shared component is not loaded.
1 - Existing version is older, or the same date as your version. RIS Shared Component is
loaded.
27
28
The installation procedure examines the system PATH variable to see if it contains the \Program
Files\ Common Files\ Intergraph directory. If the PATH does not contain this directory, the
installation procedure appends \ Program Files\ Common Files\ Intergraph to the system PATH.
Registry Information
The RIS Shared Component puts information into the System Registry to indicate its presence
on the system. The component installation procedure creates the key
HKEY _LOCAL _MACHINE\Software\Intergraph\RIS\<Major .Minor>
29
30
Index
A
Architecture and Configuration Overview 1
C
Changing the Wait Time 19
Creating Configuration Files 18
D
Directory Structure 27
E
Environment Overview 3
H
Hardware Needed 11
I
Installing RIS 13
Installing the RIS Shared Component 29
Integrated Data Dictionary 5
Interoperability and Upgrading 9
RIS Client 7
RIS Data and Net Servers 8
RIS Development Platform 7
RIS License List Utility 21
RIS Orphan Processes 18
RIS Utilities 8
Running the RIS Executables 25
S
Schema Definition and Database Connection
4
Selecting the Installation Type for RISDP
17
Selecting the Product Destination Path 16
Setup Files 27
Software Needed 11
Starting Setup 13
System Requirements 11
T
The RIS Products 7
M
Multiple Versions of RIS on One System 9
N
Networking 5
O
Orphan Process Symptoms 19
P
Personalizing Your Intergraph Software 15
Preface PDS iii
R
Redistribution of RIS Runtime and RIS
Utilities 27
Removing RIS Products 23
RIS Architecture 1
Relational Interface System (RIS) Installation Guide
31