silktest

installation guide

August 25, 2005

A more current version of this document may be available at

http://customers.segue.com/downloads/products/silktest/update/documentation/readme_update_docs.htm

software quality optimization version

7.6
Copyright Notice
All Segue documentation and training materials are copyrighted, and all rights are reserved. Neither the software nor
any documentation that accompanies it may be reproduced, translated, or reduced to any electronic or printed form
without the prior consent of Segue Software, Inc., except as authorized in the terms of a valid license agreement.
© Copyright 1992 – 2005 Segue Software, Inc.
All Rights Reserved. Printed in the United States, August 2005.

Trademarks
E-Quality Partner, E-Quality Partner Program, 4Test, QA DBTester, QA Organizer, QA Partner, QA Radar,
QualityWorks, Segue, SilkCentral, SilkPilot, SilkMeter, SilkPerformer, SilkRadar, SilkRealizer, SilkTest, SilkVision,
Universal Testing Architecture (UTA), scenario testing, and E-Business Management System are trademarks or
registered trademarks of Segue Software, Inc.
All other product and company names are either trademarks or registered trademarks of their respective companies.

Warranties and Disclaimers

This publication is provided “as is” without warranty of any kind, either expressed or implied, including, but not
limited to, the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. Segue
assumes no responsibility for errors or omissions in this publication or other documents which are referenced in or
linked to this publication. This publication could include technical or other inaccuracies or typographical errors.
Changes are periodically added and will be incorporated in new editions of the publication. Segue may make
improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time.
Should you or any viewer of this publication respond with information, feedback, data, questions, comments,
suggestions or the like regarding the content of any Segue publication, any such response shall be deemed not to be
confidential and Segue shall be free to reproduce, use, disclose and distribute the response to others without limitation.
You agree that Segue shall be free to use any ideas, concepts or techniques contained in your response for any purpose
whatsoever including, but not limited to, developing, manufacturing and marketing products incorporating such ideas,
concepts or techniques. This publication is distributed internationally and may contain references to Segue products,
services, and programs that have not been announced in your country. These references do not imply that Segue
intends to announce such products, services or programs in your country.

Questions or comments
If you have any questions for our technical support staff, please fill out our Technical Support online form available
at http://support.segue.com/logcase.php. You can also phone 781.402.5900 (from North America) or +44 (0)
2890260001 (International). When you get in touch, please have your customer ID number available.
Segue software is covered by U.S. Patent Numbers
• 5,600,789
• 5,781,720
• 6,046,740
 Contents

Chapter 1 Introduction to SilkTest 5

Licensing with SilkMeter 5
About SilkTest 6

Chapter 2 Installing SilkMeter 11

Generating a SilkTest license policy 12
Installing SilkMeter on your license server 14

Chapter 3 Installing SilkTest 17

Before you begin 17
Installing SilkTest 18
Installing the SilkTest Agent for UNIX 23
Silent Installer 25
What to do next 29

SilkTest Installation Guide iii

iv SilkTest Installation Guide
 1
®
1e
rC
t
p
a
h Introduction to SilkTest

This chapter provides an overview of installing SilkTest and includes

installation guidelines, information about the release, and instructions on
contacting Segue Technical Support.

Licensing with SilkMeter

SilkTest employs Segue Software’s SilkMeter to control SilkTest product
usage. SilkMeter supports various combinations of concurrent as well as
metered use of software applications and offers flexibility in deploying
SilkTest. SilkTest uses the floating license capability of SilkMeter, in which
concurrent license usage is controlled. This means that client computers that
have SilkTest installed will connect to a network or local license server for
license policy administration.
Overview of the The following is an overview of licensing SilkTest using SilkMeter. Each of
installation process these steps are described in detail in this document.
SilkMeter license services can be configured and used in the following ways:
• Stand-alone
• License server
Stand-alone mode can be used when a license is needed only on a local
machine. Stand-alone mode is the easiest to use, so it is particularly well-
suited for product evaluation purposes.
1 Find the host ID or dongle ID of the computer that will be your license
server. See “Finding your host ID” on page 13. Note that you must have
the host ID of your license server, not the host name. If you do not know
the host ID, you can use the Host Info utility, smHostInfo.exe, to find the
host ID as described on page 13.

SilkTest Installation Guide 5

1 INTRODUCTION TO SILKTEST
About SilkTest

2 Access https://license.segue.com and follow the instructions to generate

a license policy for SilkTest and have the policy e-mailed to the address
that you specify.
3 Install SilkMeter on the computer that will be your license server, along
with your SilkTest license policy. See “Installing SilkMeter” on page 11.
4 Install SilkTest on your local machine. See “Installing SilkTest” on page
17.
Note SilkMeter only needs to be installed once per license server. If
you have multiple license servers, you will need multiple license
policy files, each one tied to a particular license server. A single
SilkMeter license server can administer license policies for multiple
Segue products.

About SilkTest
Supported Platforms For information on supported platforms for SilkTest, see the Release Notes.
SilkTest configuration We recommend:
recommendations
• A PC with a Pentium processor running at a minimum of 200 MHz.
• A hard drive with 82 MB of free space.
• In addition to the minimum Windows requirements, 64 MB of RAM.
Add to this the amount of RAM required to run your application under
test.
See “SilkMeter license server requirements” on page 14 for information
about license server requirements.
Important installation Upgrading If you are installing SilkTest 7.6 on a machine that already has a
guidelines previous version of SilkTest or QA Partner installed, you should uninstall
the older version before upgrading.

Dual-boot machines If you are installing SilkTest and have a dual-boot

machine with more than one Windows operating system, for example, both
Windows 98 and Windows NT, you must install SilkTest in different
directories under the two operating systems. Otherwise, you risk causing
problems with the Uninstall program. For example, if you want to install
SilkTest on both the Windows 98 and Windows NT partitions on a dual-boot
machine, install into c:\ and c:\, respectively.

6 SilkTest Installation Guide

 1 INTRODUCTION TO SILKTEST
About SilkTest

Windows NT, 2000 and XP You must have local administrator privileges
to install SilkTest on a Windows NT, 2000, or XP machine. Once SilkTest is
properly installed, any user can run it. If you are installing on a Windows NT,
2000, or XP server, you must have domain-level administrator privileges.

Forte, PeopleSoft or Developer 2000 extensions If you are installing

SilkTest and are currently using the Forte, PeopleSoft or Developer 2000
extensions, copy the associated files from your current SilkTest installation
directory to another location before uninstalling SilkTest. SilkTest no longer
supports these extensions. You may continue to use them; however SilkTest
does not install these extensions, so you must save the appropriate files
before uninstalling your current version of SilkTest. After installing SilkTest,
copy the files associated with the unsupported extension you are using to
<SilkTest installation directory>/extend.

Windows Millennium (Me) You must disable PCHealth and State

Manager, and then reboot your computer before installing SilkTest on
Windows Me. For details, see “Before you begin” on page 17.

Active Desktop You cannot perform testing when the Active Desktop
feature of Internet Explorer 4 Windows NT is installed. For information
about removing the Active Desktop, see Removing the Active Desktop in the
SilkTest online Help (SilkTest/Help/Help Topics). SilkTest can co-exist with
the Active Desktop in Windows 98, since it is an integral part of that
operating system.
Database testing To use the database testing functions (functions whose names begin with
functions DB_), you must have ODBC version 3 installed.
In addition, please ensure that an ODBC driver such as odbc32.dll (SQL
Server) or sqora32.dll (Oracle) is either on your path or in the System
directory in order for SilkTest to find it. The name of this DLL may vary,
depending on the specifications and vendor of your ODBC driver.
Items included with • SilkTest, for developing and running tests.
SilkTest
• SilkTest Agent, for translating 4Test method calls into GUI-specific
commands.
• The following documents, available from Start/Programs/SilkTest/
Documentation, if you chose to install the documentation:
- SilkTest Installation Guide
- SilkTest Extension Kit Guide for Windows, SilkTest Extension Kit
Guide for .NET, or Extension Kit Guide for UNIX (if you purchased
the Extension Kit)

SilkTest Installation Guide 7

1 INTRODUCTION TO SILKTEST
About SilkTest

- Testing AS/400 and Mainframe Applications with Blue Express and

Blue Express 4.7 Installation Guide (only if you purchased Blue
Express)
You must have Adobe Acrobat Reader to view .pdf documents. Updated
versions of all documentation may be available at http://www.segue.com/
downloads/products/silktest/update/documentation/readme_update_
docs.htm.
• Online Help topics, available from Start/Programs/SilkTest/SilkTest/
Help/Help Topics.
• Online Release Notes, available from Start/Programs/SilkTest/Release
Notes and from the SilkTest download area: https://www.segue.com/
support/technical-support/downloads.asp?pc=downloads-
silktest&pn=silktest_.
• Online Tutorials, available from SilkTest/Help/Tutorials and
Start/Programs/Documentation/SilkTest Tutorials.
• Sample applications: Simplified Chinese Test App, .NET 1.1 Test App,
TestApp, and TextEditor, as well as the following applications for use
with the Java tutorials: JavaAWT TestApp, JFC 1.0 Test Application, and
JFC 1.1 Test Application. You can access the Java tutorials, in addition to
other SilkTest tutorials, by clicking Help/Tutorials from within SilkTest
or by clicking Start/Programs/Documentation/SilkTest Tutorials.
• The Green Mountain Outpost (GMO) application for use with SilkTest’s
tutorials (Help/Tutorials):
- client/server version of the GMO application located in the
GMO folder on the SilkTest CD and available for download at
http://customers.segue.com/cgi-bin/download.asp?dir=/
downloads/sample_apps/GMO.
- Web-based version of the GMO application at
http://gmo.segue.com/.
• Extension Kit: if you purchased the Extension Kit, you must supply the
password in order to install it during the SilkTest installation. If you do
not know your password, please contact Customer Service at
customer_service@segue.com or call 781.402.6900.
• SilkTest Bitmap Tool
• Blue Express: for instructions on installing Blue Express, install SilkTest
and then refer to the Blue Express Installation Guide
(BlueExpInstall.htm), which is included in <SilkTest installation
directory>/Documentation if you purchase Blue Express.

8 SilkTest Installation Guide

 1 INTRODUCTION TO SILKTEST
About SilkTest

If you have purchased a license for a SilkTest Agent but not SilkTest itself,
then only the Agent, documentation, sample applications, and the SilkTest
Bitmap Tool are accessible after you install SilkTest.
Questions? Need help? All customers who are under a maintenance-and-support contract and
prospects who are evaluating Segue products are eligible for technical
support. If you have a question on this installation or on a technical topic,
Segue’s highly trained Technical Support staff will respond to your telephone
and e-mail requests as quickly and professionally as possible.
How to contact You can reach Technical Support by:
Technical Support
• Calling 781.402.5900 (from North America) or +44 (0) 28.90.260001
(International)
• Logging a Support Request at http://support.segue.com/logcase.php
What’s your Customer Please include your Customer ID in your e-mail or have it ready for your
ID? Technical Support representative, if you call. You can find your Customer ID
on the inside cover of this guide in your SilkTest shipment. After you install
SilkTest and your license policy, you can also find your Customer ID by
starting SilkTest and clicking Help/About SilkTest.

SilkTest Installation Guide 9

1 INTRODUCTION TO SILKTEST
About SilkTest

10 SilkTest Installation Guide

 2
2e
rC
t
p
a
h Installing SilkMeter

This chapter describes how to obtain a SilkTest® license policy and

install SilkMeter. You must have administrative privileges to install Silk-
Meter.

SilkMeter only needs to be installed once per license server. If you have
multiple license servers, you will need multiple license policy files, each
one tied to a particular license server. A single SilkMeter license server
can administer license policies for multiple Segue products.
We recommend the following, if you have:
• already received a SilkTest license policy associated with your
license server, see “Installing SilkMeter on your license server” on
page 14.
• not received a license policy yet, see the following section, “Gener-
ating a SilkTest license policy”.

Obtaining a Standard License for Free Evaluation

If you downloaded a free evaluation copy of SilkTest, you can request a
standard evaluation license by confirming your product evaluation as
described in the “welcome” e-mail you received from Segue after
downloading the evaulation software. An evaluation license will then be
mailed to you.
With the evaluation license you can run tests for a limited period of time.
When the granted time expires, the software will cease to work.

SilkTest Installation Guide 11

2 INSTALLING SILKMETER
Generating a SilkTest license policy

Generating a SilkTest license policy

You need a license policy to run SilkTest. You can use Segue’s online License
Generator to generate a license policy and have it automatically e-mailed to
the address that you specify. The online License Generator requires a SSL-
capable browser, such as Netscape 4.x or Internet Explorer 5.x.
The following is an overview of obtaining a license policy for SilkTest. Each
of these steps is described in detail beginning on page 13.
1 Find the host ID or dongle ID of the computer that will be your license
server. See “Finding your Host or Dongle ID” on page 13.
2 Access https://license.segue.com and log in using your Customer ID
and Access Code. Your Customer ID is the password you use to log in to
the protected area of the Segue Web site. You can find your Customer ID
and Access Code:
- in the e-mail you received announcing this release, if you are an
existing customer
- on the sticker on the inside cover of the hard copy of this guide
that you received in your shipment of SilkTest
Note If you don’t have an access code, or have forgotten your
access code, click the forgot your access code link on
https://license.segue.com to have your access code e-mailed to you.
3 Follow the instructions to generate a license policy for SilkTest and have
the policy e-mailed to the address that you specify. Save the license
policy to your license server computer.
Note If you chose to have the license policy sent to you in the body
of the e-mail message, rather than as an attachment (the default), cut
the license policy information from the e-mail message and save it in
a text file called license.pol on your license server.
4 Install SilkMeter, along with your SilkTest license policy, on your license
server computer. See “Installing SilkMeter on your license server” on
page 14.
5 Install SilkTest. See “Before you begin” on page 17.

12 SilkTest Installation Guide

 2 INSTALLING SILKMETER
Generating a SilkTest license policy

Finding your Host or Dongle ID

Finding your host ID To find the host ID of the Windows computer that will be your license server:
1 Locate smHostInfo.exe.
• If you have a SilkTest CD: proceed to Step 2.
• If you are downloading SilkTest:
- navigate to http://customers.segue.com/protected/bronze/
support/s_downloads_silkmeter.htm, type your Customer ID
and password in the User Name and Password boxes.
- Click smHostInfo.exe. Specify or navigate to your license
server computer, and then click Save. Make sure that you save
the file on your license server.
2 On your license server, click Start/Programs/Command Prompt and
then do the following:
• If you have a SilkTest CD: insert your CD in the license server
computer and then type the following in the Command Prompt
window:
<cddrive>:
cd silkmeter
• If you are downloading SilkTest: change to the directory in which
you copied smHostInfo.exe.
3 In the Command Prompt window, type smHostInfo.exe. The host name
and host ID of the license server appear. Note the host ID. You will need
to enter this information to obtain a license policy for SilkTest.
Finding your Dongle A dongle is a hardware device plugged into the parallel port of the computer.
ID This option is only available if you have purchased the dongle license option
from Segue.
The dongle ID is a four-character hexadecimal word printed on the dongle
device.

SilkTest Installation Guide 13

2 INSTALLING SILKMETER
Installing SilkMeter on your license server

Installing SilkMeter on your license server

Before you begin If you already have your SilkTest license policy, you can install it when you
install SilkMeter. To obtain a SilkTest license policy, access the online
License Generator. See “Generating a SilkTest license policy” on page 12 for
instructions.
A SilkTest license policy is not required to install SilkMeter on your license
server. Using the SilkMeter User Policy Administrator, you can import the
SilkTest license policy later. However, you must have imported your license
policy before you can run SilkTest. Note that if you are using more than one
SilkMeter license server computer, you will need a separate SilkTest license
policy for each SilkMeter license server.
SilkMeter license Make sure your license server meets the following requirements before
server requirements installing SilkMeter:
• Windows NT4 Service Pack 6a, Windows 2000, Windows XP, Windows
2003
• Internet Explorer 5.0 or higher (5.5 or higher recommended)
• Intel Pentium II/III/IV or equivalent CPU
• 256 MB RAM minimum
As of SilkMeter 2.3.5, there is no support for installation of SilkMeter on
Windows 95, 98, or Millennium platforms. You cannot use those machines as
SilkMeter servers for licensing SilkTest nor use them to check out mobile
licenses.
Uninstalling a If SilkMeter is already installed on your license server, you must uninstall it
previous version of before installing the latest version of SilkMeter.
SilkMeter
To uninstall SilkMeter:
1 Click Start/Programs/SilkMeter Runtime/SilkMeter Uninstall.
2 Click Yes to uninstall SilkMeter.
3 On the Remove Settings dialog, click No to keep your SilkMeter
settings. SilkMeter is uninstalled.
Note You must click No to preserve license policies that currently
exist on your SilkMeter license server.
4 Reboot your computer. You are now ready to install the latest version of
SilkMeter.

14 SilkTest Installation Guide

 2 INSTALLING SILKMETER
Installing SilkMeter on your license server

Installing SilkMeter on You must have administrative privileges to install SilkMeter. If SilkMeter is
your license server already installed on your license server, you must uninstall it before installing
the latest version of SilkMeter. See “Uninstalling a previous version of
SilkMeter” on page 14.
To install SilkMeter on your license server:
1 Locate silkmeter.exe:
• If you have a CD: insert your CD in the computer that will be your
license server and navigate to <cddrive>:\silkmeter.
• If you are downloading:
- Navigate to http://customers.segue.com/protected/bronze/
support/s_downloads_silkmeter.htm, type your Customer ID
and password in the User Name and Password boxes and click
OK.
- Double-click the latest silkmeter.exe, click Save, specify the
location to which you want to save this file, and then click Save.
Make sure that you save the file on your license server or a
location that your license server can access.
- Navigate to the location in which you saved silkmeter.exe.
2 Double-click silkmeter.exe.
3 Click Next on the Welcome dialog, review the License Agreement, and
then click Yes to accept the terms of the License Agreement.
4 On the Enter Installation Path and Configuration Directory for SilkMeter
Runtime window, click Next to install SilkMeter in the default directory,
C:\Program Files\Segue\SilkMeter, and use the default configuration
folder, C:\Program Files\Segue\cfg.
5 On the Enter Server Location window, select Install server on local
machine, and then click Next.
6 On the Edit Server Settings for Local Server dialog, enter or verify the
Local hostname and Port, and regardless of whether you are installing on
Windows NT or 2000, make sure Run as NT Service (this could appear
as Run as Service) is selected and then click Next. The hostname is the
name of the machine on which SilkMeter is installed.
7 On the Setup Type window, click Next to accept the default setup,
Typical.
8 On the Select Program Folder window, click Next to accept the default
Program folder, SilkMeter Runtime.

SilkTest Installation Guide 15

2 INSTALLING SILKMETER
Installing SilkMeter on your license server

9 Click No if you are prompted to install support for Rainbow Hardware

Keys.
10 If you:
• already have your SilkTest license policy, click the ellipsis (...) on
the Install SilkMeter Policy window, navigate to the location in
which you saved your SilkTest license policy file, license.pol, and
then click Open. Click Finish to install the SilkTest license policy,
and then click OK when the SilkMeter installation is complete.
Note: If you are installing on Windows 2000, reboot your computer.
• do not have your SilkTest license policy, click Finish, and then click
OK when the SilkMeter installation is complete. You can import
your SilkTest license policy when you receive it. See “Generating a
SilkTest license policy” on page 12 for instructions on obtaining a
SilkTest license policy. Instructions on importing your SilkTest
license file are available from the online License Generator and in
the SilkMeter Runtime online Help. If you are installing on
Windows 2000, reboot your computer after importing your SilkTest
license policy.
Note The SilkTest/SilkMeter communication process relies on the
following:
• SILK_CONFIG_PATH environment variable
• CosLicensingService.ref file
• CosPropertyService.ref file
• ls_segue.ref file
• silkmeter.cfg. file
Please do not delete them.

16 SilkTest Installation Guide

 3
®
3e
rC
t
p
a
h Installing SilkTest

This chapter describes how to install SilkTest and other components such as
the Agent and SilkTestRuntime.

Before you begin

If you are installing on a machine with a previous version of SilkTest or QAP
Partner, you must uninstall the previous version and reboot before installing
this release. To uninstall SilkTest, click the Windows Start button, then select
SilkTest Uninstall from the SilkTest program group. Make sure that you
remove any remaining SilkTest files and folders and reboot your machine
before installing SilkTest.
You may also set up silent installs for SilkTest, SilkTest Runtime, and the
SilkTest Agent; see “Silent Installer” on page 25 for more details.
You must have administrative privileges to install or uninstall SilkTest on
Windows NT or Windows 2000.
Before you install, make sure that the MSVCP60.dll file is installed in your
Windows System directory (windows\system or winnt\system32). SilkTest
requires this file in order to install correctly. This file should have already
been automatically installed as part of the standard Windows installation.
If MSVCP60.dll is not in your Windows System directory, use Windows
Explorer to search for the file, then copy it to the Windows System directory.
If you can’t find this file on your system:
• For Windows 2000, Windows ME, and Windows XP, search for the file
on your installation CD, or upgrade to the latest service pack.
• For Windows 95, 98, and NT, search for the file on your installation CD,
or download vcredist.exe from the Microsoft Web site. This free
executable file installs all of the required Visual C++ runtime libraries.

SilkTest Installation Guide 17

3 INSTALLING SILKTEST
Installing SilkTest

If you are installing If you are installing on Windows 95, search for the MSVCIRT.dll and
SilkTest on Windows MFC42.dll files; SilkTest requires these files in order to install correctly.
95 or Windows ME These .dlls are available from Microsoft or from your MSDN subscription. If
you do not already have them, copy them into your Windows System
directory.
If you are installing on Windows Millennium Edition (Me), you must
disable PCHealth and State Manager, then reboot your computer before
installing SilkTest.

Procedure To disable PCHealth and State Manager:

1 Select Start/Run, type msconfig, then click OK.
2 Select the Startup tab.
3 Clear (uncheck) the PCHealth and StateMgr check boxes, if they are
selected, then click OK.
4 Reboot your computer. You are now ready to begin the SilkTest
installation; see the following section, “Installing SilkTest”.

Installing SilkTest
Segue strongly recommends that you do not install SilkTestRuntime on the
same machine as SilkTest. SilkTestRuntime shares files with these products
and will overwrite any other SilkTest installation you already have on your
machine.
To install the SilkTest Unix Agent, see the instructions on page 23.

Procedure To install SilkTest, the SilkTest Agent only, or SilkTest Runtime:

1 Locate the SilkTest executable.
• If you have a SilkTest CD: insert your CD. If the Setup Program
does not start automatically, manually start the SilkTest Setup
Program by selecting Start/Run and typing <cddrive>:\setup.exe.
• If you are downloading SilkTest:
- Navigate to http://www.segue.com, then click the Downloads
link. Type your Customer ID and password in the User Name
and Password boxes, click OK, and then select the appropriate
SilkTest version you want to install.
- Click SilkTest.exe, then click Save.

18 SilkTest Installation Guide

 3 INSTALLING SILKTEST
Installing SilkTest

- Specify the location to which you want to save this file, and then
click Save. You can also run the file by from your browser by
double-clicking the .exe, if your browser supports this.
- Navigate to the location in which you saved the SilkTest.exe,
and double-click this file.
Note If your Windows TEMP environment variable does not point
to a valid directory, an error message will be displayed. In order to
successfully install SilkTest, your TEMP environment variable must
point to a valid directory.
To reset your TEMP environment variable:
a) Click Start/Settings/Control Panel and double-click the System
icon.
• On Windows 2000 or Windows XP, click the Advanced tab,
then click Environment Variables.
• On Windows NT, click the Environment tab.
b) Under User Variables or System Variables, double-click the
TEMP variable.
c) Enter a valid directory, then click OK.
d) Restart the SilkTest installation by double-clicking the .exe file.
2 Click Next on the Welcome dialog box, review the License Agreement,
then click Yes to accept the terms of the License Agreement.
3 On the SilkTest Licensing dialog box, click Next. This dialog is provided
for informational purposes only. The SilkTest installer checks for files on
your machine to determine whether references to a license server already
exist or need to be created at this point.
4 Based on the license reference check:
• If the SilkTest installer finds existing references to a SilkMeter
license server, the Select SilkMeter Setup Options dialog box is
displayed. This occurs if you have already installed SilkTest, if you
have already set up your SilkMeter license server, or if you have
installed other Segue products that use SilkMeter for licensing. A
single SilkMeter license server can administer license policies for
multiple Segue products.
Use the radio buttons to specify whether you want to use your
existing SilkMeter license server or create a reference to a new
SilkMeter license server, then click Next.
• If the SilkTest installer does not find references to a SilkMeter
license server, or if you selected Set up server on the Select
SilkMeter Setup Options dialog box, you must specify a new license
SilkTest Installation Guide 19
3 INSTALLING SILKTEST
Installing SilkTest

server. Type the Hostname of your SilkMeter license server (the

hostname is the name of the machine on which SilkMeter is
installed), modify the Port number if port 5461 is already in use, and
then click Next. You must enter a Hostname and Port number; the
Setup Program cannot continue without this information.
In some cases, specifying the simple name of the license server in the
Hostname field -- licenseserver, for example -- may not work. If this is
the case, a message stating that there is no license server running on the
Hostname you specified will be displayed. Re-specify the Hostname
using a fully qualified name, such as licenseserver.segue.com.
5 Click Next on the Choose Destination Location dialog box to accept the
default Destination Folder in which SilkTest will be installed, or click
Browse to specify a different folder.
If you specified a location in which SilkTest was previously installed and
some of the files remain in this directory, you may receive an error
message instructing you to uninstall SilkTest, make sure all files are
removed, and then reboot and install SilkTest.
6 On the Setup Type dialog box, select one of the following installation
options:
• Click Next to install the full installation of SilkTest, including the
SilkTest Windows Agent. The full installation enables you to record,
script, execute, and view the results of tests.
• Select SilkTest Agent Only, then click Next if you only want to
install the SilkTest Agent software. You install just the SilkTest
Agent on machines that are used for distributed testing. To install the
SilkTest Unix Agent, see the instructions on page 23.
• Select SilkTest Runtime, then click Next if you want to install
SilkTest Runtime and the SilkTest Agent. You use SilkTest Runtime
to execute a set of tests and view the results.
Note We recommend that you install SilkTest and SilkTest Runtime
on different machines. However, if you choose to install both
products on the same machine, make sure to install them in the same
folder to prevent having duplicate files on a single machine. If both
products are installed on the same machine, uninstalling either
SilkTest or SilkTest Runtime will uninstall both products, regardless
of whether or not they are installed in the same folder.
7 On the SilkTest Products Selection dialog box, select the items you want
to install, then click Next.

20 SilkTest Installation Guide

 3 INSTALLING SILKTEST
Installing SilkTest

8 On the Start Copying Files dialog box, review your settings. Click Back
if you want to modify any of your settings, otherwise click Next to
continue with the SilkTest installation.
Tip If a message appears stating that there is not enough space
while files are copying, redefine the TEMP area to a drive that
contains more space. The installer uses the TEMP area for unzipping
files. For example, if your TEMP area is d:\temp and you are
installing to e:\silktest, the E drive may contain enough space for the
installation, but the D drive is the limiting factor.
9 Depending on your product selections and the platform on which you are
installing, the Setup Program may display the following messages:
• If you are installing the Extension Kit, a message prompts you to
enter your password. If you do not know your password, contact
Customer Service at 781.402.6900.
• If you are installing on Windows 95 or Windows 98, a message
indicates that Setup is inspecting the GDI32.DLL file. A message
appears, indicating that after rebooting, Setup will modify
GDI32.DLL in the Windows System directory and copy the original
file to the Segue subdirectory of the Windows System directory.
Take note of this information and click OK.
• If you are installing on Windows 95, you may receive an error
message saying the MSVCIRT.dll and/or the MFC42.dll file are
missing. These files are available from Microsoft or your MSDN
subscription; copy them into your Windows System directory, then
restart the SilkTest installation.
10 Select a default language for testing browsers. The browser Include (.inc)
file for the language you select will be installed to your <SilkTest
installation>\Extend directory. All browser include files are installed in
your <SilkTest installation>\Locale directory; to switch to another
language later, see the online Help.
11 If you will be testing Web applications, verify your default browser, then
click Next. If you want to specify a different default browser for
SilkTest, select the appropriate browser. If you are not testing a Web
application, select None, then click Next.
Note The Setup Program preselects the radio button in this dialog
based on browser settings on your machine. (If you are using
Internet Explorer, it displays only the version of IE installed on your
machine.) The Setup Program uses this information to set the
appropriate browser extension and let the recovery system know
which browser it should invoke.

SilkTest Installation Guide 21

3 INSTALLING SILKTEST
Installing SilkTest

For example, if your default browser is Internet Explorer 6.0, the Setup
Program preselects Internet Explorer 6.x DOM (Document Object
Model). Note that the default browser extension for IE 6.x is DOM; if
you want to use the Virtual Object (VO) extension, you must select it.
We recommend the DOM extension for new customers and the VO
extension for existing customers who have not yet switched to the DOM
extension.
You can change your default browser at any time through the SilkTest
Runtime Options dialog. Refer to the SilkTest online Help for
instructions on changing your default browser or browser extensions
after installation.
Note If your default browser is Internet Explorer 6.x, you may
receive a message that your browser’s third-party extensions are not
enabled. You must enable this option in order for SilkTest to
recognize objects in browser pages. You can enable this option and
then continue with the installation, or you can wait and enable the
option after the installation is complete. To enable third-party
browser extensions:
a) On the Tools Menu in Internet Explorer, click Internet Options.
b) Click the Advanced tab.
c) Under Browsing, select the Enable third-party browser
extensions (requires restart) check box, then click OK.
d) Restart your browser by closing and reopening the browser
window. You do not have to reboot your computer for the new
setting to take effect; just close and reopen the browser window.
12 On the SilkTest Results Logging window, click Next. This dialog is for
informational purposes only and gives a brief introduction to the Results
Repository installer and demonstration-only Results Viewer. For more
information, see the online Help.
13 On the Select Program Folder dialog box, specify a program folder for
SilkTest, or click Next to accept the default, SilkTest. Please wait while
Setup updates the registry.
14 The Associate SilkTest Files dialog box will be displayed.
• Accept the default selection, Yes, to associate SilkTest file types
(*.inc, *.t, *.g.t and *.pln files) with SilkTest. If you double-click
one of these SilkTest file types, SilkTest opens that file.
• Select No if you would rather not associate SilkTest files with
SilkTest. If you select this option, double-clicking one these file
types will not open the file in SilkTest (but you could still start
SilkTest and open the file from within SilkTest).

22 SilkTest Installation Guide

 3 INSTALLING SILKTEST
Installing the SilkTest Agent for UNIX

Click Next to continue.

15 On the next dialog box, use the radio buttons to specify whether you
want like to associate SilkTest files with either SilkTest or SilkTest with
SilkCentral Test Manager, then click Next to continue.
16 Click Finish to exit the InstallShield Wizard and restart your computer.
You must reboot for SilkTest to work properly.
Please see the Release Notes for up-to-date information about running
SilkTest.
A working network connection is required when running SilkTest with a
remote SilkMeter license server. If you need to verify that the network is
working, click Start/Run, and then type ping localhost or ping <license
server name>, or open a command prompt and type either of those
commands.

Installing the SilkTest Agent for UNIX

Before you install the SilkTest Agent for UNIX, you must install SilkTest 7.6
on a Windows machine, as described in the preceding section.You must also
uninstall previous SilkTest Agents (if any), as described below.
Uninstall previous 1 Locate the number of any running Agent processes.
SilkTest Agents
• On Linux, enter ps -axuw | grep agent
• On Solaris, enter ps -eaf | grep agent
This command generates a list of all instances of the Agent that are
currently running on the machine. The output list includes the ID number
of the Agent process. Look for the line item that contains the correct
username and port number.
If there are no Agent processes running, you may skip to step #3.
2 Stop any running Agent processes by entering kill -9 AgentID# where
AgentID# is the process number you found in step #1. If there are
multiple instances of the Agent running, be sure to select the correct one.
If the Agent is running, you will not be able to delete the directory
structure.
3 Delete the Agent files and folders by entering rm -rf SilkTest from the
Agent install directory.
Now that you have uninstalled any previous SilkTest UNIX Agents, you are
read to install the SilkTest 7.6 UNIX Agent.

SilkTest Installation Guide 23

3 INSTALLING SILKTEST
Installing the SilkTest Agent for UNIX

Install the SilkTest If you have a previous version of the SilkTest Agent installed, we strongly
Agent on a Solaris or recommend that you uninstall it (described above) before you follow these
Linux machine steps.
The SilkTest UNIX Agent install creates a directory named "SilkTest" in the
location where you decompress the .tar.gz file as described in Step 2 below.
This SilkTest directory contains all of the Agent-related files, including a
SilkTest/demo directory which contains the Motif Test Application.
1 Locate the SilkTest UNIX Agent executable.
• If you have a SilkTest Agent for UNIX CD, insert your CD.
• If you are downloading, navigate to http://www.segue.com, then
click the Downloads link. Type your Customer ID and password in
the User Name and Password boxes, click OK, and then select the
appropriate version of the Agent you want to install.
2 Copy the appropriate install file to the location on the Solaris or Linux
machine where you want to install the Agent. On the download area,
there are three different files listed, but you copy only one, depending on
what operating system is running on your UNIX machine:
• For Linux 2.1, copy linux21.tar.gz
• For Linux 3.0, copy linux30.tar.gz
• For Solaris 9 or 10, copy solaris.tar.gz
3 This step installs the Agent under the current directory, so be sure to first
navigate to the desired directory. Decompress the .tar.gz file that you
copied:
• For Linux 2.1, enter tar -xvpzf linux21.tar.gz
• For Linux 3.0, enter tar -xvpzf linux30.tar.gz
• For Solaris 9 or 10, enter gtar -xvpzf solaris.tar.gz
4 Set up the SilkTest environment variables required by the SilkTest Agent
by running a set_env script. The script establishes the basic runtime
environment for the Agent. You can modify these scripts as desired for
your environment, but remember to first make backup copies if you plan
to do so.

24 SilkTest Installation Guide

 3 INSTALLING SILKTEST
Silent Installer

You run the script that corresponds to the type of shell you are running,
either c shell or Bourne shell. To set up the environment, enter the
following in the SilkTest directory:
• For c shell, enter source set_env.csh
• For Bourne shell, enter set_env.sh
There is no visual confirmation that the shell script was successful. The shell
script does not output any values; it simply returns you to the Command
prompt.
See the release notes for more information about licensing this Agent.

Silent Installer
During a typical user-driven installation, the install process gets its
information from a user responding to dialog boxes. However, during a silent
installation, the installation process gets its information from an InstallShield
Silent Response file (.iss file). To create an .iss file, you run the SilkTest
setup.exe from the command line using a special switch to create this file.
This file may then be used in future “silent” SilkTest installations. You can
set up silent installs of SilkTest, SilkTest Runtime, and the SilkTest Agent.
For best results, we highly recommend setting up the Silent Installer on a
machine that has the same configuration for the machine(s) that you want to
install SilkTest on. For example, if you will want to run the Silent Installer for
SilkTest Runtime on Windows 2000 machines, use the steps below to set up
Silent Installer on a Windows 2000 machine.
SilkMeter is Segue’s licensing tool; when you run the Silent Installer it
“skips” detecting a SilkMeter server. If you have not already configured your
license server, you may have to do so after you install SilkTest with the Silent
Installer. See “Configuring SilkMeter with the Silent Installer” on page 29 for
more details.
The Silent Installer is not supported on Windows 95, Windows 98, or
Windows ME (Millennium).
Overview of setting up In brief, here are the steps to setting up and using the Silent Installer.
the Silent Installer
1 Install SilkTest from the command line using Silent Installer options.
2 After the SilkTest installation is complete, check the log file to verify
that the .iss file was successfully created.
3 Make the replay file (*.iss) and SilkTest installation files available for
whoever needs to run the Silent Installer.

SilkTest Installation Guide 25

3 INSTALLING SILKTEST
Silent Installer

4 Execute the Silent Installer replay file to install SilkTest.

These steps are described in the sections below.

Install SilkTest from the command line

When you install SilkTest from the command line you can use special options
to instruct the Silent Installer to create a file with your responses (*.iss) and a
log file (setup.log).
You can install SilkTest with the Silent Installer options as long as you have a
connection to the SilkTest 7.5 (or above) installation files; this means you
must have:
• access to the installation CD, or
• a drive mapped to a location that contains the installation files, or
• downloaded the installation files from the Segue download area
As with any SilkTest installation, we strongly recommend that you first
uninstall any previous versions of SilkTest.

Procedure To install SilkTest with Silent Installer options

1 At the command prompt, navigate to the directory where the SilkTest
install files are located. For example, if you have saved the SilkTest
installer from the download area, enter: cd: c:\program
files\segue\silktest
2 At the command prompt create an .iss file by running InstallShield in
record mode by entering setup.exe /r /f1c:\silktest.iss where
• setup.exe is the name of the SilkTest executable you have
downloaded
• /r instructs InstallShield to create an .iss response file
• /f1 (number one, not lower case letter “L”) indicates the location and
filename where you want to save the .iss file. There are no spaces
between /f1 and the location + filename. The example above saves
the .iss file to the root directory of the c:\ drive.

26 SilkTest Installation Guide

 3 INSTALLING SILKTEST
Silent Installer

3 Respond to the SilkTest install dialogs and prompts. While you do so, the
Silent Installer records your selections, including reboots. Keep in mind
that it is not a true “recorder”; if you leave the installer and start up a
different task, it will not record those keystrokes.
If you want to create a Silent Installer for SilkTest Runtime or for the
Agent, be sure to select those installation options. Be sure to respond
“yes” to the reboot question, if you want the Silent Installer to reboot the
other computers.
Now that you have set up the Silent Installer, you can run it to install
SilkTest.

Running the Silent Installer to install SilkTest

Procedure To run the Silent Installer:
1 Copy the SilkTest installation directory contents from the CD or web.
2 Copy the .iss file into the SilkTest installation directory.
3 At the command line, change to the SilkTest installation directory and
enter the following
setup.exe /s /f1c:\silktest.iss /f2i:\silktestinstall\setup.log
/s puts the installer into silent mode
/f1 indicates where to find the .iss response file, in this case the .iss
response file is in the root directory of the C:\ drive
/f2 indicates where to write the setup log, in this case in the silktestinstall
folder in the i:\ directory. This log file indicates whether the installer
succeeded or failed to install properly.
You may see increased hard disk activity while the installation proceeds.
To verify if the installation was a success, do one of the following:
• start SilkTest and check the version number by selecting Help/About
• examine the log file as described below

Examining the log file

When you run the Silent Installer, you may not see any messages or SilkTest
dialog boxes and so it is difficult to know whether the installation was a
success. You can, however, look at the “setup.log” which InstallShield

SilkTest Installation Guide 27

3 INSTALLING SILKTEST
Silent Installer

creates listing installation information, including the ending status of the

install. The “Sample log file” on page 29 shows the results of a successful
installation.
We strongly recommend examining the log file and testing the Silent Installer
by running it before you make it available for others to use.

Procedure To verify that the silent installer was successful:

1 Browse to and open the setup.log file. This file is located wherever you
saved it in Step #3 of “Running the Silent Installer to install SilkTest”
above.
2 Navigate to the [ResponseResult] section. A zero value for the return
value of the ResultCode keyname indicates whether or not the Silent
Installer succeeded.
Possible return values for the Result Code keyname are:

Value Meaning
0 Success
1 General error
2 Invalid mode
3 Required data not found in the Setup.iss file
4 Not enough memory available
5 File does not exist
6 Cannot write to the response file
7 Unable to write to the log file
8 Invalid path to the InstallShield Silent
response file
9 Not a valid list type (string or number)
10 Data type is invalid
11 Unknown error during setup
12 Dialogs are out of order
51 Cannot create the specified folder
52 Cannot access the specified file or folder
53 Invalid option selected

28 SilkTest Installation Guide

 3 INSTALLING SILKTEST
What to do next

Sample log file A setup.log file for a successful silent installation of InstallShield is shown
below. Notice that the ResultsCode is equal to zero, indicating a successful
install.
[InstallShield Silent]
Version=v5.00.000
File=Log File
[Application]
Name=InstallShield5
Version=5.00.000
Company=InstallShield
[ResponseResult] ResultCode=0

Configuring SilkMeter with the Silent Installer

After you run the Silent Installer, you may have to configure your SilkMeter
connection before you can use SilkTest. SilkMeter supports various
combinations of concurrent as well as metered use of software applications
and offers flexibility in deploying SilkTest licenses.

Procedure To configure your SilkMeter connection:

1 Select Start/Programs/SilkTest/Change your License Server
Configuration.
2 Follow the directions on the dialog to select the SilkMeter license server
that Segue products will use for licensing.

What to do next
Install Blue Express If you purchased the Blue Express Agent, you should install it now. Follow
the instructions in the Blue Express Installation Guide; click Start/
Programs/SilkTest/Documentation/Blue Express Install Documentation.
Obtain software Segue provides a Web-based update system. After completing the
updates on the Web installation, browse the password-protected download area of Segue’s Web
site, http://customers.segue.com/protected/bronze/support/s_downloads.htm, to
see if an update needs to be applied to this release. You can also check for
updated documentation which may be available at http://customers.segue.com/
downloads/products/silktest/update/documentation/readme_update_docs.htm.
Explore the online Segue Technical Support hosts a knowledge base, customer forums, and the
Knowledge Base latest news about Segue products at http://support.segue.com/home.php.

SilkTest Installation Guide 29

3 INSTALLING SILKTEST
What to do next

Enable applications If you are testing applications that use controls other than the Microsoft
Foundation Class (MFC) library, you may need to enable support for the
development language in which the controls were created. The installation
program enables the development environment when it knows the test
application’s underlying executable name. You might have to enable some
applications yourself, for example, .NET applications, all stand-alone Visual
Basic applications, ActiveX controls used outside the browser environment,
and applications with embedded browser controls. For information about
enabling applications, see the online Help.
Try the tutorials If you’re new to SilkTest, we recommend that you try the SilkTest tutorials,
available from Start/Programs/SilkTest/Documentation/SilkTest
Tutorials.

30 SilkTest Installation Guide