Trillium Software System™

Series 7

Installation Guide
This manual, as well as the software described in it, are furnished under
license and may be used only in accordance with the terms of such license.
The content of this manual is furnished for informational purposes only, is
subject to change without notice, and should not be construed as a
commitment by Trillium Software. Trillium Software assumes no
responsibility or liability for any errors or inaccuracies that may appear in
this manual.

The customer shall not disclose, copy, reproduce, distribute, or display any
portion of the Trillium Software System or this manual in any form to any
third person without the prior written consent of Trillium Software, nor allow
third parties to do the same. The customer shall keep the Trillium Software
System and all confidential information in the strictest confidence.

Trillium Software System Installation Guide

53017

Trillium Software, Inc. owns all rights in and to the marks "TRILLIUM
SOFTWARE" and "TRILLIUM SOFTWARE SYSTEM," which marks are
registered in various countries throughout the world (including, without
limitation, the United States Patent and Trademark Office).

All other trademarks are the property of their respective owners.

© 2008-2017 Trillium Software, Inc.

 Table of Contents

Trillium Software System® Installation Guide

CHAPTER 1 Installation Overview .......................... 1-1

Supported Platforms ............................................ 1-1

Minimum System Requirements ........................... 1-2
Uninstalling Trillium Software System .................. 1-3
Customer Support ................................................ 1-3

CHAPTER 2 Installing Trillium Software System on

Windows ..................................................... 2-1
Installation Package ............................................. 2-1
Installing the Server Software .............................. 2-3
Installing the Client Software ............................... 2-4
Installing Country Template Projects .................... 2-5
Setting the Environment Path .............................. 2-7
Starting the Server .............................................. 2-8
Automatically Starting the Server ...................... 2-9
Starting the Control Center Client .......................2-12

CHAPTER 3 Installing the Trillium Software

System on UNIX .................................... 3-1
Installation Package ............................................. 3-1
Installing the Server Software .............................. 3-3
Installing Country Template Projects .................... 3-4
Verification......................................................... 3-7
Setting System Paths ........................................... 3-7
C-shell ............................................................... 3-8
Korn Shell .......................................................... 3-8
Starting the Server .............................................. 3-9
Automatically Starting the Server .....................3-10

Trillium Software System™ Installation Guide iii

Table of Contents

CHAPTER 4 Installing Trillium Software System on

IBM Mainframe ....................................... 4-1
Installation Package ............................................. 4-1
Installing Trillium Software System ...................... 4-3
Directory Structure .............................................. 4-5
Installing Country Template Projects .................... 4-7
Directory Structure .............................................. 4-8
Installing the Rich Country Bundle ....................... 4-9
Installing the Lite Country Bundle .......................4-12

CHAPTER 5 Installing Trillium Software System on

CICS ............................................................. 5-1
Installing Trillium Software System ...................... 5-1
Directory Structure .............................................. 5-4

iv Trillium Software System™ Installation Guide

 Supported Platforms 1-1

CHAPTER 1 Installation Overview

This manual provides the requirements and instructions for installing Trillium
Software System™ Series 7 and country template projects.

See Postal Table Installation Guide for instructions for installing

the postal, census and/or USPS product directory files.

Supported Platforms
Trillium Software System Series 7 runs on the following platforms:
• AIX (32-bit) Versions 6.1 and 7.1
• Linux:
• Red Hat Enterprise v4 through v6
• Suse v11.4 and above
• Solaris: v10
• Windows:
• Windows 7
• Windows 8.1
• Windows Server 2008

Installation Overview
1-2 Minimum System Requirements

• Windows Server 2012

• IBM Mainframe (z/OS 2.1)
• CICS 5.1 and CICS 6.1

AS/400 is no longer supported.

Trillium Software System Series 7 for UNIX and Windows production licenses
are delivered as two pieces as a Server Installation and Client Installation.

The Client section of the software is only available for Windows systems.

Minimum System Requirements

The following table shows the minimum system requirements for running the
Trillium Software System:

Minimum System Requirements

Client Software • 90 MB free space on the hard drive

• 256 Megabytes of RAM

• 800 MHz processor

Windows Server • 110 MB free space for server software

Software
• Several hundred megabytes to several gigabytes for postal direc-
tories (dependent upon which countries are purchased)

UNIX Server • 160 MB free space for server software

Software
• Several hundred megabytes to several gigabytes for postal direc-
tories (dependent upon which countries are purchased)

Notes for Windows Server 2008

Windows Server 2008 requires the following redistributable to be installed for
32-bit (x86):

Trillium Software System™ Installation Guide

 Java 1-3

Visual C++ Redistributable Packages for Visual Studio 2013.

Download from: [Link]
[Link]?id=40784
Microsoft .NET Framework 4.5.2 Developer Pack.
Download from: [Link]
[Link]?id=42643

Java
Java is no longer installed with the software. If you use the Control Center,
Java 1.8 32-bit is required. Before you install Trillium Software System, you
must install Java/JRE 1.8. For a Solaris Sun system, you must install Java/JRE
1.7 as Java 1.8 32-bit is unavailable.

Install Java to the default install location on your client system. On Windows,
the location is C:\Program Files (x86)\Java. Restart your system after
installation. Set the JRE_HOME environment variable to point to the default
Java installation.

Uninstalling Trillium Software System

To uninstall Trillium Software System on Windows, go to the Add/Remove
Programs list and remove the software from there.

In UNIX, there is no uninstallation process.

Customer Support
Customer Support is available Monday through Friday, 24 hours a day, to help
you with any questions you may have about Trillium Software System. This
service is available to all customers who have active maintenance plans.
E-mail: techsupport@[Link]
Telephone: 978-901-0000 (Worldwide Headquarters)
+44 (0) 118 940 7676 (European Headquarters)

Installation Overview
 Installation Package 2-1

CHAPTER 2 Installing Trillium Software

System on Windows

This chapter explains how to install Trillium Software System and the
country template projects on a Windows system.

Installation Package
The installation package for Windows are delivered through TSS Download
Center (File Portal) FTP [Link] installation package for Windows consists
of the following components:

Ensure that these components are installed in the specified order.

• Trillium Software System Server for Windows. The Server software

for Windows should be located on the server machine that supports the cli-
ent machines accessed by your users. The server is usually a different
machine than the client, but server programs may be installed in either
location.
• Trillium Software System Client for Windows. The Client software for
Windows should be located on the client machine that connects to the
server machine, where the Trillium Software Server software has been
installed. The client machine must be capable of file system access of the

Trillium Software System™ Installation Guide

2-2 Installation Package

server file system where the Trillium Software Server is located. This is
accomplished by "mapping" the server drive to the client machine.
• Country Project Template Projects (US, CA, AU, etc.). Template proj-
ects contain business rules which are specific for each country. These rules
govern the matching, parsing and (optional) geocoding processes. All files,
tables and DDLs for specific country projects are included. When a project
is created for this country, resources are copied into the new project fold-
ers.
• Postal and/or census directories for the countries purchased (US,
CA, AU, etc.). These directories contain all postal data for the specified
country, and are used by the postal and census geocoding processes.

See Postal Table Installation Guide for instructions for

installing the postal and/or census directory files.

• Product Directories. These directories contain various USPS product

directories such as Locatable Address Conversion System (LACSLink). and
Delivery Point Validation (DPV).

See Postal Table Installation Guide for instructions for

installing the USPS product directory files.

Trillium Software System™ Installation Guide

 Installing the Server Software 2-3

Installing the Server Software

Be sure to install the server on a machine that supports the client machines
accessed by your users.

X To install the Server software

1. If you have not yet done so, download the software installation package
from TSS Download Center (File Portal) FTP site.

2. Unzip the Windows_7vnn_Server.zip file, where nn is the version

number.

3. Double-click the setup file ([Link]) to begin the installation. The

InstallShield Wizard gathers the required information and displays the
welcome message.

4. Click [Link] License window opens.

5. Read the license agreement. Click Yes to accept the terms in the license
agreement option. The Choose Destination Location Window appears.

6. Select a location for the installation. (The default drive is c:\tril7Vnn,

where nn is the version number).

Choose the recommended target location by clicking Next.

Click on Browse and enter or select another install location. After
you have selected where you would like the software to be installed,
click Next.

All components of the server software are installed in the location you
specified.

After the Server software install is finished, install the Trillium Software
System Client for Windows. See the next section for details.

Trillium Software System™ Installation Guide

2-4 Installing the Client Software

Installing the Client Software

Be sure to install the client software on a machine that connects to the server
where the Trillium Software Server software has been installed. The client
machine must be capable of file system access of the server file system where
the Trillium Software Server is located. This is accomplished by “mapping” the
server drive to the client machine.

Multiple client machines can access the same Trillium Software

System Server.

See the Control Center manual (Chapter 7) for details on mapping drives from
the Server to the Client.

X To install the client software

1. If you have not yet done so, download the software installation package
from TSS Download Center (File Portal) FTP site.

2. Unzip the Client_7vnn_WIN.zip file, where nn is the version number.

3. Double-click the setup file ([Link]) to begin the installation. The

InstallShield Wizard gathers the required information and displays the
welcome message.

4. Click [Link] License window opens.

5. Read the license agreement. Click Yes to accept the terms in the license
agreement option. The Choose Destination Location Window appears.

6. Select a location for the installation. (The default drive and path for the
client installation is c:\tril7Vnn, where nn is the version number.)

Choose the recommended target location by clicking Next.

Click on Browse and enter or select another install location. After
you have selected where you would like the software to be installed,
click Next.

7. After you have chosen the location of where you would like the software
to be installed, click Next.

8. All components of the client are installed in your specified location.

Trillium Software System™ Installation Guide

 Installing Country Template Projects 2-5

After the Client installation for Windows is finished, you may install the Country
Template Project(s). See the next section for details.

Installing Country Template Projects

X To install the Country Template projects

1. If you have not yet done so, download the software installation package
from TSS Download Center (File Portal) FTP site.

2. Double-click [Link], where nn is the version number.

The installation program starts.

3. When the Welcome to the InstallShield Wizard window displays, click

Next.

It may take some time for the Welcome window to appear.

The Welcome window may also appear behind another
window. Do not run the installation program again while the
InstallShield is running. That will cause a VPD error message
(the Vital Product Data registry is in use).

4. Read the License Agreement. If you want to install the projects, select I
accept and click Next. The Welcome window opens. Click Next. The
Product Key window opens.

5. Enter the 18-character product key and click Next. The Directory Name
window opens.

The product key is found in the Home folder on the TSS

Download Center (File Portal) FTP website.

6. Accept the default (C:\tril7vnn) directory or specify an alternate location

for the country template projects.

7. Review the summary information and click Install to proceed. A

Progress window opens, followed by a Completion window.

8. Click Finish.

The installation program creates the proper directories and installs the
required files for all the country projects associated with your product key.

Trillium Software System™ Installation Guide

2-6 Installing Country Template Projects

X To install the country templates in silent mode

1. Create a temporary directory (for example, C:\TEMP).

2. Copy [Link] and [Link] to the temporary

directory.

3. Open the [Link] file and enter your Product Key and installation
directory. Save your changes.

4. From a command line prompt, change to the location of the temporary

directory you created in step 1.

5. Enter the command: [Link] -silent -options

[Link] and press Enter.

Running the above command will have you come back to the
prompt immediately. You can alternately enter the command into
a bat file and run the bat file to prevent this behavior.

Trillium Software System™ Installation Guide

 Setting the Environment Path 2-7

Setting the Environment Path

The path to the Trillium Software System server executables must be set in
your Windows server environment.

X To set the environment path

1. Open the System Properties windows and click the Advanced tab.

2. Click Environment Variables to open the Environment Variables

window.

3. Highlight the Path statement in the System Variables Window.

4. Click Edit.

5. In the Variable Value Box, add the path to the bin directory
(c:\tril7Vnn\bin) to the path string. This is the location of the Trillium
Software Server software.

6. Click OK to save the change.

The update of the System Environment is now complete. Shut down and
restart your computer in order for these changes to take effect.

Trillium Software System™ Installation Guide

2-8 Starting the Server

Starting the Server

X To start the Server session from the Start Menu on a server
machine

1. Click the Start button on the task bar.

2. Click All Programs to open the Programs list.

3. Click the Trillium Software System folder.

4. Select the Series 7 > [Link] folder.

5. Click Start Server.

After a few seconds, you will see some print statements indicating the port
number that was used for the rmiregistry, and a message about the classes
bound to the server. Note that if this window is closed, the server
process will be terminated.

The port number is written to a file called [Link]

which is located in the .\rmi directory. You can reference this file for
the port number. The port number is needed by the Control Center
during project creation.

If you need to stop the Server, go to the command window which invoked the
trilserver and press Ctrl-C or just shut down the entire window.

Alternatively you can start the server session by navigating to the .\rmi
directory and run the [Link] batch file.

As an option, you may run the runmonitor script, which automatically checks
to see if the server is running; and if it is not, the script restarts it. Please see
the [Link] file located in the .\rmi folder.

If there is a failure, the server will abort with some error messages. This may
indicate a problem with the installation or setup. If this occurs, contact Trillium
Software customer support for assistance.

Trillium Software System™ Installation Guide

 Automatically Starting the Server 2-9

Automatically Starting the Server

Optionally, you can have your Windows server administrator call the
[Link] file at system boot time. The administrator must place a
shortcut to call the [Link] program in the Windows startup menu.

Running the Server as a Windows Service

The Server process can be launched as a Windows service by following the
instructions below. Using this method eliminates the need to log onto the
system as a user and then manually start the Server.

You can also add the [Link] file to the startup menu.

Required Files

[Link] Program to run as Windows service.

[Link] Delays start of Server when executed through a Windows

Service. Required to properly sequence startup events.

[Link] Message file used by Event Viewer when interpreting event

log messages generated by [Link].

[Link] File containing application command lines you need

launched.
This file assumes the path is located on your c: drive. If
your server is installed on a drive other than c:, this file
needs to be updated to reflect the proper drive location.

[Link] The registry entries required for Event Viewer to correctly

display messages generated by the Launcher.

[Link] Batch file that executes the Server. This file is part of the
standard installation.

All of the files (except the [Link] file) must reside in the server bin
folder. This is typically c:\tril7Vnn\bin, but may be located at another
location on your system. [Link] should be placed in the RMI folder.

Trillium Software System™ Installation Guide

2-10 Automatically Starting the Server

Editing the Files

1. Edit the file [Link] to correctly provide the path to the file
[Link]. The entry should be similar to the following:

"EventMessageFile"="c:\\temp\\[Link]"

2. Edit the commands file [Link] to execute the commands you want
the service to start. This would include the path to the server batch file,
which in turn will execute the server. The entry should be similar to the
following:

cmd /c c:\tril7vnn\rmi\[Link]

3. Edit the file [Link] to include the command to make the startup
process wait 60 seconds. Add the following line to the [Link] file.

waitasec 60

Ensure that the statement is entered on the second line of the file
immediately following the path statement.

The delay time entry required for the [Link] program may vary
according to system requirements. Our testing indicates that 60
seconds is sufficient for most systems. If the Java process starts but
communication from the Control Center Client cannot be established
with the server, then a longer delay time may be required.

4. Edit the c:\tril7vnn\jre\bin\java line in the [Link] file by

adding the -Xrs option to the command as follows:

c:\tril7vnn\jre\bin\java -Xrs

Registering the Launcher Service files with Windows

The Trillium Launcher files must first be registered with the Windows Registry.
To do so, execute the following command from a command window:
Trilliumlauncher –f <location of the file [Link]> -Service
The location of the file must include the full path. For example, if the command
file is located in a folder named c:\tril7vnn\bin, then the path to the file is

Trillium Software System™ Installation Guide

 Automatically Starting the Server 2-11

c:\tril7vnn\bin\[Link].

It is then necessary to register the file [Link] with the

Windows Registry. To do so, double-click on the file from Windows Explorer.

Testing the Launcher

1. Open the Administrative Tools > Services window.

2. Locate the service name “Trillium Launcher”. Right-click and select

Start from the list. If the startup is successful, the status of the service
will show “started” in the list. If the service does not start, then a path
to one of the files edited initially may be incorrect or the command file
was not properly registered in the previous step. Ensure that the full
path to the command file is used when executing the TrilliumLauncher
registration command.

3. Once the service has been started, start a Control Center session from a
client machine and attempt to execute a function that uses the Server
(running the Converter would suffice).

Once this test has been successful, you can enable the service to start
automatically by right clicking on the Trillium Launcher Service and selecting
Properties from the drop down list. When the Properties window appears, you
can then change the startup type selection to ‘Automatic’.

With this option selected, the Launcher will start the Server process
automatically whenever the server machine is run.

The delay time entry required for the [Link] program in the
[Link] file may vary according to your system requirements.

Our testing indicates that 60 seconds is sufficient for most systems. If the Java
process starts but communication from the Control Center Client application
cannot be established with the server, then a longer delay time may be
required.

Trillium Software System™ Installation Guide

2-12 Starting the Control Center Client

Starting the Control Center Client

The Trillium Software System Control Center Client is the GUI interface portion
of the product that runs on any Windows machine that can access a Windows
or UNIX server that has the Trillium Software System Server Software installed
and running.

X To start the Control Center Client software from the Start menu

1. Click the Start button on the task bar.

2. Click All Programs to open the Programs list.

3. Click Trillium Software System.

4. Select the Series 7 > [Link] folder.

5. Click Control Center.

The Control Center should come up along with an accompanying command

window.

X To start the Control Center Client software from desktop icon

Click the [Link] Control Center icon located on your desktop. This icon is
created during the installation process.

The Control Center should come up along with an accompanying command

window.

Trillium Software System™ Installation Guide

 Installation Package 3-1

CHAPTER 3 Installing the Trillium

Software System on UNIX

This chapter explains how to install Trillium Software System and the
country template projects on a UNIX system.

Installation Package
The installation package for a UNIX system consists of the following
components:
• Trillium Software System Server for UNIX. The Server software for
UNIX should be located on the server machine that supports the client
machines accessed by your users. The server is usually a different machine
than the client, but server programs may be installed in either location.
• Trillium Software System Client for Windows. The Client software for
UNIX should be located on the client machine that connects to the server
machine where the Server software has been installed. The client machine
must be capable of file system access of the server file system where the
Trillium Software Server is located. This is accomplished by "mapping" the
server drive to the client machine.

Trillium Software System™ Installation Guide

3-2 Installation Package

• Country Template Project(s). Template projects contain business rules,

specific for each country. These rules govern matching, parsing and
(optional) geocoding processes. The template projects contain all files,
tables and DDLs required for specific country projects. When a new project
is created for this country, these resources are copied into the newly-cre-
ated project folders.
• Postal and/or census directories for the countries purchased (US,
CA, AU, etc.). These directories contain all postal data for the specified
country, and are used by the postal and census geocoding processes.

See Postal Table Installation Guide for instructions for

installing the postal and/or census directory files.

• Product Directories. These directories contain various USPS product

directories such as Locatable Address Conversion System (LACSLink). and
Delivery Point Validation (DPV).

See Postal Table Installation Guide for instructions for

installing the USPS product directory files.

Trillium Software System™ Installation Guide

 Installing the Server Software 3-3

Installing the Server Software

This section explains how to install the Trillium Software System Server
Installation on a UNIX system. See the Windows section of this manual for
installation instructions for the Client.

The Trillium Software System Client is only available on Windows

platforms.

Note to UNIX administrators: The Server Installation must be

installed for users in the same UNIX group. These users should have
read, write and execute privileges for the software, so that data can
be shared among users. All users needing to access the Series 7
software should be added to this UNIX group.

If customers with UNIX Server licenses wish to use the Control Center client
software, the client machine must have file system access to the server
machine. You must have the ability to connect to the UNIX drive where Series
7 is installed, and have that drive appear as a logical drive on your PC. There
are a number of 3rd party utilities that allow you to map UNIX drives (for
example, Samba, Hummingbird Maestro, and ReflectionX).

X To install the Server software

1. If you have not yet done so, download the server installation software
setup from the TSS Download Center (File Portal) FTP site.

2. Move the TAR file to the directory on the UNIX Server where you will
unload the files. We recommend ‘tril7Vnn’ for the installation directory,
where nn is the Series 7 version number.

3. Unload the Server software with the following command at the UNIX
prompt:

tar [-]xvf <filename>

This command unloads the entire Trillium Software System Server

software.

Your UNIX software contains an rmi directory: /installdir/rmi. There will be

a setuprmi script within that directory. There will also be three other files for

Trillium Software System™ Installation Guide

3-4 Installing Country Template Projects

configuration. These files are as follows:

setuprmi Script you must run after installing the software to generate
the trilserver startup script.

[Link] File governing any rmi permissions you may wish to enforce.

[Link] File governing which rmi server classes will be bound for
remote access via a java application.

[Link] File governing a pool of port numbers to use for rmiregistry

connection.

4. Run the setuprmi script. Enter: setuprmi

A script named trilserver will be generated in the rmi directory.

After the Server installation for UNIX is finished, you may install the Client
software for Windows on the client machine(s).

See Chapter 1 for instructions on installing the Client software.

Installing Country Template Projects

If you do not have GUI capabilities on a platform, you can install in console
mode or silent mode. Those procedures are documented on page 3-6 and
page 3-6.

X To install Country Template Projects using the InstallShield

program

1. Copy the platform-specific installation program

([Link]) and jar file ([Link]) into the
directory where you installed the Trillium Software server. (Platform is
the name of your operating system.) The installation program, jar file,
and server software must be in the same location.

If you are installing the Trillium Software System remotely,

make sure that the installation program is copied or FTP’d to
the UNIX drive in binary format. Check the byte count.

Trillium Software System™ Installation Guide

 Installing Country Template Projects 3-5

2. Be sure the installation program has execute permissions. At the

prompt, type:

chmod +x [Link]

where platform is the name of your operating system.

3. Set the DISPLAY variable to the computer, if it is not already set.

a. If you do not know the IP address, type the following command at

the prompt:

ipconfig

That returns the address.

b. Type one of the following comands (where [Link] is your IP

address):

setenv DISPLAY [Link].0 (csh)

OR

export DISPLAY=[Link].0 (ksh)

4. Launch the installation program. For example, type:

./[Link]

5. When the Welcome window opens, click Next. The License Agreement
window opens.

6. Read the license agreement and select I accept, then click Next. The
Product Key window opens.

7. Enter the 18-character product key and click [Link] Directory

window opens.

The product key is found in the Home folder on the TSS

Download Center (File Portal) FTP website.

Trillium Software System™ Installation Guide

3-6 Installing Country Template Projects

8. Accept the default directory or specify an alternate location for the TS

Software System Country Template Projects. The default directory is the
Trillium Software working directory (for example, \server\tril7Vnn).

9. Click Next. A Summary window opens.

10. Review the summary and click Install to continue. A Progress window
opens, followed by a completion message.

The installation program creates the proper directories and installs the
required files for all the country projects associated with your product key.

X To install the country templates in console mode

1. Copy the platform-specific installation program

([Link]) and jar file ([Link]) to the directory
where you installed the Trillium Software server. The installation
program and the jar file must be in the same location.

If you are installing the Trillium Software System remotely,

make sure that the installation program is copied or FTP’d to
the UNIX drive in binary format. Check the byte count.

2. At the command prompt, type:

./[Link] -console

where platform is the name of your operating system (for example,

tril7VnnctSunOS).

3. Respond to the prompts from the install program. You will be asked to
supply the name of the installation directory and your product key.

Ignore “wide character xxx” messages.

X To install the country templates in silent mode

1. Copy the platform-specific installation program

([Link]) and jar file ([Link]) to the directory
where you installed the Trillium Software server. Make sure that the
installation program and the jar file are in the same location.

If you are installing the TS Software System remotely, make

Trillium Software System™ Installation Guide

 Verification 3-7

sure that the installation program is copied or FTP’d to the

UNIX drive in binary format. Check the byte count.

2. Copy the [Link] from the Resources directory to the same location
as the installation program.

3. Open [Link], enter the name of the installation directory and your
Product Key. Close the file when you are done.

4. Be sure the installation program has execute permissions. At the

prompt, type:

chmod +x [Link]

5. Type the following command:

./[Link] -silent -options [Link]

Verification
To verify that the country templates were successfully installed, confirm the
existence of the country templates in the install directory (for example, server/
tril7Vnn/cc_proj, where nn is the Series 7 version number and cc is the country
code).

Setting System Paths

You will need to set the path variable in the UNIX environment. To determine if
the path to the executables needs to be added to the path variable, enter the
following statement at the UNIX command prompt under the user’s login:

UNIX_prompt% which cfprsdrv

where "which" is the command and "cfprsdrv" is the executable to search for.

The path returned should be similar to <systempath>/tril7Vnn/bin/cfprsdrv. If

the system returns "no cfprsdrv in..." and several lines of directory paths, then
the path variable needs to be modified for the program to run. Determine the
location of the Series [Link] executable files and follow the steps below
corresponding to your login shell.

Trillium Software System™ Installation Guide

3-8 C-shell

C-shell
1. Locate the .cshrc file in the user’s home directory. If you are unsure
about the location of the home directory, and are currently logged in as
the user, enter the following to automatically change to it:

UNIX_prompt% cd $home

2. Using a UNIX text editor, edit the line in the .cshrc file that begins with
the words "set path". There likely will be several existing directory paths
listed for this variable and you need only add to the ones that are there.
Enter the directory path of the location of the executable files, such as:

set path=(/tril7Vnn/bin /usr/etc /usr/openwin/bin ...

where "set path" is the environment variable and “/tril7Vnn/bin” is the

directory path to be added indicating the location of the executables.

3. Once the edit has been made, save the .cshrc file and exit the active
UNIX session. Login once again and execute the "which" command
described earlier. If successful, the command returns the directory path
entered into the .cshrc file. If not, check that the path was entered
correctly in the file.

Korn Shell
1. Locate the .profile file in the user’s home directory. If you are unsure
about the location of the home directory, and you are currently logged
in as the user, enter the following to automatically change to it:

UNIX_prompt$ cd $home

2. Using a text editor, edit the line in the file .profile that begins with the
words "path". There will likely be several existing directory paths listed
for this variable and you need only add to the ones that are there. Enter
the directory path of the location of the Series 7 Version nn executable
files:

path=(/tril7Vnn/bin /usr/etc /usr/openwin/bin ...

where "path" is the environment variable and “/tril7Vnn/bin” is the

Trillium Software System™ Installation Guide

 Starting the Server 3-9

directory path to be added indicating the location of the executables.

3. Once the edit has been made, save the .profile file and exit the active
UNIX session. Login once again and execute the "which" command
described earlier. If successful, the command will return the directory
path entered into the .profile file. If not, check that the path was
entered correctly.

Starting the Server

It is only required to start the Sever if you need to run Control Center Client
software.

X To start the Server

1. Navigate to the RMI directory of your Trillium Software System install.

2. Run the setuprmi script by entering setuprmi. A script with the name
trilserver will be generated.

3. Launch the server by entering trilserver at the command line.

4. To ensure the server is running, enter the command:

ps – ef | grep java

Something similar to the following is returned:

root 12294 1 1 14:57:14 pts/0 0:02 /tril02/SunOS/tril7Vnn/jre/bin/../bin/

sparc/native_threads/java –Dinstallbasedir

If you don’t see something similar to this returned, then the server is not
running and needs to be restarted. You may also run the runmonitor script
which automatically checks to see if the server is running, and if not, restarts
it. Refer to the [Link] file in the .\rmi folder.
Note to UNIX administrators: The trilserver must be started by a user
of the same group that was created when the software was installed.
When you create a project in the Control Center, it uses the permissions
of the user that started the trilserver to create the project’s directories. If
a user were to start the trilserver and then a different user tried to create
a project in the Control Center, the project would get the permissions of

Trillium Software System™ Installation Guide

3-10 Automatically Starting the Server

the first user, which can cause problems when running the project. If you
need to stop the Server, you can run a “ps – ef | grep java” command
and stop the process ID. If there is a failure, the server will abort with
some error messages. This may indicate a problem with the installation
or setup.

Automatically Starting the Server

Optionally, you can have your system administrator call the trilserver script at
system boot time. The administrator must ‘cd’ (change directory)
programmatically to the .\rmi subdirectory before calling the trilserver
program.

This way the script will resolve paths correctly, and write the port number to
the CurrentPortNumber file, where it can be referenced easily by the user.

Trillium Software System™ Installation Guide

 Installation Package 4-1

CHAPTER 4 Installing Trillium

Software System on IBM
Mainframe

This chapter explains how to install Trillium Software System and the
country template projects on a IBM Mainframe system.

Installation Package
The installation package for IBM Mainframe consists of the following:
• Trillium Software System. This contains all of the necessary components
of the Trillium Software System.
• Country Template Projects (US, CA, AU, etc.). These template projects
contain business rules which are specific for each country. These rules gov-
ern the matching, parsing and (optional) geocoding processes. The tem-
plate projects contain all files, tables and DDLs required for specific country
projects. When a new project is created for this country, these resources
are copied into the newly-created project folders.
• A Windows development license. The license includes Trillium Software
System Server Software and Trillium Software System Client Software.

Trillium Software System™ Installation Guide

4-2 Installation Package

• Postal and/or census directories for the countries purchased (US,

CA, AU, etc.). These directories contain all postal data for the specified
country, and are used by the postal and census geocoding processes.

See Postal Table Installation Guide for instructions for

installing the postal and/or census directory files.

• Product Directories. These directories contain various USPS product

directories such as Locatable Address Conversion System (LACSLink). and
Delivery Point Validation (DPV).

See Postal Table Installation Guide for instructions for

installing the USPS product directory files.

Trillium Software System™ Installation Guide

 Installing Trillium Software System 4-3

Installing Trillium Software System

Use the following procedure to install Trillium Software System on Mainframe.

X To Install Trillium Software System

1. Download the base software, MF_S7_Base&ver, from the TSS

Download Center (File Portal) FTP site.

&ver = Trillium Software System version number.

2. Copy MF_S7_Base&ver to a PC. If the file is zipped, double-click the

file name in Windows Explorer to uncompress it. See Table 4.2 for a
description of the directory structure.

3. Copy [Link] from MF_S7_Base&ver\bin to your root directory

to be executed from (for example, C:\).

4. Edit the FTP input files. The FTP input files are located in
MF_S7_Base&ver\bin. See Table 4.1 for a list of the files that need
editing.

Sample FTP input file

&logonid
&password
bin
quote site lr=120 blk=27840 rec=fb u=&unit vol=&vol tr pri=8 sec=1 di=2
mkdir '&[Link]&[Link]'
cd '&[Link]&[Link]'
mput *
close
quit

a. Change &logonid to a valid logonid for your Mainframe.

b. Change &password to the password for the chosen logonid.

c. Change &unit to a valid disk unit designator for your mainframe.

d. Change &vol to the volume serial number of the disk(s) on which the
software should be placed.

Trillium Software System™ Installation Guide

4-4 Installing Trillium Software System

e. Change &prefix to a valid high level qualifier for your Mainframe to

which you have create, delete, and write privileges.

f. Change &ver to the Trillium Software System version number that

you are installing.

Table 4.1 FTP Input Files to Edit - Trillium Software System

[Link] [Link] [Link]

[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]
[Link] [Link] [Link]

5. Run [Link].
Usage: [Link] drive MainFrame Host Name Version
IE: [Link] C dino 7160

where:
C = drive designator for the drive to which the [Link] script has
been copied
dino = MainFrame Host Name
7160 = Trillium Software Version Number
[Link] will create a directory called TrilUpload_Reports on the
drive and write two reports in it: [Link] and [Link].

6. The Trillium Software loadlibs that have been put onto the Mainframe
are unloaded sequential copies of the loadlibs.

7. On the Mainframe, change member LOADTRIL in PDS

&[Link]&[Link] as instructed in the comments in LOADTRIL.

Trillium Software System™ Installation Guide

 Directory Structure 4-5

8. Run LOADTRIL. It will create &[Link]&[Link] and

&[Link]&[Link] in loadlib format.

Directory Structure
Table 4.2 contains a description of the directory structure.
Table 4.2 MF_S7_Base&ver Directory Structure

Name Contains:

CPagelib Code page files

Loadlib An unloaded copy of the Trillium Software load library

Maclib Header files

Callable Loadlib Unloaded copy of the Trillium Software loadlib library

Samples\BParser\Data Business Data Parser Sample Input Data

Samples\BParser\Ddllib Business Data Parser Sample DDL

Samples\BParser\JCLlib Business Data Parser Sample MF JCL

Samples\BParser\Parmlib Business Data Parser Sample Parameter files

Samples\BParser\Tables Business Data Parser Sample Parsing Tables

Samples\Callable\Data Input file for the Mainframe job that runs the COBOL Sample
program that illustrates calling the Converter

Samples\Callable\Ddllib Callable Samples DDL members

Samples\Callable\JCLlib MF JCL used to run the COBOL Sample Programs

Samples\Callable\Parmlib Callable Sample Parameter files

Samples\Callable\Srclib Sample COBOL and C Programs illustrating calling various

Trillium Software modules

Samples\Census\Data Input file for the Census job

Samples\Census\Ddllib Census job DDL members

Trillium Software System™ Installation Guide

4-6 Directory Structure

Table 4.2 MF_S7_Base&ver Directory Structure

Samples\Census\JCLlib MF JCL for running the Census Geocoder

Samples\Census\Parmlib Census job Parameter files

Samples\Multimatch\Data Input file for the Mainframe job illustrating running a multi match

Samples\Multimatch\Ddllib Multi Match DDL members

Samples\Multimatch\JCLlib Mainframe JCL for the Multi Match sample job

Samples\Multimatch\Parmlib Multi Match Parameter files

Samples\Recons\Data Input file for the Mainframe job illustrating running the Data
Reconstructor

Samples\Recons\Ddllib Data Reconstructor DDL members

Samples\Recons\JCLlib Mainframe JCL for the Data Reconstructor sample job

Samples\Recons\Parmlib Data Reconstructor Parameter files

Samples\Utilities\Data Input files for the Mainframe jobs illustrating running the Utilities

Samples\Utilities\Ddllib Utilities DDL members

Samples\Utilities\JCLlib Mainframe JCL for Utilities sample jobs

Samples\Utilities\Parmlib Utilities Parameter files

Tables Global Geography File used by the Router, and the Uplow Table
used by the Converter

Bin Script to upload the Base Install to the Mainframe ([Link])

and the FTP input members used in the script.

&ver = Trillium Software System version number.

The files in these directories have been transferred in binary

mode to the PC, and are not viewable on the PC.

Trillium Software System™ Installation Guide

 Installing Country Template Projects 4-7

Installing Country Template Projects

Use the following procedure to install Country Template Projects on a
Mainframe system.

X To Install Country Template Projects

1. Download the country template package, &CO_Project, from the TSS

Download Center (File Portal) FTP site.

&CO = country code

2. Copy &CO_Project to a PC. If file is zipped, double-click the file name

in Windows Explorer to uncompress it. See Table 4.4 for a description of
the directory structure.

3. Copy [Link] from &CO_Project\bin to your root directory to

be executed from (for example, C:\).

4. Edit the FTP input files. The FTP input files are located in
&CO_Project\bin. See Table 4.3 for a list of the files that need editing.

Sample FTP input file

&logonid
&password
bin
quote site lr=1000 blk=27000 rec=fb u=&unit vol=&vol tr pri=5 sec=1
put convinp '&prefix. tril&[Link]'
close
quit

a. Change &logonid to a valid logonid for your Mainframe.

b. Change &password to the password for the chosen logonid.

c. Change &unit to a valid disk unit designator for your mainframe.

d. Change &vol to the volume serial number of the disk on which the
country project should be placed.

Trillium Software System™ Installation Guide

4-8 Directory Structure

e. Change &prefix to a valid high level qualifier for your Mainframe to

which you have create, delete, and write privileges.

Table 4.3 FTP Input Files to Edit - Country Template Projects

&[Link] &[Link]

&[Link] &[Link]

&[Link] &[Link]

&CO = country code

5. Run [Link].

Usage: [Link] drive MainFrame Host Name Country Code

IE: [Link] C dino US
C = drive designator for the drive to which the [Link] script has
been copied
dino = MainFrame Host Name
US = Trillium Software country code for the United States

6. [Link] will create a directory called TrilCOUpload_Reports on

the drive and write two reports in it; [Link] and [Link].

Directory Structure
Table 4.4 contains a description of the directory structure.
Table 4.4 MF_S7_Country_Projects&ver Directory Structure

Name Contains:

&CO_Project\ Sub directories and files that constitute a Country Project. There is one for each
of the Robust, Mature, and Standard countries supported by Trillium Software
and the Basic Tier Project (WW).

bin\ Script to upload the Country Install to the Mainframe ([Link])

FTP input members used in the script

Data\ Test input file for the DEMRUN job in the JCLLib directory

Trillium Software System™ Installation Guide

 Installing the Rich Country Bundle 4-9

Table 4.4 MF_S7_Country_Projects&ver Directory Structure

DDLLib\ DEMRUN DDL members

JCLLib\ DEMRUN job used to test the Implementation and serving as a sample of MF
JCL for the Trillium Software System batch drivers.

ParmLib\ Parameter files needed by DEMRUN and samples of other parameter files used
by Trillium Software modules.

Tables\ Trillium Software standard Parsing Tables

&CO =country code

&ver = Trillium Software System version number.

The files in these directories have been transferred in binary

mode to the PC, and are not viewable on the PC.

Installing the Rich Country Bundle

Use the following procedure to install the Rich Country Bundle on a Mainframe
system.

X To Install the Rich Country Bundle

1. Download the Rich Country Bundle package, MF_S7_RCB&ver, from

the TSS Download Center (File Portal) FTP site.

&ver = Trillium Software System version number.

2. Copy MF_S7_RCB&ver to a PC. If file is zipped, double-click the file

name in Windows Explorer to uncompress it. See Table 4.6 for a
description of the directory structure.

3. Copy [Link] and [Link] from

MF_S7_RCB&ver\bin to your root directory to be executed from (for
example, C:\).

Trillium Software System™ Installation Guide

4-10 Installing the Rich Country Bundle

4. Edit the FTP input files. The FTP input files are located in
MF_S7_RCB&ver\&CO_Project\bin. See Table 4.5 for a list of the files
that need editing.

Sample FTP input file

&logonid
&password
bin
quote site lr=1000 blk=27000 rec=fb u=&unit vol=&vol tr pri=5 sec=1
put convinp '&[Link]&[Link]'
close
quit

a. Change &logonid to a valid logonid for your Mainframe.

b. Change &password to the password for the chosen logonid.

c. Change &unit to a valid disk unit designator for your mainframe.

d. Change &vol to the volume serial number of the disk on which the
country project should be placed.

e. Change &prefix to a valid high level qualifier for your Mainframe to

which you have create, delete, and write privileges.

f. Change &ver to the Trillium Software System version number that

you are installing.

Table 4.5 FTP Input Files to Edit - Rich Country Bundle

&[Link] &[Link]

&[Link] &[Link]

&[Link] &[Link]

&CO = country code

5. Run [Link].

Usage: [Link] drive MainFrame Host Name

Trillium Software System™ Installation Guide

 Installing the Rich Country Bundle 4-11

IE: [Link] C dino

C = drive designator for the drive to which the [Link] script
has been copied
dino = MainFrame Host Name

6. [Link] will create a directory called RCBCoUpload_Reports on

the drive and write two reports in it for each country; &[Link]
and &[Link].

Table 4.6 MF_S7_RCB&ver Directory Structure

Name Contains:

&CO_Project\ Sub directories and files that constitute a Country Project. There is one
for each of the countries in the Rich Country Bundle.
bin\ FTP input members used for the upload of the Mainframe

Data\ Test input file for the DEMRUN job in the JCLLib directory

DDLLib\ DEMRUN DDL members

JCLLib\ DEMRUN job used to test the Implementation and serving as a sample
of MF JCL for the Trillium Software System batch drivers.

ParmLib\ Parameter files needed by DEMRUN and samples of other parameter

files used by Trillium Software modules.

Tables\ Trillium Software standard Parsing Tables

bin Scripts for the upload

&CO = country code

&ver = Trillium Software System version number.

Files in the Data, DDLLib, JCLLib, ParmLib, and Tables

directories have been transferred in binary mode to the PC,
and are not viewable on the PC.

Trillium Software System™ Installation Guide

4-12 Installing the Lite Country Bundle

Installing the Lite Country Bundle

Use the following procedure to install the Lite Country Bundle on a Mainframe
system.

X To Install the Lite Country Bundle

1. Download the Lite Country Bundle package, MF_S7_LCB&ver, from

the TSS Download Center (File Portal) FTP site.

&ver = Trillium Software System version number.

2. Copy MF_S7_LCB&ver to a PC. If file is zipped, double-click the file

name in Windows Explorer to uncompress it. See Table 4.8 for a
description of the directory structure.

3. Copy [Link] from MF_S7_LCB&ver\bin to your root

directory to be executed from (for example, C:\).

4. Edit the FTP input files. The FTP input files are in MF_S7_LCB&ver\bin.
See Table 4.7 for a list of the files that need editing.

Sample FTP input file

&logonid
&password
bin
quote site lr=1000 blk=27000 rec=fb u=&unit vol=&vol tr pri=5 sec=1
put convinp '&[Link]&[Link]'
close
quit

a. Change &logonid to a valid logonid for your Mainframe.

b. Change &password to the password for the chosen logonid.

c. Change &unit to a valid disk unit designator for your mainframe.

d. Change &vol to the volume serial number of the disk on which the
country project should be placed.

Trillium Software System™ Installation Guide

 Installing the Lite Country Bundle 4-13

e. Change &prefix to a valid high level qualifier for your Mainframe to

which you have create, delete, and write privileges.

f. Change &ver to the Trillium Software System version number that

you are installing.

Table 4.7 FTP Input Files to Edit - Lite Country Bundle

[Link] [Link]

[Link] [Link]

[Link] [Link]

5. Run [Link].
Usage: [Link] drive MainFrame Host Name Version
IE: [Link] C dino version
C = drive designator for the drive to which the [Link] script
has been copied
dino = MainFrame Host Name
version = Trillium Software System version number

6. [Link] will create a directory called TrilLCBUpload_Reports

on the drive and write two reports in it; [Link] and [Link].

Table 4.8 MF_S7_LCB&ver Directory Structure

Name Contains:

bin\ Script to upload and the FTP input members used in the script

Data\ Test input file for the DEMRUN job in the JCLLib directory

DDLLib\ DEMRUN DDL members

JCLLib\ DEMRUN job used to test the implementation and serving as a sample of
MF JCL for the Trillium Software System batch drivers.

ParmLib\ Parameter files needed by DEMRUN and samples of other parameter

files used by Trillium Software modules.

Tables\ Trillium Software standard Parsing Tables

Trillium Software System™ Installation Guide

4-14 Installing the Lite Country Bundle

&ver = Trillium Software System version number.

Files in the Data, DDLLib, JCLLib, ParmLib, and Tables

directories have been transferred in binary mode to the PC,
and are not viewable on the PC.

Trillium Software System™ Installation Guide

 Installing Trillium Software System 5-1

CHAPTER 5 Installing Trillium

Software System on
CICS

This chapter explains how to install Trillium Software System on a CICS

system.

Installing Trillium Software System

Use the following procedure to install Trillium Software System on CICS.

X To Install Trillium Software System on CICS

1. Download the base software, CICS_xx&ver, from the TSS Download

Center (File Portal) FTP site.

&ver = Trillium Software System version number.

2. Copy CICS_xx&ver to a PC. If the file is zipped, double-click the file

name in Windows Explorer to uncompress it. See Table 5.2 for a
description of the directory structure.

Trillium Software System™ Installation Guide

5-2 Installing Trillium Software System

3. Copy [Link] from CICS_xx&ver\bin to your root directory

to be executed from (for example, C:\).

4. Edit the FTP input files. The FTP input files are located in
CICS_xx&ver\bin. See Table 5.1 for a list of the files that need editing.

Sample FTP input file

&logonid
&password
bin
quote site lr=80 blk=27920 rec=fb u=&unit vol=&vol tr pri=2 sec=2 di=2
mkdir '&[Link]&[Link]'
cd '&[Link]&[Link]'
put [Link] '&[Link]&[Link](LOADTRIL)'
put [Link] '&[Link]&[Link](CR8TFLS)'
close
quit

a. Change &logonid to a valid logonid for your Mainframe.

b. Change &password to the password for the chosen logonid.

c. Change &unit to a valid disk unit designator for your mainframe.

d. Change &vol to the volume serial number of the disk(s) on which the
software should be placed.

e. Change &prefix to a valid high level qualifier for your Mainframe to

which you have create, delete, and write privileges.

f. Change &ver to the software version you are installing.

Table 5.1 FTP Input Files to Edit - Trillium Software System

[Link] [Link] [Link] (US only)

[Link] [Link] [Link]
[Link] [Link] [Link]
[Link]

5. Run [Link].

Trillium Software System™ Installation Guide

 Installing Trillium Software System 5-3

Usage: [Link] drive MainFrame Host Name Version

IE: [Link] C dino 7160

where:
xx = Country code
C = drive designator for the drive to which the [Link] script has
been copied
dino = MainFrame Host Name
7160 = Trillium Software Version Number
[Link] will create a directory called CICS_Reports on the
drive and write two reports in it: [Link] and [Link].

6. The Trillium Software loadlibs that have been put onto the Mainframe
are unloaded sequential copies of the loadlibs.

7. On the Mainframe, change member LOADTRIL in PDS

&[Link] as instructed in the comments in
LOADTRIL.
8. Run LOADTRIL. It will create the following in loadlib format:
&[Link]
&[Link]
&[Link]
9. On the Mainframe, change member CR8TFLS in PDS
&[Link] as instructed in the comments in
CR8TFLS and run it.
10. It will create the following Trillium Output TD Queue files:
&[Link]
&[Link]
&[Link]
&[Link]
&[Link]
&[Link]
&[Link]

Trillium Software System™ Installation Guide

5-4 Directory Structure

Directory Structure
Table 5.2 contains a description of the directory structure.
Table 5.2 CICS_xx&ver Directory Structure

Name Contains:

bin\ Script to upload the CICS Install to the Mainframe

([Link]) and the FTP input members used in the script,
and JCL members CR8TFLS and LOADTRIL.

CICSTables\ Trillium Software CICS Tables library members

CopyLib\ Trillium Software CICS COBOL copybooks

JCLLib\ Trillium Software CICS JCL library members (US only)

Loadlib\ Unloaded copies of the Trillium Software CICS load library, the
CICS Callable load library, and the CICS batch load library

Objlib\ Trillium Software CICS object modules

Parmlib\ Trillium Software CICS Parameter files

SRCLib\ Trillium Software CICS COBOL sample programs

Tables\ Trillium Software CD and BD Parser tables files

TrilFiles\ Trillium Software CICS Files

xx = Country code. Valid country codes are US, UK, CA, AU,
and PT.

&ver = Trillium Software System version number.

The files in these directories have been transferred in binary

mode to the PC, and are not viewable on the PC.

Trillium Software System™ Installation Guide