Gentran:Server for Windows

Option Pack

Installation Card

Introduction
This card describes how to install your Gentran:Server for Windows optional components.
This card contains the following topics:
Before You Begin
How to Download Optional Components from the ESD Portal
How to Install Optional Components
How to Uninstall Optional Components
How to Select which Optional Components to Load
Related Documentation

Gentran:Server for Windows November 2005

 2 Before You Begin Options Pack Installation Card

Before You Begin

Introduction This section describes requirements that you must meet before you begin the
Gentran:Server for Windows Option Pack installation.

Pre-installation The following are pre-installation requirements:

requirements Verify that Gentran:Server for Windows Version 5.1 is installed.
Reference
See "How to Validate your Gentran:Server Installation" in the Post-installation
Tasks chapter of the Distributed System Installation Guide or Single
Workstation Installation Guide for additional information.
If you are installing a gateway, verify that you have successfully installed and
configured any associated messaging software.
Verify that you have the Options Pack Product Keys that you will need to enter during
the installation process. These are contained either in your Packing List (if you
received CD-ROMs) or in the e-mail from Sterling Commerce (if you are
downloading from the ESD Portal).

Clustered To complete the installation, you must comply with the following prerequisites:
environment You must be logged on to Windows as a domain administrator.
prerequisites
IP-based communications are the only communications supported with
Gentran:Server on a clustered system.
Install the Options Pack only on the node that owns the Cluster resources.
Ensure that failback is allowed and the node on which you are installing
Gentran:Server is set to Preferred Owner in Cluster Administrator.
Reference
See your Microsoft documentation for more information on using Cluster
Administrator.
You must have already installed the Windows 2000 Advanced Server operating
system on each node and that you have installed either SQL Server or Oracle on a
machine or machines that are accessible via the network.
Reference
See the Getting Started Guide for more information on which operating system and
database management system versions are supported with Gentran:Server.
You must have a basic understanding of Windows, clustering, and SQL Server/Oracle
terminology and functionality, and you have access to a database administrator
(DBA) and system administrator.

Gentran:Server for Windows November 2005

Options Pack Installation Card How to Download Optional Components from the ESD Portal 3

How to Download Optional Components from the ESD

Portal

Introduction These instructions contain procedures for downloading the Gentran:Server for Windows
Options Pack components from the Electronic Software Distribution (ESD) Portal.

Downloading the To download the zipped file:

Application File

Step Action

1 In the e-mail message you received from Sterling Commerce, click the
link to the Electronic Software Distribution Download Area.

2 In the Security Alert dialog box, click Yes.

3 On the Login page, type the following information:

Sterling order number
Company name
Customer ID

4 Click Login, and the system displays the Download Area.

5 Locate Gentran:Server for Windows, version 5.1 and click Download.

6 In the File Download dialog box, click Save.

7 When the Save As dialog box opens, save the zipped file to the C:\ drive.

Note
If Internet Explorer adds a number in brackets to the name of the
downloaded file (for example, gsw51[1]_OptionPack_cd.zip), rename the
file on the Windows system before you transfer it to the system where it
will be installed.

8 Right-click the zipped file icon and extract (unzip) the file to an empty
directory.

Note
A folder named OptionPack_cd is created.

Gentran:Server for Windows November 2005

 4 How to Install Optional Components Options Pack Installation Card

How to Install Optional Components

Introduction This section describes how to install Gentran:Server for Windows optional user interface
components.

Note
The product keys for installing the Gentran:Server Options Pack software are located on
the packing list that was shipped with your Gentran:Server product.

Procedure Use this procedure to install Gentran:Server for Windows optional user interface
components.

Recommendations
If your Gentran:Server environment includes a controller and one or more remote
clients, we recommend that you complete this installation procedure on the
Gentran:Server controller first, followed by each Gentran:Server client. If you are
running Gentran:Server in a clustered environment, you need to install the Options
Pack on each node in your clustered system.
If you are running Gentran:Server in a clustered environment and you are prompted
during the Options Pack install that Setup has detected existing database tables and
asks if you want to keep the existing tables, click No to inform Setup that you want to
work with the existing tables.

Step Action

1 Are you running Gentran:Server in a clustered environment?

If yes, complete these steps before beginning the install:
Move the groups containing Gentran:Server to the node on
which you are currently working.
Bring all Gentran:Server service resources offline but do not
bring the Gentran:Server share (typically GENSRVNT) offline.
Continue with Step 2.
If no, continue with Step 2.

2 If you are installing from CD-ROM, complete the following:

a. Insert the Option Pack installation CD into your CD-ROM drive.
b. If Autorun is disabled on this machine, select Run from the Start
menu and continue with c. Otherwise, continue with Step 4.
c. Browse to your CD-ROM drive, select Setup.exe, and click OK.

System Response
Setup begins. The system displays the Welcome dialog. The installation
wizard guides you through the installation process. Continue with Step 4

Gentran:Server for Windows November 2005

Options Pack Installation Card How to Install Optional Components 5

(Contd)
Step Action

3 If you are installing from the ESD Portal download, browse to the
OptionPack_cd folder and run setup.exe.

System Response
Setup begins. The system displays the Welcome dialog. The installation
wizard guides you through the installation process. Continue with Step 4

4 Click Next.

5 Select the components that you want to install. Click Next.

Notes
To install the XML option, you must have previously installed the
Gentran:Server Integration Components. When you install the XML
option, the Gentran:Server Tutorial folder includes an XML subfolder
containing the XML tutorial files.
Reference
See the Gentran:Server Installation Guide for more
information on installing Integration Components.
The Advanced Data Distribution option can only be installed on your
primary Gentran system controller.
We recommend that you install the HTTP Message Forwarder on a
machine inside your DMZ; installing this component on a machine in
your Gentran system is not recommended.

System Response
The system displays the Key Entry dialog box for the first optional
component that you selected.

6 Enter the Product Key for that component and press Next.

7 Repeat Step 6 as prompted.

8 Do one of the following:

If the Optional Component dialog box is displayed, continue with
Step 9.
If a dialog box is displayed stating that setup cannot proceed until
specified services (Gentran, IIS, WWW, FTP, SMTP) are stopped,
click OK to acknowledge the message. Click Yes at each prompt to
stop a specified service.
Repeat until the Optional Component dialog box is displayed, then
continue with Step 9.
System Response
The system displays the Optional Component dialog box.

Gentran:Server for Windows November 2005

6 How to Install Optional Components Options Pack Installation Card

(Contd)
Step Action

9 Did you choose to install the Communications Gateway?

If no, a dialog box is displayed stating that Setup is ready to install
components. Continue with Step 10.
If yes, at the Question dialog box, select whether you want to make
this machine a communications controller.

System Response
If the system displays the Windows Logon dialog box, continue with
Step 10.
If the system displays the Gentran:Server Communications Controller
dialog box (with the Gentran: Server systems to which your client
machine is connected), select the system in which you want this
machine to be a communications controller and continue with
Step 10.
Note
You are only prompted with the Gentran:Server Communications
Controller dialog box if you are installing the Communications
Gateway on a machine which runs as a user interface client in
multiple Gentran:Server systems.

10 At the Windows Logon dialog box, enter the requested Windows domain
account information. Continue with the next step.

11 Click Yes to begin installation.

System Response
Installation begins.
If you chose to install the MQSeries gateway, you are prompted with
a reminder that you must have the MQSeries software installed on
your machine before installing the MQSeries gateway (click OK). If
you do not have the MQSeries software installed, the MQSeries
gateway will not be installed.
If you chose to install the Sterling Workflow Manager, you are
prompted to view the README.HTM file (click Yes and then close
the README when you are finished). If you chose to install the
Sterling Workflow Manager and you do not have Java Runtime
Edition Version 1.2 or higher installed on your machine, the system
prompts you to install JRE version 1.3 (click Yes and the system
installs JRE version 1.3).
If you chose to install the HTTP gateway on a machine that
previously had the HTTP gateway installed on it, Setup asks if you
want to keep the existing HTTP gateway database tables. If you click
Yes, Setup overwrites the current tables and you will lose all your
settings and data. If you click No, Setup does not overwrite the
existing tables.

Gentran:Server for Windows November 2005

Options Pack Installation Card How to Install Optional Components 7

(Contd)
Step Action

11 If you installed the HTTP gateway, Setup displays the Database

(contd.) Access dialog box to allow you to grant access to the Gentran:Server
database tables to a user or group of users that you have already set up
with your database management program. To grant access to the
Gentran:Server database tables to the group of users you created, type
EDIUSERS and click Next.
Note
This user/group must be a valid ID or the installation cannot be
completed. For SQL Server, the ID must be a valid Windows user or
group. For Oracle, the ID must a valid user ID (Windows groups are
not recognized by Oracle).
If you chose to install the HTTP Message Forwarder, Setup displays
the HTTP Message Forwarder dialog box to enable you to select
where the HTTP Message Forwarder will be installed. Click Browse
to select the path and then click Next.
When the components that you selected are installed, the system asks
you if you want to restart the services Setup stopped (click Yes if you
want to restart services or click No if you will restart the services
manually) and displays an Information dialog box that indicates
installation is complete.

Note
The Gentran:Server mailbox service may not start if you have not
upgraded one of the Gentran:Server extensions to ensure its version
complies with the newest release of the core product. If this service fails to
start, the system will inform you with a warning message (click OK).

12 Click OK at each of the information prompts to complete the installation

process and to exit Setup.

13 If the Gentran:Server Mailbox service failed to start, execute it manually

from your Windows Services dialog box.

Reference
See the documentation for your Windows operating system for more
information on how to start services.

14 If you are running Gentran:Server in a non-clustered environment, install

the Options Pack on each additional machine in your system: secondary
controllers first, followed by each Gentran:Server client.

If you are running Gentran:Server in a clustered environment, you need to

install the Options Pack on each node in your clustered system.

Gentran:Server for Windows November 2005

8 How to Install Optional Components Options Pack Installation Card

(Contd)
Step Action

15 Verify that the services on which the Gentran Executive service is

dependent are ordered correctly. The following services must be started
prior to initiating the Gentran Executive:
a. Gentran Audit Notification service
b. Gentran:Server Mailbox service
c. Gentran:Server Communications service (if installed)

Note
See the Administration Guide for more information on how to change
service dependencies.

16 If you are installing the Communications Gateway, use the Cluster

Administrator on the primary node to create a new resource for Gentran
Server Communications, which depends on the Gentran Server Mailbox
Service.

Reference
See your Microsoft documentation for more information on creating
cluster resources.

17 Using the Cluster Administrator on the primary node, move the Gentran
AUDIT NOTIFICATION service. This activity forces the replication of
the registry (containing Gentran:Server entries) on the other nodes in the
cluster.

Note
The move will report that the services fail and this is not a problem
because it still forces the registry keys to the other nodes.

18 Log on to another node in the cluster and change the preferred owner to
the node you are logged onto. Take the Gentran Service resources offline
and move the group to the current node.

19 Use the Options Pack Setup program to install the Options Pack on the
next node in your system.

Repeat Step 18 and Step 19 until Gentran:Server is installed on all nodes

in the cluster.

20 After installing the Options Pack, bring all cluster resources online.

Gentran:Server for Windows November 2005

Options Pack Installation Card How to Uninstall Optional Components 9

How to Uninstall Optional Components

Introduction Optional components may not be uninstalled separately from the Gentran:Server
systemyou must uninstall the Gentran:Server system.

Reference
See How to Leave (Uninstall) a Gentran:Server System in the Administration Guide for
more information on uninstalling Gentran:Server.

Gentran:Server for Windows November 2005

 10 How to Specify which Optional Components are Loaded in Mailbox Server Manager Options Pack Installation
Card

How to Specify which Optional Components are Loaded in

Mailbox Server Manager

Introduction This section describes how to specify which optional components are loaded in Mailbox
Server Manager, once you have installed optional components on the machines in your
system. You can specify either that no gateways are loaded on a machine or that only the
gateways you specify will be loaded in Mailbox Server Manager.

Note
This procedure is only valid after you have installed the Optional Components.

Procedure Use this procedure to specify which optional components are loaded in Mailbox Server
Manager.

Step Action

1 Start the Mailbox Server Manager.

2 Select the Mailbox Server.

Example
GentranMACHINE1

3 Right-click and select Properties.

System Response
The system displays the Mailbox Server properties dialog box.

4 Select the Startup tab.

5 Do you want gateways loaded on this machine?

If yes, select Load only these gateways and ensure that a check mark
is listed to the left of each gateway you want to be loaded on this
machine.
Note
Clear the checkmark to the left of any gateways you do not
want to be loaded.
If no (you do not want any gateways loaded on this machine), select
Do not load gateways.

6 Click OK to save your changes.

Gentran:Server for Windows November 2005

 11 Related Documentation Options Pack Installation Card

Related Documentation

Introduction These documents, which are available on the Gentran:Server Online Documentation
CD-ROM or from the ESD Portal download, provide additional sources of information:
Gentran:Server for Windows Users Guide and Administration Guide
These guides provide in-depth information about the Gentran:Server for Windows
core system.
Gentran:Server for Windows Communications Users Guide
This guide provides a high-level overview of the Gentran:Server for Windows
communications subsystem. It also describes File System Gateway and mailbox
configuration procedures, how to work with distribution lists and delivery agents,
error messages, and how to track messages.
Optional Component Guides
Each optional component that you purchase has its own documentation guide, which
contains product-specific information and configuration instructions.
Sterling Workflow Manager Getting Started
This guide provides you with information on the Sterling Workflow Manager.

Gentran:Server for Windows November 2005

12 Related Documentation Options Pack Installation Card

Copyright 19952005. Sterling Commerce, Inc. ALL RIGHTS RESERVED.

Gentran:Server is a registered trademark of Sterling Commerce. Windows,
Microsoft, and MS-DOS are registered trademarks of Microsoft Corporation.
Product names mentioned herein may be trademarks and/or registered trademarks
of their respective companies.

Third Party Software

Portions of the Sterling Commerce Software may include products, or may be distributed on the same storage media
with products, ("Third Party Software") offered by third parties ("Third Party Licensors").

Warranty Disclaimer

This documentation and the Sterling Commerce Software which it describes are licensed either "AS IS" or with a
limited warranty, as set forth in the Sterling Commerce license agreement. Other than any limited warranties provided,
NO OTHER WARRANTY IS EXPRESSED AND NONE SHALL BE IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR USE OR FOR A PARTICULAR PURPOSE. The applicable Sterling
Commerce entity reserves the right to revise this publication from time to time and to make changes in the content
hereof without the obligation to notify any person or entity of such revisions or changes.

The Third Party Software is provided 'AS IS' WITHOUT ANY WARRANTY AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. FURTHER, IF
YOU ARE LOCATED OR ACCESSING THIS SOFTWARE IN THE UNITED STATES, ANY EXPRESS OR
IMPLIED WARRANTY REGARDING TITLE OR NON-INFRINGEMENT ARE DISCLAIMED.

4232-510-INST03-0000

Gentran:Server for Windows November 2005