                     TrendTrak Installation Instructions 
                            for Windows NT Server
                              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.2.3 Program Folder Selection 
 2.2 Un-Installing a Workstation

3. FILE SERVER SETUP
 3.1 Server Options 
  3.1.1 Server Configuration Parameters
  3.1.2 Program Location 
  3.1.3 Program Folder Selection 
 3.2 Installing Additional File Servers 
 3.3 Un-installing a File Server 

4. FILES INSTALLED BY TRENDTRAK 

5. STARTING DATA COLLECTION (File Server)
 5.1 Using the Program
 5.2 Using the Service

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 

7. DATA FILES 
 7.1 Daily & Monthly File Sizes
 7.2 Capture File Errors 
 7.3 Backup Considerations 
 
 
1. SETUP and INSTALLATION 
   ---------------------- 
 
Note: File server installation must be performed from a Windows 
NT server console. 
 
The Installation software is shipped on two diskettes, one for the 
Workstation software and one for the File Server software. 
 
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 portion of TrendTrak contains three 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. 
 
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 
   -----------------

IMPORTANT! The installation process requires that any server being 
installed must be performed from the server's console.  

Start Windows. Use the TrendTrak NT File Server 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 (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.  

 
3.1 Server Options 
    -------------- 

3.1.1 Server Configuration Parameters
      -------------------------------

File Server Installation requires a Serial Number, Collection Path and 
Retention Days.  The entered values are placed in the Registry as 
values in the subkey defined below. The programs NTTRAKIT and 
NTTMAINT reference these values. 
 
The Serial Number is provided with the product and is located on the 
back of the diskette. Evaluation and beta serial numbers are available 
by contacting Intrak or one of its agents.  
 
The Collection Path is the location on the server that the collected 
statistical data is to reside. The default path is 'c:\intrak\trndtrak'. 
For the beta, this field is not editable. 
 
The Retention Days value defines the number of days to retain the 
daily capture files for aging purposes, the default is 5. 
 
The daily capture files occupy approximately 200 Kbytes of disk space 
per day.  The number of retained capture files can be controlled and is 
defined at server installation time.  The Retention Days value can be 
changed at any time with the most current capture file representing the 
length in days to retain.  Valid values are 0 through 999. 0 is 
interpreted as unlimited. The capture files are processed by 
NTTRAKIT at midnight.  The latest (most current date) capture file's 
retention value is used to determine the number of capture files to 
retain in the Processed subdirectory.  See Capture Files described 
below for more information. 
 
The location of the capture file directory is placed in the  
TRNDTRAK.INI file (not in the beta, see Edit Server List in the 
TrendTrak Help). The volume name is converted to its associated 
drive mapping and placed in the PATH= statement.  See PATH format 
described in the TRNDTRAK.INI section later in this chapter. See also 
'Using the Directory Selection' later in this chapter and 'Edit Server 
List' in the Menus chapter. The install process places the 
TRNDTRAK.INI file in the Windows directory and contains the file 
information about the servers that are available for viewing. 
 
Click the NEXT button to conclude  
the server installation. 


3.1.2 Program Location 
      ---------------- 
 
You will need to supply the path to the directory where you want  
to install the file server software, the default is C:\Program Files\
Intrak\Trndtrak. See the list below for file server files that are 
copied to the file server directory.  
 
Click NEXT to continue 
 
 
3.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.

This concludes the installation process. At this time the NTTMAINT
program is automatically launched. If TrendTrak has not been previously
installed, NTTMAINT selects a default set of statistics (Objects, Counters
and Instances) from the list of available statistics. If you do not
want to modify this list, select 'OK'. If TrendTrak was previously installed
the current list of selected statistics is presented. If you do not want to 
modify this list, select 'OK'.

Note: If NTTMaint is not exited normally, the file that tells what
statistics to collect is not created and the data collection program
(NTTrakit) will not start.

To start collecting data, see STARTING DATA COLLECTION section
described below.
 
Click Finish to exit. 


3.2 Installing Additional File Servers
    ----------------------------------
 
If you have additional servers to install, repeat the Server 
Installation procedure described above. 
 

3.3 Un-installing a File Server 
    --------------------------- 
 
The Server Installation process installs a File Server Un-install icon 
(NT 3.51) along with other TrendTrak icons. Select the File Server 
Un-install icon (NT 3.51) or the 'TrendTrak File Server' item in the 
Add/Remove Programs in the Control Panel (Win 95), 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. 
 

4. FILES INSTALLED BY TRENDTRAK 
   ---------------------------- 
 
   Server 
	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

 
	C:\INTRAK\TRNDTRAK or user defined directory. 
		YYYYMMDD.TDF - daily capture files 
		YYYYMM.TMF - monthly processed files 
		TRAKDATA.DAT - description of statistics
 
   Workstation 
	Application Directory 
		TRNDTRAK.EXE 
		TRNDTRAK.HLP 

 
 
5. STARTING DATA COLLECTION (File Server)
   ------------------------

5.1 Using the Program
    -----------------
 
After you run the File Server 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. 
Double click on the NTTrakit icon to start data collection. If an error 
message is displayed stating that the TRAKDATA.DAT file could not be 
found, run the NTTMaint program to create the file, then run NTTrakit. 

If you want to start the data collector (NTTrakit) each time you start 
Windows NT server, you can include the NTTrakit icon in the Startup 
program group. For more information about starting programs from within 
Windows, see your Windows documentation. 

5.2 Using the TrendTrak Service
    ---------------------------

Data collection can also be accomplished by using the TrendTrak service. 
This service is automatically installed and is set to be started in the 
'Manual' mode. The TrendTrak service will not run if NTTrakit is running 
(program collection method). To start the TrendTrak service, simply 
select the TrendTrak service in the Control Panel | Services window and 
click on the Start button. Any error messages are placed in the 
process.log file located in the TrendTrak directory. Also, the Windows 
NT Event Log contains major events pertaining to the service such as 
Starting and stopping.

The TrendTrak service startup options can be configured to automatically 
load the service when the service is booted. Note also that if you are 
going to use the service along with the Data Repository, you need to 
set up the 'This account' information under the 'Log on as' topic. This 
is required because the TrendTrak service needs the proper rights to 
connect to the registry of the Data Repository server, create a 
subdirectory if necessary and copy files to the subdirectory. For more 
information on the use of the Data Repository, refer to the Data 
Repository chapter.

Note: 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. 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. 
 
 
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>> 
 
 
7. DATA FILES 
   ----------  
 
7.1 Daily & Monthly File Sizes
    --------------------------

The daily capture file size is variable and depends on the number  
of  statistics (Objects, Counters and Instances) selected for capture.  
Using the default set of statistics on a server with 2 processors, 2 
physical disks, 2 logical disks and 1 network card generates a daily 
capture file of approximately 180 Kbytes per day. The yearly disk  
space requirement would be around 64 Mbytes. Due to size constraints 
the number of daily capture files can be limited by setting the 
'Retention days' value, described previously in the File Server 
installation procedure. 

 
7.2 Capture File Errors 
    ------------------- 
 
TrendTrak will log errors encountered during the combining process  
to the PROCESS.LOG file located in the daily capture file directory.  
The capture file(s) containing the errors are moved to the PROBLEMS 
subdirectory. 
 
NTTRAKIT for Windows NT or TRNDTRAK.NLM will skip a period  
record write and continue capturing statistics for the next period if a  
file error condition exists preventing the opening and writing of the  
period record. An error message is displayed on the file server console  
containing the error condition, date and time. The missed period will  
appear as zeros when processed by the workstation portion of  
TrendTrak. The statistical values from missed periods will not be  
included in the analysis calculations. 
 
 
7.3 Backup Considerations 
    --------------------- 
 
As discussed previously, the daily capture files are moved following  
the process of combining into a monthly file. You may wish to  
backup the capture files following the combining process. 
 
The daily file that is currently referenced by the file server software is 
opened, written to and then closed 'on a 15 minute' basis. Backup software  
that verifies the length and contents of a file will incur an  
error if  the process of backup and verify spans the 'on a 15  
minute' time span. We recommend that the daily files in the daily  
capture file directory be eliminated from the normal backup  
procedures to avoid possible error conditions. 
 
Daily Capture files are temporary files and are processed  
automatically by the File Server software at approximately midnight. 
 
 
