Silk Test Install Guide

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 Licensing with SilkMeter About SilkTest 6

Chapter 2

Installing SilkMeter

5

5

11

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

Chapter 3

Installing SilkTest

14

17

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

23

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 installation process

The following is an overview of licensing SilkTest using SilkMeter. Each of 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 wellsuited 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 recommendations

We recommend: •

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 guidelines

Upgrading If you are installing SilkTest 7.6 on a machine that already has a 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 functions

To use the database testing functions (functions whose names begin with 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

•

SilkTest, for developing and running tests.

•

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=downloadssilktest&pn=silktest_.

8

•

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 [email protected] 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.

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 Technical Support

You can reach Technical Support by: • •

What’s your Customer ID?

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

Please include your Customer ID in your e-mail or have it ready for your 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 SilkMeter. 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, “Generating 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 SSLcapable 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.

12

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.

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

2

3

Finding your Dongle ID

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.

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: : cd silkmeter

•

If you are downloading SilkTest: change to the directory in which you copied smHostInfo.exe.

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.

A dongle is a hardware device plugged into the parallel port of the computer. 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 server requirements

Make sure your license server meets the following requirements before 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 previous version of SilkMeter

If SilkMeter is already installed on your license server, you must uninstall it before installing the latest version of 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

14

Reboot your computer. You are now ready to install the latest version of SilkMeter.

SilkTest Installation Guide

2 INSTALLING SILKMETER Installing SilkMeter on your license server Installing SilkMeter on your license server

You must have administrative privileges to install SilkMeter. If SilkMeter is 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 :\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 SilkTest on Windows 95 or Windows ME

If you are installing on Windows 95, search for the MSVCIRT.dll and MFC42.dll files; SilkTest requires these files in order to install correctly. 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

18

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 :\setup.exe.

•

If you are downloading SilkTest:

SilkTest Installation Guide

-

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.

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

20

On the SilkTest Products Selection dialog box, select the items you want to install, then click Next.

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.

22

•

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).

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 , 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 SilkTest Agents

1

Locate the number of any running Agent processes. •

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 Agent on a Solaris or Linux machine

If you have a previous version of the SilkTest Agent installed, we strongly recommend that you uninstall it (described above) before you follow these 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

2

3

4

24

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.

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

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

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.

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 the Silent Installer

In brief, here are the steps to setting up and using 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

26

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.

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:

28

SilkTest Installation Guide

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

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 updates on the Web

Segue provides a Web-based update system. After completing the 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 Knowledge Base

Segue Technical Support hosts a knowledge base, customer forums, and the 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