Enlube™ Proaction Manager Installation Guide

Enlube™ Proaction Manager
Installation Guide
Your Guide for Installing
Enlube PM
with a
Sybase® Database
System 11
Entek IRD International Corporation
P/N 45235
Copyright Notice
Copyright © 2000 by Entek IRD International Corporation
All Rights Reserved
First Edition 2000
Printed in the U.S.A.
This Manual is supplied to the User under license, subject to recall by Entek IRD
International Corporation at any time, and the Manual at all times remains the property
of Entek IRD International Corporation. The information contained in this Manual is
considered confidential. No part of this Manual is to be copied or reproduced or
transmitted in any form whatever (including orally or by electronic transmission), nor
is any information in this Manual to be disclosed in any form whatever (including
orally or by electronic transmission) to anyone other than an authorized representative
of the User’s employer who also shall agree not to disclose same, without express
prior written consent of Entek IRD International Corporation.
Trademarks
Enlube is a trademark of Entek IRD International Corporation.
Entek and IRD are registered trademarks of Entek IRD International Corporation.
Microsoft, MS-DOS, and Windows are registered trademarks of Microsoft
Corporation.
SYBASE is a registered trademark of Sybase, Inc.
System11, Sybase SQL Server, and Sybase SQL Anywhere are trademarks of Sybase,
Inc.
All other product names are registered trademarks of their respective owners.
Entek IRD International Corporation
1700 Edison Dr.
Milford, OH 45150-2729
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Planning for the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
What to Read Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2. Installing the Database Components . . . . . . . . . . . . . . . . . . . . . . . . . .7
Installing the Sybase Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Creating the Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Running the Creation Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Importing the Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Installing the Sybase Network Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Connecting the Client to the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Adding the Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Configuring the Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3. Installing Enlube PM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Installing Enlube PM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing the Network Administration Installation . . . . . . . . . . . . . . . . . . . . . . 17
Installing for a Remote Computer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Troubleshooting Database Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Troubleshooting during the Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Troubleshooting the Hardware Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Missing or Invalid Security Key with AMD K-6 Processors . . . . . . . . . . . . . 22
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Installation Guide: Sybase
4
Chapter 1
Introduction
1.
This chapter introduces you to Enlube™ PM, offering an overview of the installation
process. These sections guide you through this chapter:
Overview ..................................................................................................... 2
System Requirements................................................................................... 2
Planning for the Installation....................................................................... 3
What to Read Next ...................................................................................... 5
1
Installation Guide: Sybase
Overview
Enlube PM are used with a database server and client, offering access to the databases
that store vibration, oil, image, and other types of data.
This install guide offers information on the entire install process, including database
server installation, client installation, connection information, and database
maintenance.
This installation guide is intended for first-time installations of Enlube. It also contains
reference information for later use.
Your satisfaction with the products we provide is our highest priority. Thank you for
letting us help you with your machinery information needs.
System Requirements
2
z
Pentium 166 MHz miniumum; 200 MHz or more recommended
z
32 MB RAM miniumum; 64 MB or more recommended
z
2.1 GB hard drive
z
CD-ROM drive
z
VGA or SVGA graphics card
z
Microsoft® Windows® 95, 98, or NT operating system
Installation Guide: Sybase
Planning for the Installation
Here is a list of things you need to do before you begin installing Enlube PM for the
first time.
Hardware Key - Attach the hardware key to the parallel port.
The Hardware Key gives information to Enlube PM to insure that you are running a
legal copy of the software. This key should be attached to the parallel port on the back
of any computer that runs Enlube PM.
CD Activation Key - Find the CD Activation key on the back of your CD jewel
case.
The CD Activation Key is an alpha-numeric code in the format: xxxxx-xxxxx-xxxxxxxxxx. This key tells the installation program which components you have requested,
and automatically sets up the installation for those components. If you simply choose
the Next button through the installation program, you install all the requested
components from the CD key. For complete flexibility, you are also allowed to pick
and choose from those components.
Available Disk Space - Check your available disk space.
Disk space requirements vary depending on which components you need to install.
The installation program shows you exactly how much space is needed for each
component. For a guideline, EMONITOR Odyssey with two data collector interfaces
requires about 45 megabytes (MB) of disk space. EMONITOR Odyssey with all
Online components requires an additional 18 MB of disk space, for a total of 73 MB
needed on the client computer. Enshare requres about 50 MB of disk space on the
client computer. There are additional disk space requirements depending on your
database setup. Be sure to check with your database administrator about these
requirements and backing up your database.
Time for Installation - Be sure you allow plenty of time for the installation.
When performing an update from a previous version of Enlube PM, be sure you allow
plenty of time for the database export, import, and restructure processes. When
working with large databases, this can take some time.
Planning for the Installation
3
Installation Guide: Sybase
Specific Database Versions - Be sure you have the 32-bit version of the
database software installed.
Before installing Enlube PM, you have to make sure the database server version is
compatible. You might need to consult with your database administrator to verify
which version of the database server you are using. This table shows the minimum
database versions supported with Enlube PM. If you need to install a new version, ask
your database administrator.
Database software
Centura (formerly Gupta)
Oracle
MS SQL Server
Sybase
Version number
6.1.2
7.2, 7.3.4*, or 8.0
6.5 SP 4 or 7.0
10 or 11
* You cannot use Oracle 7.3.3 with the Scheduler application. We recommend you
upgrade to 7.3.4 for the best results with Enlube PM.
Operating System Versions - Be sure you have Windows 95/98 or Windows
NT 4.0 installed.
Before installing Enlube PM, you need to have one of these operating systems on your
computer. Enlube PM cannot be installed on Windows NT 3.51.
4
Installation Guide: Sybase
What to Read Next
To learn about new features and improvements in Enlube PM, read the Entek Product
Release Notes.
To get started quickly, read the Getting Started Guide. The Getting Started Guide
introduces you to the software, and shows you how to use the online help included
with the software. The Getting Started Guide also introduces you to the online tutorial.
The online tutorial leads you through some of the basic tasks. These include setting up
the database, setting up online hardware if needed, creating a list, and viewing plots
and reports.
Refer to the User's Guide for detailed instructions on using all the functions of the
software. The online help system includes all the instruction in the printed User's
Guide, as well as explanations for all the commands and controls. Just press F1 to
access the online help at any time.
If you are using data collectors with a walkaround system, you may receive additional
User's Guides for each of those interfaces. If you are using an online system, you may
receive additional manuals for the hardware you use for data collection, and you
receive the Online Applications User's Guide.
What to Read Next
5
Installation Guide: Sybase
6
Chapter 2
Installing the Database Components
2.
This chapter goes through the database installation process. These sections will guide
you through this chapter:
Installing the Sybase Server........................................................................ 8
Creating the Databases............................................................................... 8
Running the Creation Scripts...................................................................... 9
Importing the Data...................................................................................... 9
Installing the Sybase Network Client........................................................ 10
Connecting the Client to the Server .......................................................... 11
7
Installation Guide: Sybase
Installing the Sybase Server
As always, if you are updating, back up your database directories to insure that you
have a backup copy.
Check with your database administrator to make sure you are running version 10 or
11. Your database administrator should install the Sybase server.
Read the Sybase documentation for information about installing the database server.
You should have a database installed and check the version number to make sure it is
compatible with Enlube PM.
Creating the Databases
For new installations of Enlube PM, you must create database devices to hold the data,
then import the data into the database. You must have DBA rights to complete these
steps. Remember that Sybase uses case-sensitivity for all commands and logins.
You are basically creating two databases. The Entek database holds all historical data
and data that the software needs to run. The Econfig database holds the configuration
information that the software needs.
1. Connect to Sybase as a System Administrator (SA).
2. Using SQL Central, create two database devices to hold the tables: entekd and
enteki. You can double-click the “Add a database device” wizard to do so.
3. Create the Entek login and password.
4. Grant the Entek user proper rights to the database.
5. Connect as the Entek user instead of SA.
6. Create two database devices to hold the tables: econfigd and econfigi.
7. Create the Econfig login and password.
8. Grant the Econfig user proper rights to the database.
9. Connect as the Econfig user instead of SA.
8
Installation Guide: Sybase
Running the Creation Scripts
You are supplied with script files which will create the tables for your new database.
You must import the data after running the creation script.
1. If needed, modify the script files enteksyb.sql and cfgsyb.sql so the correct device
names are used.
2. Run the table creation scripts located on the Entek CD in the Entek Extras
directory.
D:\Entek Extras\scripts\Sybase\enteksyb.sql;
D:\Entek Extras\scripts\Sybase\cfgsyb.sql;
Importing the Data
1. After running the creation script, you must run Efwdbu.exe to import the data into
the tables. This application is located in your Entek program directory.
2. From the Options menu, choose Import. Choose the following settings for each
field.
z
Choose Centura/Sybase for Access Library.
z
Leave Database blank.
z
For Username, enter your Sybase username.
z
For Password, enter the password for the chosen username.
z
For DBServer, enter the connect string for the database.
3. From the File menu, choose Import Database. Select the correct dbu file and
choose Open.
The import process may take some time, please be patient.
Running the Creation Scripts
9
Installation Guide: Sybase
Installing the Sybase Network Client
The Sybase database client requires about 10 MB of space.
1. Insert the Sybase Installation CD-ROM disk into the CD-ROM drive of your
computer. Run setup.exe.
2. Use the default directory for the Sybase files, and then choose Continue.
3. Choose Windows 95 Products to install the 32-bit version of the database client.
You will see a different screen for Windows NT. Choose Continue.
4. Choose Language Modules and Open Client/C. You will see a different screen for
Windows NT. Choose Continue to go on.
5. Choose OK.
6. Choose OK to allow your Autoexec.bat file to be modified.
7. Choose Resume, noting the name of the copy of your autoexec.bat.
8. Select Run sqledit to edit your SQL.INI and choose Continue.
9. Select the Platform and enter the Network Address. The example shows the
default server name; you should use your server name.
Choose Add to add the server entry. Choose Add Service to add the connection
service entry.
10. Enter the directory for the Sybase database tools. Choose Next to continue.
11. Select only the Sybase System 11 ODBC driver and choose Next to continue.
12. Choose OK to continue.
13. Select Make all the modifications for you and choose OK to continue.
14. Choose OK to continue.
15. Choose OK to continue.
16. Choose OK to continue.
17. Select Reboot machine and choose Finish to complete the installation.
10
Installation Guide: Sybase
Connecting the Client to the Server
Before you can open the database using Enlube PM, you must set up an ODBC Data
Source so that EMONITOR can find the database on the network. Then, you must
configure the client to recognize the server. To do so, follow these steps.
Adding the Data Source
1. From the Start menu, choose ODBC Administrator under Sybase SQL Server
Professional.
2. Choose Add.
3. Select Sybase System 11 for the type.
4. Choose Finish.
5. Enter the connect string you used in the Entek installation program for Data
Source Name. The Description field is optional. Enter the name of the server next
to Server Name.
6. Choose Advanced. You do not need to change any settings here.
7. Choose Performance. For Select Method, choose 0-Cursor. Choose Close.
8. Choose Close in the Advanced dialog box, then choose OK to create the Sybase
data source.
Connecting the Client to the Server
11
Installation Guide: Sybase
Configuring the Client
1. From the Start menu, choose SQLEDIT under Sybase SQL Server Professional.
2. Under Input Server Name, enter the name of the server.
3. Choose the Add button.
4. Under Service type, choose query.
5. Under Platform, choose NT/Windows 95.
6. Under Net-Library driver, choose NLWNSCK.
7. Under Connection Information/Network Address, enter the IP address of the
server, then the port, which is 5000 by default. Put a comma between the address
and the port, as shown below.
8. Choose Add Service. This illustration shows the final result.
9. From the File menu, choose Save. Then, exit the program. Your SQL.INI file
should be set up correctly for connecting to Enlube PM.
12
Chapter 3
Installing Enlube PM
3.
This chapter goes through installation process for Enlube PM. This chapter mainly
discusses running the Setup.exe file, which begins the Entek installation program.
These sections guide you through this chapter:
Installing Enlube PM ................................................................................ 14
Installing the Network Administration Installation .................................. 17
Installing for a Remote Computer ............................................................ 18
13
Installation Guide: Sybase
Installing Enlube PM
This installation procedure is intended for first-time installations. If you are updating
from a previous installation, refer to the chapter about updating.
If you choose the defaults through the installation, the program installs the selections
directly from the CD Activation Key. You can customize this installation if needed.
Portable systems use walkaround data collectors for collecting data, and all Enlube
PM components can be installed on one computer. Online systems use networked
systems that monitor and collect data, and some components can be installed on
different computers to increase efficiency. You may also use a combination of
portable and online systems, and use selected computers for each component.
This section walks you through the installation step-by-step with specific information
available when needed. This section goes through a typical installation for a portable
system.
Quit any running applications before starting the Entek installation program.
1. Insert the Entek Installation CD-ROM disk into the CD-ROM drive of your
computer. It should auto-start and display this install screen. Choose the Install
Software option to run Setup.exe on the CD-ROM drive. (Note: If you are running
the CD from another computer, you must map the CD to a drive on the computer.)
2. Choose Next to continue at the first dialog box.
14
Installation Guide: Sybase
3. Type in the CD Activation Key from the back of your CD jewel case. This selects
the components that you have purchased for installation. Choose Next to continue.
4. The Product Installation Availability List tells you which components are available
for installation based on your CD Activation Key. Choose Next to continue.
5. The next dialog box allows you to select which components to install on the
computer. Select the checkbox to select or clear each component. Click on the
component name to read a description below. The default components are selected
from your CD Activation Key, so you can simply choose Next if you want to
install components exactly as you ordered them. Choose Change if you want to
pick and choose different components.
6. Choosing Change opens another dialog box, which allows you to select subcomponents. Select the sub-components you want to install or deselect those you
do not want to install. The data collector drivers are part of the sub-components
list. You can scroll down to see more selections. For portable systems, the default
settings should work well for your system.
7. Some database types confirm that you are using the correct version. Choose OK to
continue.
8. The next dialog box shows the system requirements. If your system passes, choose
Next. See “System Requirements” on page 2 for more information.
Installing Enlube PM
15
Installation Guide: Sybase
9. Choose the directory where you want to install the selected Enlube PM
components. Choose Browse to change the destination directory.
For Centura databases, the Centura Installation Option screen appears next. If
you want to install the Centura components, choose Yes and see “Installing the
Centura Network Client on page 8.
10. Choose Next to add the Entek folder to your Start menu.
11. Choose Next to accept the configuration. Setup begins copying files to the
appropriate destinations.
12. For Oracle, Sybase, or MS SQL Server databases, enter the name of the
database alias for the Entek database in the Connect field, and the username and
password in the following fields. You may want to write down this string so you
remember it later. Choose Next to continue.
Repeat this procedure at the next screen for the EConfig database.
IMPORTANT: If you do not enter the correct information, you will have to edit the
registry yourself to put in your connect string, username, and password.
13. The installation is nearly complete. Select Yes, I want to restart my computer
now and choose Finish to restart your computer.
16
Installation Guide: Sybase
Installing the Network Administration Installation
The Network Administration installation allows you to run the Entek installation from
a networked computer. This lets you install Enlube PM to any networked computer, so
you don't have to carry the CD to different sites.
1. Insert the Entek Installation CD-ROM disk into the CD-ROM drive of a
networked computer and perform the installation just as described in “Installing
Enlube PM” on page 14.
2. Select the check box next to Odyssey or Enshare Administrator Installation.
3. Choose Next to continue through the rest of the installation.
4. At the Destination Folder choice, choose a shared directory to access the
Setup.exe file later from other computers.
5. Finish the installation and restart the computer.
6. From a client computer, map a network drive to the location of the Destination
Folder. You must map the drive or the Entek installation program will not
run.
7. You can now run Setup.exe from a client computer with a mapped drive to install
Enlube PM.
Installing the Network Administration Installation
17
Installation Guide: Sybase
Installing for a Remote Computer
This installation allows you to run Enlube PM using only minimum components on a
networked computer. This lets you install the program files to a computer that may not
have much hard drive space. The program runs on a separate computer, which may
slow down the process.
To accomplish this, follow these steps.
1. Insert the EMONITOR Odyssey Installation CD-ROM disk into the CD-ROM
drive of a networked computer and perform the installation just as described in
“Installing Enlube PM” on page 14.
2. Select the check box next to Remote EMONITOR User Installation.
3. Choose Next to continue.
4. Choose Next to continue through the rest of the installation. At the Destination
Folder choice, choose the directory that contains the epm.exe program on the
computer with the full installation.
5. Finish the installation and restart the computer when asked. You can now run
Enlube PM from a remote computer.
18
Chapter 4
Troubleshooting
4.
This chapter offers troubleshooting information for EMONITOR Odyssey and
Enshare installations. These sections guide you through this chapter:
Troubleshooting Database Connections ................................................... 20
Troubleshooting during the Installation ................................................... 21
Troubleshooting the Hardware Key .......................................................... 22
19
Installation Guide: Sybase
Troubleshooting Database Connections
Someone else installed EMONITOR Odyssey or Enshare on my computer and now I
can’t run it.
You must run a registry file on all NT Workstations if the person who installed the
program is not the same as the end user(s). The install program enters information in
the registry that points to the database for that user only. Any other users of the
database must also have the settings in their registry point to the correct place. If you
get the error message shown here, you are a different user than the person who
installed EMONITOR Odyssey or Enshare, and the registry reflects this.
You can verify that you do indeed have this error by choosing the Start menu, then
Settings, then Control Panel. Double-click the 32-bit ODBC icon. The following
screen appears. If your registry does not point to the correct database, the User Data
Sources under the User DSN tab is blank.
20
Installation Guide: Sybase
When you get this error, simply run the file odbc.reg, found in your Odyssey program
directory. The default program directory is C:\Program Files\EntekIRD\Odyssey\.
Double-click on the file to run it from Windows Explorer. If the registry update was
successful, the ODBC data source screen will have the correct data source in it.
After running odbc.reg, you can verify that the User Data Sources are correct by
choosing the Start menu, then Settings, then Control Panel. Double-click the 32-bit
ODBC icon. You should have a data source now.
Troubleshooting during the Installation
Client-server applications like EMONITOR Odyssey and Enshare can be complicated.
This section is provided to give you a guide if things don't go quite right the first time.
Do I have to install certain online components to certain computers?
You can install any component of an online system to any computer in the system,
whether it's an Unload Station or an Analysis Station or a combination of the two.
Why do Unload Station Manager and Scheduler start when I restart my computer?
When you restart your computer after installing, Unload Station Manager and
Scheduler automatically start because they are in your Start Up folder. You can modify
your Start Up folder by right-clicking the Start button and choosing Explore. Open
the Programs folder, then open the Start Up folder. It contains shortcuts to the
programs that automatically start when you start your computer.
Why can’t I run the Entek install program on Windows NT?
In order to install the program on a computer running Windows NT, you have to have
administrator rights. You might have to ask your computer staff to give you
administrator rights in order to install EMONITOR Odyssey or Enshare.
Troubleshooting during the Installation
21
Installation Guide: Sybase
What happens if the computer gets turned off in the middle of an installation?
If your computer crashes or gets turned off in the middle of the installation program,
the uninstall procedure will not work. You must delete these files from your Windows
or WinNT directory if a crash happens and you want the unistall to work correctly.
dataimport.isu
generic.isu
scheduler.isu
storage.isu
efw.isu
hw.isu
severity.isu
ul.isu
Troubleshooting the Hardware Key
You must have the hardware key attached to any computer with EMONITOR Odyssey
or Enshare components installed on it. If you have online components, you must have
a hardware key encoded for online use.
Missing or Invalid Security Key with AMD K-6 Processors
If you are using an AMD K-6 processor, you may see an error message on start up. If
you get an error message similar to the one shown below, first check to make sure your
hardware key is attached to the parallel port.
If the key is firmly attached, there may be a problem with the timing of the messages
sent from the software to the hardware key. We have discovered that this error can
occur when using an AMD K-6 board. To correct this problem, follow these steps to
change the timing of the message sent between the Entek software and the Entek
hardware key.
1. Go to your program directory and run Eregedit.exe.
2. Scroll down and choose Security Key Timing Value P and choose Edit, or doubleclick on the selection.
22
Installation Guide: Sybase
3. Enter the following in the New Value field:
100.
4. Choose OK, then choose Yes.
Note: These are just test values to make sure that you have the timing problem. This
timing change will slow your entire system down while this setting is in place.
Your mouse and keyboard are also affected by this timing change. These are only
test values however, which you will change until they are correct.
5. Repeat steps 2-4 for Security Key Timing Value I and Security Key Timing
Value O.
6. Try to run the program again. You should no longer get the security key error
message. This confirms that timing is the problem with the security key.
7. Next, change the test values to smaller numbers. Our tests show that 40, 40, 60 are
values that work well for the AMD K-6 processor. The goal is to make the number
as small as possible but large enough to allow Entek software to recognize the
hardware key. This may take several tries with smaller numbers.
Timing Value
Value P
Value I
Value 0
Number
40
40
60
Troubleshooting the Hardware Key
23
Installation Guide: Sybase
24
Index
A
S
AMD K-6 processor 22
Setup.exe 14
System Requirements 2
C
CD Activation Key
entering 15
locating 3
Connect String 16
T
troubleshooting
database 20
hardware key 22
installation 21
D
data collector installs 14
database alias
Connect field 16
database versions 4
disk space requirements 3
E
Enlube PM install 14
H
hardware key
attaching 3
troubleshooting 22
N
Network Administration installation 17
P
portable systems 14
R
Remote Computer installation 18
V
version
database servers 4
Sybase System 10 or 11 8
Installation Guide: Sybase
26