                     TrendTrak Installation Instructions 
                   for Windows NT & Windows 95 Workstations
                              v4.1 30 September 1997 
 
 
Table of Contents 
----------------- 
 
1. SETUP AND INSTALLATION 
 1.1 Overview of Programs 

2. WORKSTATION SETUP 
 2.1 Workstation Options 
  2.1.1 File Location 
  2.1.2 Tutorial Data
  2.1.3 Program Folder Selection 
 2.2 Un-Installing a Workstation

3. FILE SERVER SETUP

4. FILES INSTALLED BY TRENDTRAK 

5. STARTING DATA COLLECTION (File Server)

6. BEGINNING A TRENDTRAK SESSION (Workstation)
 6.1 Automatic Printing and Data Export 
  6.1.1 Printing 
  6.1.2 Exporting 
  6.1.3 Print and Export File 
  6.1.4 TTWAUTO Log File 
 6.2 Using Directory Selection 
  6.2.1 Directory Structure 
 6.3 TRNDTRAK.INI File 
  6.3.1 Ignore Option 

 
1. SETUP and INSTALLATION 
   ---------------------- 
 
The Installation software is shipped on two or three diskettes, 
one for the Workstation, one for NetWare File Servers and one 
for Windows NT File Servers. 
 
You may want to copy the TrendTrak Program diskettes to backup  
diskettes. You can copy the TrendTrak program disks for your own  
use, but be aware that the TrendTrak license prohibits making more  
than one backup copy. 
 
 
1.1 Overview of Programs 
    -------------------- 
 
The NT file server portion of TrendTrak contains two components. 
The components are:  
 
A program (NTTMAINT.EXE) to determine which statistics to collect. 
Each statistic is comprised of an Object, Counter, and in some cases, 
an Instance. This program is installed on the server by the File Server 
portion of the installation procedure. The program when run creates a 
file called TRAKDATA.DAT, which contains the list of statistics to be 
collected. Statistics can be added to or removed from the list. 
Additionally, NTTMAINT is automatically launched by the setup process 
so that you can create the TRAKDATA.DAT file by selecting the 'OK'
key from the NTTMAINT program.
 
A program (NTTRAKIT.EXE) to collect and archive the statistics. 
This program is installed on the server by the File Server portion of 
the installation procedure. The program when run collects the 
statistics defined in the TRAKDATA.DAT file. The statistics are 
collected and placed in a daily file on the server. At midnight, the 
daily file is assimilated into a monthly file. Each time the list of 
statistics is changed,  NTTRAKIT must be terminated and then re-
executed to reflect the changes made to the TRAKDATA.DAT file. 

The NetWare file server portion of TrendTrak contains two components. 
The components are:  
 
The workstation portion of TrendTrak contains one component. 
The component is:  

A program (TRNDTRAK.EXE) to retrieve and view graphs of the 
collected statistics. This program is installed by the Workstation 
portion of the installation procedure. The program can reside on any 
Windows 32bit operating system, excluding win32s. TRNDTRAK 
displays graphs using  the combined information contained in the 
monthly files described above and the TRAKDATA.DAT file. The 
length of a display can vary from an hour up to one year with 
numerous line selections including peak, average, baselines and trend 
lines. 
 
 
2. WORKSTATION SETUP 
   ----------------- 
 
Start Windows. Use the TrendTrak Workstation program diskette,  
insert the diskette in drive A or drive B. If you are installing  
TrendTrak from a network file server or a directory on a local  
hard drive, connect to that server or directory. 
 
From the Windows Program Manager, choose Run from the File menu  
(or Start then Run (Windows 95 or NT 4.0). In the Command Line box, 
type a:setup if you  put the installation disk in drive A or b:setup if 
you put the Program disk in drive B. If you are installing TrendTrak 
from a network file server or a directory, type the full path plus setup.  
 
Click NEXT to continue. 

 
2.1 Workstation Options 
    ------------------- 
 
2.1.1 File Location 
      ------------- 
 
You will need to supply the path to the directory where you want  
to install the workstation software, the default is  
C:\Program Files\Intrak\Trndtrak. See the list below for workstation 
files that are copied to the workstation directory.  
 
Click NEXT to continue 


2.1.2 Tutorial Data
      -------------

The tutorial creates the data files used in the User Tutorial.
An on-line Tutorial is provided and the option to run the Tutorial 
will be presented the first time TrendTrak is run. You can also run 
the Tutorial at any time by selecting "User Tutorial" from the TrendTrak 
Help menu. 

To install the tutorial data, click on the box marked Generate 
Tutorial Data. The tutorial data is placed in the .\TUTORIAL directory. 
The .\TUTORIAL directory is appended to the directory in which the 
workstation software was placed. The default would be 
c:\INTRAK\TRNDTRAK\Tutorial. 

The minimum is three months and the maximum is twelve months. The 
tutorial only references three months of data. If you wish, use the 
additional months of data to explore the longer term trend analysis 
capabilities of TrendTrak.

When you are finished running the tutorial, the tutorial data files 
(TW90xx.TPF) in  the .\TUTORIAL directory.

Click NEXT to continue.

 
2.1.3 Program Folder Selection 
      ------------------------ 

Setup will add program icons to the Program Folder (or Program  
Group icon). You can type a new folder name or select one from the  
existing Folders list. The default is INTRAK. 
 
Select the Program Folder 
 
Click NEXT to continue. 

 
The workstation installation process is now complete. The workstation  
files are copied to the selected directory. 

Note: If this is a first time install, data collected by the File Server 
software will not be available for display until the following day. You
will also need to tell the workstation software where the file server data
is located (Configuration menu, Edit Server Pick List), this requires a 
drive mapping to the volume containing the captured data.

2.2 Un-installing a Workstation 
    --------------------------- 
 
The Workstation Installation process installs a Workstation Un-install 
icon (NT 3.51) along with other TrendTrak icons. Select the Workstation 
Un-install icon (NT 3.51) or the 'TrendTrak Workstation' item in the 
Add/Remove Programs in the Control Panel (Win 95, NT 4.0), this will 
remove the program items, program group (if empty), program files and 
registry entries. Data files created by TrendTrak (daily capture, 
monthly, logs, etc.) will need to be removed by hand. 


3. FILE SERVER SETUP 
   -----------------

Please refer to the Install.txt file located on the NetWare or
Windows NT File Server installation diskettes.
 

4. FILES INSTALLED BY TRENDTRAK 
   ---------------------------- 
 
   Server 
	NT File Server Directory (c:\intrak\trndtrak (default)) 
		NTTRAKIT.EXE (data collector, program)
		NTTMAINT.EXE (maintenance program)
		NTTMAINT.HLP 
                NTTSERVI.EXE (data collector, service) 
                DRINSTNT.EXE (data repository install)
                DRINSTNT.HLP

        NetWare File Server Directory (sys:system)
                TRAKIT.NLM
                TWINTRAK.NLM
                TRAKITIO.NLM (SFT III verson only)
 
	C:\INTRAK\TRNDTRAK or user defined directory. 
		YYYYMMDD.TDF - daily capture files (NT)
		YYYYMM.TMF - monthly processed files (NT)
		TRAKDATA.DAT - description of statistics (NT)
                YYYYNNDD.CAP - Daily capture files (NetWare)
                YYYYMM.TPF - monthly processed files (NetWare)

   Workstation 
	Application Directory 
		TRNDTRAK.EXE 
		TRNDTRAK.HLP 
                DRINSTNW.EXE (data repository install)
                DRINSTNW.HLP
 
 
5. STARTING DATA COLLECTION (File Server)
   ------------------------

Please refer to the Install.txt file located on the NetWare or
Windows NT File Server installation diskettes.

 
6. BEGINNING A TRENDTRAK SESSION (Workstation)
   ----------------------------- 
 
After you run the Workstation Setup, you will see a program group 
in the Windows Program Manager called INTRAK (default). The 
INTRAK program group includes icons for the components you installed. 
 
First time users:  Once TrendTrak is loaded, try the user Tutorial  
or refer to Help, Getting Started for a quick overview of  
generating your first graphs( Tutorial is currently only available with 
the Novell version). Normally, you start TrendTrak from within 
Windows by double-clicking the TrendTrak icon in the INTRAK program 
group. If you want to start TrendTrak each time you start Windows, you 
can include the TrendTrak icon in the Startup program group in Program 
Manager. For more information about starting programs from within 
Windows, see your Windows documentation. 
 
When TrendTrak is started, it looks for a file called TRNDTRAK.INI 
in the Windows directory.  This file contains all of the information 
pertaining to the location of the file server's data. 
 
Note: If this is a first time install, data collected by the File Server 
software will not be available for display until the following day. You
will also need to tell the workstation software where the file server data
is located (Configuration menu, Edit Server Pick List), this requires a 
drive mapping to the volume containing the captured data.

 
6.1 Automatic Printing and Data export 
    ---------------------------------- 
 
TrendTrak provides capabilities for loading a specific  
configuration file, and for automatic printing and data exporting.  
Automatic mode is activated by specifying the /P or /E parameters  
when executing the workstation portion of TrendTrak. The automatic 
mode when combined with a scheduler can be used to start the 
application, process capture files and print graphs or export statistical 
data. At the completion of the automatic mode, the program will exit. 
The options are not case sensitive. The specific configuration file 
and automatic mode command is described below. 
 
Example: 
  TRNDTRAK [configuration file] [/Pprint file] [/Eexport file] 
 
  [configuration file]  
  The configuration file is created using the File Save or Save  
  As option. If a configuration file name is not specified, the  
  configuration file specified within the TRNDTRAK.INI file will  
  be used. A path can accompany the configuration file name. If  
  no path is specified, the current working directory will be  
  used. If no configuration file can be found or the configuration  
  file is invalid, the program will exit. 
 
Example: 
  TRNDTRAK intrak.cfg 
  TRNDTRAK c:\intrak\testfile.cfg 
 
 
6.1.1 Printing 
      -------- 
 
  [/Pprint file]  
  The automatic print option will cause the selected list of  
  statistics, for the times selected, to print to the default  
  printer or print file in the default print format. If a print  
  file name is not specified, the graphs will be printed to the  
  default printer. A path can accompany the print file name. If  
  no path is specified, the file will be placed in the current  
  working directory. 
 
Example:  
  TRNDTRAK /p 
  TRNDTRAK intrak.cfg /p 
  TRNDTRAK c:\intrak\testfile.cfg /Pprint1.prn 
  TRNDTRAK intrak.cfg /pc:\intrak\export1.txt 
 
 
6.1.2 Exporting 
      --------- 
 
  [/Eexport file]  
  The automatic data export option will cause the selected list  
  of statistics, for the times selected, to be exported to a comma  
  delimited file. If a export file name is not specified, the file  
  name TTEXPORT.TXT is be used. A path can accompany the 
  export file name. If no path is specified, the file is placed 
  in the current working directory.  
 
Example:  
  TRNDTRAK /e 
  TRNDTRAK intrak.cfg /e 
  TRNDTRAK c:\intrak\testfile.cfg /Eexport.txt 
  TRNDTRAK intrak.cfg /ec:\intrak\export1.txt 
 
 
6.1.3 Print and Export File 
      --------------------- 
 
The automatic mode will provide both print and export output with  
a single request. The configuration file is common to both requests.  
 
Example: 
  TRNDTRAK /e /p 
  TRNDTRAK intrak.cfg /e /p 
  TRNDTRAK c:\intrak\testfile.cfg /Eexport.txt/Pprint1.prn 
  TRNDTRAK intrak.cfg /ec:\intrak\export1.txt /pc:\intrak\export1.txt 
 
 
6.1.4 TTWAUTO Log File 
      ---------------- 
 
Automatic milestones are captured in the TTWAUTO.LOG file. The 
log file is placed in the current working directory. In the event of 
multiple runs, the milestones are appended to the existing  
TTWAUTO.LOG file. Milestones include: time stamp at the 
beginning of the request, description of the request, errors, if 
any, and a time stamp at the end of the request. 
 
Example: 
  4/9/96 2:30:00 Start Automatic mode 
  Configuration file = C:\intrak\testfile.cfg 
  Print request, print file = c:\intrak\print1.prn 
  4/9/96 2:37:22 End Automatic mode 
  4/9/96 2:51:10 Start Automatic mode 
  Configuration file = C:\intrak\testfile.cfg 
  Export request, Export file = c:\intrak\export1.txt 
  4/9/96 2:57:22 End Automatic mode 
 
 
6.2 Using Directory Selection  
    ------------------------- 
 
TrendTrak allows processed files to be downloaded (moved) to a user 
defined directory structure. This allows data from multiple file  
servers to be off loaded to a remote workstation and then processed  
at your convenience.  This is a big time saver when processing  
data over telephone lines; users have reported time reductions  
from 4 hours to 20 minutes. 
 
This is a manual process that can be automated by using the Data  
Repository (Novell only at this time). The Data Repository method 
requires the recipient to be a server. Directory Selection allows 
both workstation and server as recipients. See the Data Repository 
chapter for details. 
 
 
6.2.1 Directory Structure  
      ------------------- 
 
A possible directory structure is shown as follows: 
 
  INTRAK 
    TRNDTRAK 
      SERVER_1 
      SERVER_2 
      SERVER_3 
         . 
         . 
         . 
      SERVER_n 
 
It is the users responsibility to place the processed files   
(yyyymm.TMF) and the TRAKDATA.DAT file into the proper 
directory. Using the example above, the .TMF files and TRAKDATA.DAT
are copied to the ./INTRAK/TRNDTRAK/SERVER_1 directory. Additionally, 
the configuration files .CFG can be copied but are not required unless 
you use previously saved configuration files. Following the copy, 
the directory would appear as follows: 
 
  INTRAK 
    TRNDTRAK 
      SERVER_1 
        yyyymm.TMF 
        trakdata.dat
      SERVER_2 
      SERVER_3 
         . 
         . 
         . 
      SERVER_n 
 
Note: If server data is moved, the path for the modified server  
in the TRNDTRAK.INI file will need to be updated with the new  
location of the data.  This can be accomplished by editing the  
TRNDTRAK.INI file with any compatible editor or using 
Configuration, Edit ServerList Edit. 
 
 
6.3 TRNDTRAK.INI File 
    ----------------- 
 
The TRNDTRAK.INI file contains information about all servers that 
have been defined to TrendTrak and for Novell servers, is used to 
associate the NIC address and volume names to a symbolic name. This 
capability is extremely handy when referencing a NIC address to a 
network name.  
 
The TRNDTRAK.INI file is be created by the Workstation software 
program (TrendTrak) and will contain the server name and location. 
The file is placed in the user's Windows directory. The workstation 
software will update the TRNDTRAK.INI file with server information when
servers are added or removed using the Configuration menu, Edit
Server Pick List item. 
 
Each server has a [serverx] entry in the INI file. The 'x'  in the  
[serverx] header is a sequential number starting with '1'. Any  
breaks in the number sequence will cause the servers with numbers  
greater than the break number to not be displayed in the Edit  
Server List. 
 
Each [serverx] header contains multiple definition lines. The  
lines include: server=(server name), Path=(server data), NIC names 
and Volume names. 
 
The following is the server name format: 
 
  server=(server name) 
 
  Example: 
    server=Tutorial 
 
The following is the Path format: 
 
  Path=<<drive:\directory>> 
 
  Example: 
    Path=c:\TRNDTRAK\TUTORIAL 
 
The following is the NIC definitions format: (Novell Server only)
 
  <<NIC address>> = <<symbolic name>> 
 
  symbolic name=maximum of 15 characters 
 
  Example: 
    00409505037D = NW100   (see also Ignore option described below) 
 
 
6.3.1 Ignore Option (Netware Servers only)
      ------------- 
 
You can now specify the Ignore value in the symbolic name area for  
both NICs and Volumes in the TRNDTRAK.INI file. Specifying   
'Ignore' removes the NIC or Volume from that server's Statistic  
Pick List. This is extremely handy for volumes, NICs and CD-ROM  
volumes that are no longer active. 
 
  Example: 
    SYS=SYS 
    TESTVOL=IGNORE 
    CDVOL=IGNORE 
 
The following is the Volume DEFINITION format: 
 
  <<long name>> = <<short name>> 
  short name = maximum of 15 characters 
 
  Example: 
    SYS=SYS 
    TRNDTRAK=TWINT 
    PROJA=PROJA  (see also Ignore option described below) 
 
The [options] header contains non server specific definitions. They  
include configuration file location and Tutorial options. The  
configuration definition describes the location and file name of  
the last saved configuration file. 
 
The following is the configuration format: 
 
  Config=<<drive:\directory>> 
 
  Example: 
    Config=F:\PCLINKED\FRANK\WIN\2SERVERS.CFG 
 
The Tutorial definition defines whether the Tutorial HELP facility  
will be displayed when the workstation software is started. A  
'True' status will cause the Tutorial HELP facility to be displayed.  
The status is set to 'False' once the workstation software is loaded. 
 
The following is the Tutorial format: 
 
  Tutorial=<<True or False>> 
 
 
