DataMetrics Server Installation Guide
DataMetrics Server Installation Guide
Copyright 2013
ASI DataMyte, Inc.
All rights reserved.
95690-004
DataMetrics Server Installation Guide
http://www.asidatamyte.com
Restricted Rights Legend – Use, duplication, or disclosure by the Government is subject to restrictions as set forth in
Section 52.227-7013(c)(1)(ii)(May, 1987) of the U.S. Department of Defense Supplement to the Federal Acquisition
Regulations or other similar regulations of other governmental agencies.
Export Notice – These commodities are licensed by the U.S. for ultimate destination (ELS Country). Diversion
contrary to U.S. Law prohibited.
Disclaimer – In no event shall ASI DataMyte, Incorporated be liable for direct, indirect, special, incidental, or
consequential damages arising from the use or inability to use this product or documentation, even if advised of the
possibility of such damages. Information in this document is subject to change without notice and does not represent a
commitment on the part of ASI DataMyte, Inc. Because of the variety of uses for the product described in this
document, those responsible for the application and use of this hardware and software must satisfy themselves that all
necessary steps have been taken to assure that any application and use meets all performance and safety requirements,
including any applicable laws, regulations, codes and standards.
Copyright Notice – Reproduction of the contents of this copyrighted publication, in whole or in part, without written
permission of ASI DataMyte, Inc. is prohibited. Copyright © ASI DataMyte, Inc. All rights reserved. Microsoft ® and
Windows® are registered trademarks of Microsoft Corporation. The license management portion of this software
application is based on SentinelRMS®. Copyright © 1989-2006 SafeNet, Inc. All rights reserved. Sentinel is a
registered trademark of SafeNet, Inc. If this software application is licensed for use other than with a Microsoft®
database, it includes one or more of the following applications - DataDirect Connect® for ODBC, DataDirect Connect®
for ADO or DataDirect Connect® for ADO.net. Copyright © 1993-2006 DataDirect Technologies. All rights reserved.
DataDirect Connect® is a registered trademark of Progress Software Corporation in the U.S. and other countries. Other
product names mentioned in this document are trademarks or registered trademarks of their respective companies and
are hereby acknowledged.
Table of Contents
OVERVIEW ............................................................................................................................. 1
INSTALLING DATAMETRICS............................................................................................ 4
STEP 1 – PREREQUISITES INSTALLATION ................................................................................ 4
Performing the Prerequisites Installation .......................................................................... 4
STEP 2 – INSTALL THE DATAMETRICS DATABASE CONNECTIVITY KIT .................................. 5
Installing the Connectivity Kit for Microsoft SQL Express ................................................ 5
Installing the Connectivity Kit for Microsoft SQL Server .................................................. 7
Installing the Connectivity Kit for Oracle ........................................................................ 10
STEP 3 – INSTALL THE SECURITY DATABASE CONNECTIVITY KIT ........................................ 15
Security Database Connectivity for Microsoft SQL Server 2008 R2 Express .................. 15
Security Database Connectivity for Microsoft SQL Server 2008 ..................................... 16
Security Database Connectivity for Oracle ..................................................................... 16
STEP 4 – INSTALL THE SECURITY SERVICE ........................................................................... 17
STEP 5 – INSTALL THE LICENSING SERVER ........................................................................... 18
UPGRADING A PREVIOUS QUANTUM OR APPLIED STATS INSTALLATION ... 19
Table of Contents
Overview
This document explains how to install the various server-related applications of the
DataMetrics product suite. Prior to getting started, there are several important items to point
out with respect to the DataMetrics installation.
First, the architecture of the DataMetrics product suite is very different than either the
Quantum or Applied Stats products and contains several new items that must be installed and
properly configured to ensure correct operation of the system.
` ` `
Licensing
Security
` `
DataMetrics DMT Audit Log
Security Database ` `
Database
RCSL Bridge
Licensing
Security
DataMetrics
Security Database
Database
Installation Instructions 1
DataMetrics Server Installation Guide
As noted in the previous diagram, the Server components can be located on a single server, or
on a separate database server and application server. The decision on how to deploy is up to
the needs and system requirements of each end user.
1) The installation of the server components will require a minimum of one reboot of the
server, possibly two, depending on the database engine that is being implemented.
2) If you install the DataMetrics MS SQL 2008 R2 Express database engine on a server that is
currently running MSDE, all attached MSDE databases will automatically update to SQL
2008 R2 Express. If you do not want this to occur, then you should install DataMetrics
on a separate server.
3) Always back up your databases prior to migrating or installing the DataMetrics database
connectivity kit.
NOTE: The server installation procedures are essentially identical whether you are installing
a brand new installation of DataMetrics or you are migrating an existing Quantum or Applied
Stats installation. Customers that are migrating from Quantum or Applied Stats will follow
the basic installation instructions presented in this document to install the core components of
the DataMetrics software suite. Once this is completed, please refer to the Quantum &
Applied Stats Migration Guide to migrate your existing database.
Installation Instructions 2
DataMetrics Server Installation Guide
Notification
Licensing
Security
DataMetrics
Security Database
Database
Required Installation:
1. Install Prerequisites
2. DataMetrics Database Connectivity Kit
3. Security DB Connectivity kit
4. Licensing Service
5. Security Service
Notification
Licensing
Security
DataMetrics
Security Database
Database
Installation Instructions 3
Installing DataMetrics
This section covers the steps necessary to install the DataMetrics suite. As noted previously,
these same steps apply whether you are installing a brand new installation of DataMetrics or
you are upgrading a previous Quantum or Applied Stats installation.
On the server side the DataMetrics Services for Licensing and Security require the installation
of the prerequisites. The prerequisite installation is also required for customers that run
DataMetrics using the SQL Server 2008 R2 Express database engine.
The components contained in the Prerequisite installation are ones that are required across the
entire DataMetrics suite. If an individual DataMetrics application has a specific required
component for itself, it will need to be installed separately.
Refer to the DataMetrics System Requirements PDF. See the Operating System and Other
Required Components section.
1. Insert the installation DVD into the database host computer's DVD drive.
If the computer does not automatically start the setup program, click Run from the Start Menu
and specify e:setup, where 'e' is the letter of the DVD drive.
4. Read the ASI DataMyte, Inc., Software License Agreement and, if you agree with the terms
(and warranty information), select the "I accept…" radio button.
5. Click the Next Button. The installation begins searching for the required components listed
previously. Only those components that do not already exist on the workstation will be
installed.
6. At the Start Copying Files screen, you may either click the Install button to begin copying
files or click the Back button to return to previous screens and make changes. This screen lists
the components that will be installed.
7. Several of the prerequisite components require that the workstation be restarted as part of the
installation. When prompted to do so, leave the installation DVD in the DVD drive and restart
the computer. After the restart, ensure that you log in as the same user.
Installation Instructions 4
DataMetrics Server Installation Guide
8. When the installation is complete, you may either continue to install other DataMetrics
applications as needed or remove the installation DVD and store it in a safe place.
You do not need to uninstall the previous Microsoft SQL Express engine installation before
beginning these procedures. You may simply perform this installation on top of the previous
one.
NOTE: If you will be using both DataMetrics and EnGage! software in the same
environment, ASI DataMyte recommends that you first install EnGage! and then DataMetrics.
1. As noted previously, when installing the DataMetrics SQL 2008 R2 Express database engine
on a server that is already running MSDE, all attached databases will automatically be
upgraded to SQL Express. It is always highly recommended that you back up all databases
prior to installing the DataMetrics connectivity kit.
2. Insert the installation DVD into the DVD drive. If the setup program does not automatically
start, click Run from the Start button and specify e:\launch, where 'e' is the letter of your
DVD drive.
5. Read the ASI DataMyte, Inc., Software License Agreement and, if you agree with the terms
(and warranty information), select the "I accept…" radio button and click Next.
6. Enter the DVD key for Express exactly as it appears on the DVD case and then click Next.
(Note that Windows XP users may see a dialog box warning them to perform additional
procedures to allow users to connect to the Microsoft SQL Express database.)
7. The screen that appears and the steps you should perform next depend on what type of
installation you are performing:
If you are performing a brand new installation of Microsoft SQL Express, the Choose
Destination Location screen appears. You can continue to Step 8.
If you are performing an upgrade of an existing Microsoft SQL Express installation, but
have for any reason uninstalled the Microsoft SQL Express engine, you will be prompted
whether to use a new DataMetrics database (which will overwrite your existing database)
or use your existing one. If you choose to use a new database, you can skip to Step 9 at
this point. If you choose to keep your existing database, you can skip to Step 10.
Installation Instructions 5
DataMetrics Server Installation Guide
If you are performing an upgrade of an existing Microsoft SQL Express installation and
still have the Microsoft SQL Express engine installed, you will see the Start Copying Files
screen. You may skip ahead to Step 10 at this point.
8. Click Next to accept the default directory C:\Program Files\ASI DataMyte) or use the Change
button to browse to and select the desired location.
9. Select Yes or No to specify whether or not to include demo data during the database
installation.
10. At the Start Copying Files screen, review the current settings displayed and verify they are
correct. If satisfied, click Next to begin the actual file installation. If you want to change any
of the settings, use the Back button to return to previous screens and make changes.
11. A message prompt appears advising you that a reboot will be required during the installation.
Click OK to this message prompt and then, when prompted, reboot your computer.
12. When logging back in, be sure to login as the same user currently running the installation, and
do not remove the installation DVD. After the computer has been restarted, the installation
continues automatically.
13. Once the installation is completed, remove the installation DVD and store it in a safe place.
The following information, which cannot be changed through the installation user interface, is
loaded during the installation process:
The backups are online backups and should not impact users connected to the database. It is
recommended that the backup files be copied to a network drive or a different machine to
reduce downtime in case of a database server failure. The backup files are located in the same
directory as the database files (DATAMETRICS_DATA.MDF and DATAMETRICS
_LOG.LDF).
Installation Instructions 6
DataMetrics Server Installation Guide
NOTE: The Microsoft SQL Server database build procedures are intended for the Microsoft
SQL Server database administrator to build the DataMetrics database structure. Specific
database build procedures vary, depending on the tools used by the database administrator.
This documentation provides only general procedures.
1. Insert the installation DVD into the DVD drive. If the setup program does not automatically
start, click Run from the Start button and specify e:\launch, where 'e' is the letter of your DVD
drive.
4. Read the ASI DataMyte, Inc., Software License Agreement and, if you agree with the terms
(and warranty information), select the "I accept…" radio button and click Next.
5. Enter the DVD key for SQL Server exactly as it appears on the DVD case and then click
Next.
6. Click Next to accept the default directory C:\Program Files\ASI DataMyte) or use the Change
button to browse to and select the desired location.
7. At the Start Copying Files screen, review the current settings displayed and verify they are
correct. If satisfied, click Next to begin the actual file installation. If you want to change any
of the settings, use the Back button to return to previous screens and make changes.
The appropriate files are copied to the computer and then an Installation Complete screen
appears.
8. Click Finish, remove the installation DVD from the DVD drive, and store it in a safe place.
The following list shows the default values of the script files:
Installation Instructions 7
DataMetrics Server Installation Guide
Building a DataMetrics database creates tables, indexes, and constraints that make up the
DataMetrics database schema.
The following list outlines the required steps for the update:
Create the database, add a login, and make the new login owner of the database
2. If possible, create the Data and Log Filegroups on separate hard disks or stripe-sets. Increase
the size of TEMPDB to 30 MB.
Create a login that will own the DataMetrics database. The default login is DATAMETRICS
with a password of DATAMETRICS.
3. Change the owner of the DataMetrics database to the login created in Step 2. The default
login is DATAMETRICS.
All of the above steps can be accomplished using either Microsoft SQL Server's Management
Studio or by executing SQL statements through the OSQL interface. Examples of SQL
statements to accomplish the above tasks are provided in the CREATEDB.SQL file.
Installation Instructions 8
DataMetrics Server Installation Guide
2. By default, the database name is DATAMTERICS. If the database name created above is
different from DATAMTERICS, replace it with the new database name.
3. If not using the default instance name, add the ‘-S’ option with the instance name to each
statement.
4. After all the information has been modified, verified, and saved, change the directory to the
directory where all the build files were copied previously.
Creates a subdirectory logs. If a logs directory exists, it deletes all old *.err and *.out files
from the logs subdirectory.
Retrieves the version number of the database and the time from the database.
Creates tables.
Creates indexes.
Installation Instructions 9
DataMetrics Server Installation Guide
For example, if you are using the DB Tools application to archive/delete large amounts of
data, then the optimization process should be executed right after the DB Tools application
has completed the delete operation. The DB Tools application provides the mechanism to
optimize the database.
NOTE: The Oracle database build procedures are intended for the Oracle database
administrator to build the DataMetrics database structure using Oracle SQL. Specific database
build procedures vary, depending on the tools used by the database administrator. This
documentation provides only general procedures.
1. Insert the installation DVD into the DVD drive. If the setup program does not automatically
start, click Run from the Start button and specify e:\launch, where 'e' is the letter of your DVD
drive.
4. Read the ASI DataMyte, Inc., Software License Agreement and, if you agree with the terms
(and warranty information), select the "I accept…" radio button and click Next.
5. Enter the DVD key Oracle exactly as it appears on the DVD case and then click Next.
6. Click Next to accept the default directory C:\Program Files\ASI DataMyte) or use the Change
button to browse to and select the desired location.
7. At the Start Copying Files screen, review the current settings displayed and verify they are
correct. If satisfied, click Next to begin the actual file installation. If you want to change any
Installation Instructions 10
DataMetrics Server Installation Guide
of the settings, use the Back button to return to previous screens and make changes.
The appropriate files are copied to the computer and then an Installation Complete screen
appears.
8. Click Finish, remove the installation DVD from the DVD drive, and store it in a safe place.
The following list shows the default values of the script files:
Building a DataMetrics database creates tables, synonyms, indexes, and constraints that make
up the DataMetrics database schema.
CAUTION: If there is an Oracle database instance already running, refer to the Oracle
documentation for information about running multiple Oracle instances before starting this
build process. If not done correctly, the existing databases could be corrupted.
The following list outlines the required steps for the update:
Installation Instructions 11
DataMetrics Server Installation Guide
Estimates for the scripts in this installation are based on one year's worth of data and a 2048
Oracle block size. Your operating system and platform may change these estimates. Space
may be more efficiently utilized using a larger Oracle block size.
50 stations collecting data twice per hour for two shifts per day
400 products, each having 15 measurable variable characteristics, 2 batch attributes and 5
piece attributes per product
1. Edit the CREATEDB_10g.SQL and DMPREP.SQL files to configure your path to the
tablespaces (i.e., substitute the desired pathname for the path placeholder in the file).
2. Create the directories for the tablespaces. Placement of the most active tablespaces
(DMDATA, DMINDEX) on separate disk drives is recommended for performance. Refer to
the Oracle manuals for more information.
Installation Instructions 12
DataMetrics Server Installation Guide
3. Modify the other parameters as needed for your environment. See the Oracle manuals for
more information.
NOTE: The number and size of the log files is set by default. Refer to the Oracle manuals for
information on how to create a more robust architecture for the log files.
sqlplus /nolog
connect sys/***** as sysdba (where ***** is the password for sys user)
startup nomount pfile=path\DATAMETRICS.ora
@path\build\createdb_10g.sql
@path\build\dmprep.sql
shutdown
exit
UNDO_MANAGEMENT=AUTO
sqlplus /nolog
connect sys/***** as sysdba (where ***** is the password for sys user)
startup pfile=path\DATAMETRICS.ora
@path\catalog.sql
@path\catproc.sql
connect system/***** (where ***** is the password for system user)
@path\pupbld.sql
connect DATAMETRICS/DATAMETRICS (where DATAMETRICS/DATAMETRICS is
the database owner name/password, created in dmprep.sql)
spool dmlog.log
@path\DMBuild.sql
@path\DM_GlobalTempTables.sql
@path\sequence_creation.sql
@path\insert.sql
@path\Oracle_update_500_to_550_0_2.sql
@path\update_550_0_1_values.sql
@path\update_WE_ALARM_550_0_1.sql
@path\Oracle_update_DAR_3_8.sql
@path\DMTriggers_Sps_ora.sql
spool off
exit
Installation Instructions 13
DataMetrics Server Installation Guide
sqlplus /nolog
Connect DATAMETRICS/DATAMETRICS
create user user name identified by user password;
grant connect to user name;
alter user user name identified by user password
default tablespace temp
default role connect;
commit;
exit
For example, if you are using the DB Tools application to archive/delete large amounts of
data, then the optimization process should be executed right after the DB Tools application
has completed the delete operation. The DB Tools application provides the mechanism to
optimize the database.
Installation Instructions 14
DataMetrics Server Installation Guide
1. Insert the installation DVD into the DVD drive. If the setup program does not automatically
start, click Run from the Start button and specify e:\launch, where 'e' is the letter of your DVD
drive.
4. Read the ASI DataMyte, Inc., Software License Agreement and, if you agree with the terms
(and warranty information), select the "I accept…" radio button and click Next.
5. Enter the DSS DVD key exactly as it appears on the DVD case and then click Next. (Note
that Windows XP users may see a dialog box warning them to perform additional procedures
to allow users to connect to the Microsoft SQL Express database.)
6. If presented with the Destination Location screen, click Next to accept the default directory
C:\Program Files\ASI DataMyte) or use the Change button to browse to and select the desired
location.
7. At the Start Copying Files screen, review the current settings displayed and verify they are
correct. If satisfied, click Next to begin the actual file installation. If you want to change any
of the settings, use the Back button to return to previous screens and make changes.
8. If you are installing the SQL Express 2008 R2 engine for the first time a message prompt
appears advising you that a reboot will be required during the installation. Click OK to this
message prompt and then, when prompted, reboot your computer.
9. When logging back in, be sure to login as the same user currently running the installation, and
do not remove the installation DVD. After the computer has been restarted, the installation
continues automatically.
10. Once the installation is completed, remove the installation DVD and store it in a safe place.
Installation Instructions 15
DataMetrics Server Installation Guide
1. Insert the installation DVD into the DVD drive. If the setup program does not automatically
start, click Run from the Start button and specify e:\launch, where 'e' is the letter of your DVD
drive.
4. Read the ASI DataMyte, Inc., Software License Agreement and, if you agree with the terms
(and warranty information), select the "I accept…" radio button and click Next.
5. Enter the DSS DVD key exactly as it appears on the DVD case and then click Next. (Note
that Windows XP users may see a dialog box warning them to perform additional procedures
to allow users to connect to the Microsoft SQL Express database.)
6. If presented with the Destination Location screen, click Next to accept the default directory
C:\Program Files\ASI DataMyte) or use the Change button to browse to and select the desired
location.
7. At the Start Copying Files screen, review the current settings displayed and verify they are
correct. If satisfied, click Next to begin the actual file installation. If you want to change any
of the settings, use the Back button to return to previous screens and make changes.
8. Open Windows Explorer and browse to the DSS directory. The default path is C:\Program
Files\ASI DataMyte\DBCK\DataMetrics_MSSQL\DSS.
11. Attach the database files to the SQL Server database engine.
12. If the default database name and logon user name/password are not used when attaching the
Security database, make a note of these items as you will need this information when the
Security Service is installed. Defaults are noted below:
13. Once the database files are copied and attached to the SQL Server database engine remove the
installation DVD and store it in a safe place.
Installation Instructions 16
DataMetrics Server Installation Guide
NOTE: The installation steps below are applicable whether the Security Service is installed
on the same PC that is running the Security database or the service is installed on a remote
PC.
1. Insert the installation DVD into the DVD drive. If the setup program does not automatically
start, click Run from the Start button and specify e:\launch, where 'e' is the letter of your DVD
drive.
4. Read the ASI DataMyte, Inc., Software License Agreement and, if you agree with the terms
(and warranty information), select the "I accept…" radio button and click Next.
5. Click the Next button to accept the default Destination Location (i.e. C:\Program Files\ASI
DataMyte) or click the Change button to specify a different directory.
6. Select the Security Database Server. You can use either the default of ‘localhost’ or specify a
custom server name.
Select localhost when the Security Service is installed on the same PC / Server as the
Security database. When localhost is selected, you may skip to Step 8.
Select custom when the Security Service is installed on a PC that is remote from the
Security database. When custom is selected, continue to Step 7.
7. Verify that the Security database Server Name and user name and password information is
correct. Make changes as needed to match the database name and login user name and
password for the Security database.
8. A series of Security Policy screens will appear. Fill in the requested information at each.
10. A message prompt stating "Installation Setup Complete" appears when the installation has
been finished. Click Finish to complete the installation.
11. If not using the default instance, two configuration files will need to be edited. Please contact
ASI DataMyte Technical Support for instructions.
Installation Instructions 17
DataMetrics Server Installation Guide
Please see the Licensing Installation Guide, accessible from the Documentation menu of the
Installation DVD, for complete information on installing the Licensing component.
Installation Instructions 18
Upgrading a Previous Quantum
or Applied Stats Installation
If you are upgrading a previous installation of Quantum or Applied Stats, there are one or two
additional steps you still need to perform.
If you are upgrading a Quantum installation, you will need to migrate your database to the
DataMetrics version using the Database Migration Tool (DMT).
If you are upgrading an Applied Stats installation, you will need to migrate your database
using DMT and then also migrate your existing Applied Stats .app files into the database
using the File Migration tool (FMT).
Please refer to the Quantum & Applied Stats Migration Guide, accessible from the
Documentation menu of the Installation DVD, for complete information on using both of
these tools.
Installation Instructions 19
Support Information
This section contains information on ASI DataMyte maintenance agreements and technical
support.
Technical Support
ASI DataMyte Technical Support experts are only a phone call away. Contact Technical
Support for the following reasons:
Fax: 763-553-1041
Fax your questions to ASI DataMyte Technical Support at any time. Please include in the
email your name, phone number, the hours you can be reached, and a detailed description
of the problem.
Email: techsupport@asidatamyte.com
Email your questions to ASI DataMyte Technical Support at any time.
Place orders
Installation Instructions 20
DataMetrics Server Installation Guide
Toll free number for Technical Support and Customer Service, which automatically
prioritizes your call
Free calibration service with certificate, starting the day after we receive the ASI
DataMyte Data Collectors (exception: consult ASI DataMyte for Torque Wrenches, a
NON-ASI DataMyte product)
Repair turnaround is three-days, starting the day after we receive the product (exceptions:
multiple Data Collectors of five or more and Torque Wrenches - consult ASI DataMyte for
turnaround time)
Free loaner data collectors if needed during repairs (5xx, 9xx, 3xxx only), subject to
availability
If you have already purchased an SMA contract for this product, this warranty is extended for
the duration expressed in the contract. Please call 763-553-1040 for more information about
ASI DataMyte SMA contracts.
Installation Instructions 21