installation guide

SilkPerformer®

2007

Installation Guide

Borland Software Corporation20450 Stevens Creek Blvd., Suite 800Cupertino, California 95014 USAhttp://www.borland.com

Borland Software Corporation may have patents and/or pending patent applications covering subjectmatter in this document. Please refer to the product CD or the About dialog box for the list of applicablepatents. The furnishing of this document does not give you any license to these patents.

Copyright © 1992-2007 Borland Software Corporation and/or its subsidiaries. All Borland brand andproduct names are trademarks or registered trademarks of Borland Software Corporation in the UnitedStates and other countries. All other marks are the property of their respective owners.

August 2007 PDF

ContentsContents

Introduction 1Overview . . . . . . . . . . . . . . . . . . . . . 1Pre-Installation Requirements. . . . . . . . . . . 2Contents of the Installation CD . . . . . . . . . . 5

Chapter 1Installing SilkPerformer 9

Overview . . . . . . . . . . . . . . . . . . . . . 9Complete Installation . . . . . . . . . . . . . . 10Agent Only Installation . . . . . . . . . . . . . 16Advanced Installation . . . . . . . . . . . . . . 18Upgrading to a SilkPerformer Service Pack Release

24SilkPerformer Maintenance . . . . . . . . . . . 25SilkPerformer Silent Mode Installation . . . . . 26Installing ShopIt V 6.0 . . . . . . . . . . . . . . 27

Chapter 2Licensing SilkPerformer 31

Overview . . . . . . . . . . . . . . . . . . . . 31SilkPerformer Evaluation Version . . . . . . . . 32Obtaining a License for SilkPerformer . . . . . 32

Chapter 3Installing SilkPerformer SOA Edition 35

Overview . . . . . . . . . . . . . . . . . . . . 35SOA Edition for Java Installation . . . . . . . . 36SOA Edition for .NET Installation . . . . . . . . 39SOA Edition Advanced Installation . . . . . . . 43SOA Edition Agent Only Installation . . . . . . 47SilkPerformer Maintenance . . . . . . . . . . . 50

Chapter 4Licensing SilkPerformer SOA Edition 53

Overview . . . . . . . . . . . . . . . . . . . . 53SilkPerformer SOA Evaluation Version . . . . . 54Obtaining a Custom License . . . . . . . . . . 54

Chapter 5Installing Agent Software on Remote Computers 57

Overview . . . . . . . . . . . . . . . . . . . . 57Remote Installation . . . . . . . . . . . . . . . 58

Index 69

SilkPerformer Installation Guide iii

iv SilkPerformer Installation Guide

Introduction

About this manual This manual provides all the information you need to install and uninstall SilkPerformer software and to prepare the load testing environment. It suggests pre-installation hardware and software requirements and offers alternative installation options.

What you will learn This chapter contains the following sections:

Overview

SilkPerformer Setup Wizard provides several options for installing and creating a load testing environment.

Before you can install SilkPerformer, the Setup Wizard confirms that all the software you need for installation and use of SilkPerformer is available on your computer. If it is not, the Setup Wizard provides options for installing the missing software. You can also access the installation programs for these optional programs using Windows Explorer, as they are readily available on the installation CD.

SilkPerformer software can be installed in two versions. On the controller computer you can install both the Multi-Machine controller and agent software, which includes documentation and sample files. Agent computers only need to have agent software installed on them. To perform load tests with SilkPerformer, you need to install the controller software on at least one controller computer.

Section Page

Overview 1

Pre-Installation Requirements 2

Contents of the Installation CD 5

SilkPerformer Installation Guide 1

INTRODUCTIONPre-Installation Requirements

Depending on the intended type of installation, there are a number of required and recommended installation options, which are described in the following section.

Pre-Installation Requirements

Each computer that is to be used in a load test must meet the following minimum hardware and software requirements:

Hardware requirements

To install agent software, or both controller and agent software, and use the full potential of SilkPerformer to run heavy load-tests, your system must meet the following minimum requirements:

Load Testing • Processor: Pentium IV or equivalent CPU• RAM: 512 MB (1024 MB recommended)• Virtual memory: Three times as much virtual memory as RAM• Network: Windows network with TCP/IP (when using remote

SilkPerformer agent computers)• Network adapter: 10 MBit (fast Ethernet recommended)

Recording, Monitoring, and ScriptingTo use SilkPerformer functionality only for traffic recording purposes, monitoring and scripting, the following minimum system requirements are sufficient:• Processor: Pentium IV or equivalent CPU• RAM: 256 MB • Network: TCP/IP

Software requirements To install and use SilkPerformer your system requires a minimum set of pre-installed components. The specific components that are required varies based on installation type (e.g., to run SilkPerformer Java Explorer your system must be equipped with a Java 2 SDK). All required components are included on the SilkPerformer Installation CD. Components can also be downloaded from their respective vendors’ Web sites.

2 SilkPerformer Installation Guide


Supported Operating SystemsYour computer must run one of the following operating systems:• Windows 2003• Windows XP (Service Pack 1 or higher recommended)• Windows 2000 (Service Pack 2 or higher)

SilkPerformer cannot be installed on computers running Windows 95, 98, or ME. Windows NT is not supported.

Internet Explorer To install and use the full functionality of SilkPerformer Multi-Machine Controller, you must have Microsoft Internet Explorer (version 5.0.2919 or higher) installed on your computer. This is not however required for agent-only installations.

Adobe Acrobat Reader You need a PDF viewer to view the documentation that’s provided with SilkPerformer.

If neither a PDF viewer or Adobe Acrobat Reader is available, you can download the Adobe Acrobat Reader from the Adobe home page.

As documents are not included in agent installations, PDF viewer installation is required only for controller computer installations.

PowerPoint Viewer To run SilkPerformer PowerPoint presentations (.pps files) you need to have either a full PowerPoint installation or a PowerPoint Viewer installed on your machine. Microsoft’s PowerPoint Viewer is included on the Installation CD (\Redist\PPViewer\PPView97.exe).

As documents are not included in agent installations, PowerPoint Viewer installation is required only for controller computer installations.

.NET Runtime Environment

To run a program built upon Microsoft’s .NET technology, your system must be equipped with Microsoft’s .NET Runtime Environment. It is recommended that you use .NET Runtime Environment 1.1.If not yet installed on your system, please run the set-up program for the .NET runtime environment.

The .NET Runtime Environment setup is available on the SilkPerformer CD at: \redist\DotNetRuntime\dotnetfx11.exe. You may also download the setup directly from Microsoft by doing the following:1 Go to http://www.microsoft.com/downloads/

details.aspx?FamilyID=262D25E3-F589-4842-8157-034D1E7CF3A3&displaylang=en.

2 Follow the instructions on the Web page.


http://www.microsoft.com/downloads/details.aspx?FamilyID=262D25E3-F589-4842-8157-034D1E7CF3A3&displaylang=en



http://www.adobe.com/products/acrobat/readstep2.html

http://www.adobe.com/products/acrobat/readstep2.html


SilkPerformer .NET Explorer requires the Microsoft .NET Runtime Environment.

Java Runtime Environment

To monitor JMX/JVM with Silk Performance Explorer, your system must be equipped with the Java runtime environment. The minimum version required is 1.4.

If not yet installed on your system, please run the set-up program for the Java runtime environment.

Note Java runtime environment must be installed prior to installing SilkPerformer. If you install the Java runtime environment after installing SilkPerformer, you need to re-run the SilkPerformer setup.

Citrix ICA Client SilkPerformer uses the Citrix ICA Simulation Client to generate Citrix traffic.

Before defining a Citrix project you must install the Citrix client software. You have two options for installing a Citrix client:• Install Citrix client software from the SilkPerformer installation CD

a Browse to and select \Redist\Citrix Client\ica32.msib Execute the Citrix setup program and edit default options as required

• Download Citrix client software from the Citrix Web site: http://www.citrix.com

Java Development Kit To run SilkPerformer Java Explorer your system must be equipped with a Java 2 SDK. The minimum version required is 1.2.x.

To test Web services, the minimum required version is 1.3.x.IBM WebSphere EJB’s require an IBM JDK, preferably the one that is delivered with the WebSphere installation.

You can download a Java 2 SDK from http://java.sun.com

WAP2 Add-On To take full advantage of SilkPerformer’s WAP support, supplement your SilkPerformer installation with the SilkPerformer WAP2 Add-On. This Add-On includes full support for WTLS.

Note Due to shipping restrictions, the Add-On is not provided with the SilkPerformer installation CD-ROM. The Add-On must be downloaded from the Customer Support Web site (see URL below).

To download and install the WAP2 Add-On:1 Navigate to https://customers.segue.com/downloads/products/

SilkPerformer/version/2006/packages/WAP2Addon.exe.2 If requested, type your Customer ID and password in the User Name and

Password boxes and click Login.3 Save the file (WAP2Addon.exe) to a directory of your choice.


https://customers.segue.com/downloads/products/SilkPerformer/version/2006/packages/WAP2Addon.exe

https://customers.segue.com/downloads/products/SilkPerformer/version/2006/packages/WAP2Addon.exe

http://java.sun.com

http://www.citrix.com

INTRODUCTIONContents of the Installation CD

4 Visit Borland support at http://support.borland.com to obtain a the password for the WAP2 Add-On.

5 Execute the WAP2Addon.exe file on a computer on which a SilkPerformer controller has been installed. Enter the password you obtain from Borland support. The self-extracting archive will detect where SilkPerformer is installed on your machine and will automatically provide a number of additional files.

Note Install the WAP2 Add-On before you use SilkPerformer's Remote Agent Setup to install or upgrade SilkPerformer Agent software on remote computers. If SilkPerformer Agent software already exists on remote agent computers, use the Remote Agent Setup upgrade facility to provide the WAP2 Add-On to your remote agent computer.

Administrator privilegesTo install SilkPerformer, you need to have administrator privileges on your computer. Otherwise you will receive an error message when the Windows Installer service opens the installation package and performs initial requirement checks.

Contents of the Installation CD

This section provides an overview of the programs that are included on the installation CD. You need these programs to create a full load testing environment with SilkPerformer. By default, you can install missing programs using the Setup Wizard, but if you wish to install a component separately, this section indicates where you can find the appropriate executable for a particular installation program.

ShopIt V 6.0Installation of the ShopIt V 6.0 sample Web application can be run from the following folder:

\Extras\ShopItV60.exe


http://support.borland.com


Windows Installer ServiceInstallation of Windows Installer Service version 1.10 can be run from the following folder:

\Redist\MSIIntel.SDK\instmsi.exe

SilkMeterThe SilkMeter installer can be run from the following folder:

\SilkMeter\SilkMeter.exe

This folder also contains a program that helps you find information about your computer that you will need when you contact Borland to obtain a SilkMeter license (smHostInfo.exe).

Citrix ICA ClientInstallation of the Citrix ICA Client can be run from the following folder:

\Redist\Citrix Client\ica32.msi

.NET Runtime Environment 1.0Installation of the .NET Runtime Environment 1.0 can be run from the following folder:

\Redist\DotNetRuntime\dotnetfx10.exe

To upgrade .NET Runtime Environment 1.0 to Service Pack 1, run the following file from CD:

\Redist\DotNetRuntime\NDP10_SP_Q321884_En.exe

.NET Runtime Environment 1.1Installation of the .NET Runtime Environment 1.1 can be run from the following folder:

\Redist\DotNetRuntime\dotnetfx11.exe

To upgrade .NET Runtime Environment 1.1 to Service Pack 1, run the following file from CD:

\Redist\DotNetRuntime\NDP1.1sp1-KB867460-X86.exe



Java Runtime EnvironmentInstallation of the Java 2 Runtime Environment can be run from the following folder:

\Extras\j2re-1_4_1_01-windows-i586-i.exe

Powerpoint ViewerInstallation of the Microsoft Powerpoint Viewer can be run from the following folder:

\Redist\PPViewer\PPView97.exe


1
Chapter 1 Installing SilkPerformer
This chapter takes you through the process of installing and uninstalling SilkPerformer software.


Overview

The SilkPerformer Installation CD and setup program enable you to install the SilkPerformer Multi-Machine Controller and agent software on the controller computer, and install agent software on other computers you wish to use for testing. To use SilkPerformer with remote agent computers, you must install at least one controller computer.

To install SilkPerformer, your computer system must meet the requirements listed in the “Pre-Installation Requirements” section of the Preface. The installation program checks your system, and optionally installs any required software.

Section Page

Overview 9

Complete Installation 10

Agent Only Installation 16

Advanced Installation 18

Upgrading to a SilkPerformer Service Pack Release 24

SilkPerformer Maintenance 25

SilkPerformer Silent Mode Installation 26

Installing ShopIt V 6.0 28


1 INSTALLING SILKPERFORMERComplete Installation

The available setup options for SilkPerformer are:

Complete Installation “Complete Installation” setup installs a complete SilkPerformer system on a single computer.

Agent Only Installation

“Agent Only Installation” setup enables you to install only an agent, which can be used by a SilkPerformer controller to execute SilkPerformer scripts.

Advanced Installation “Advanced Installation” setup gives you full control over the components that are to be installed on your machine.

Complete Installation

Complete installation of SilkPerformer includes the following features by default:• Workbench• Visual Studio .NET Add-In• Performance Explorer• TrueLog Explorer• Java Explorer• .NET Explorer• Agent• All samples

.NET Explorer pre-installation requirements

If there is no .NET Framework installed on the computer, a message appears, informing you that SilkPerformer .NET Explorer can’t be installed. If you wish to install SilkPerformer .NET Explorer, click No to cancel Setup and install .NET Framework (see “.NET Runtime Environment 1.1”), then restart SilkPerformer Setup. If you don’t need SilkPerformer .NET Explorer, click Yes to continue the installation.

Visual Studio .NET Add-In pre-installation requirements

If the pre-installation requirements for the Visual Studio .NET Add-In for SilkPerformer are not fulfilled, a message appears.If you wish to install the Visual Studio .NET Add-In, click No to cancel Setup and fulfill the pre-installation requirements, then restart SilkPerformer Setup. If you don’t need the Visual Studio .NET Add-In, click Yes to continue the installation.

Visual Studio .NET Add-In for SilkPerformer has the following pre-installation requirements:• .NET Framework (available on the SilkPerformer installation CD; see

“.NET Runtime Environment 1.1”)• .NET Framework SDK• Visual Studio Environment



• Visual Studio IDE• Development languages (either Visual Basic .NET, Visual C++ .NET, or

Visual C# .NET)

Installing SilkPerformer

Procedure To install SilkPerformer:

1 Insert the SilkPerformer CD into the CD-ROM drive of your computer.If the Autostart option is enabled on your computer, the installation program will begin automatically.If Autostart is not enabled, you must start the installation manually:a From the Windows Start menu, select Run.b In the Run dialog, click the Browse button, and then navigate to the

root directory of the SilkPerformer CD.c Select the executable file setup.exe, and then click Open.d In the Run dialog, click OK.

2 A welcome dialog appears. Click Next to continue.3 The Setup Launcher checks that your computer fulfills necessary

requirements (see “Pre-Installation Requirements”).

Note The dialog only appears if one or more of the software requirements are not fulfilled; if all requirements are fulfilled, please continue with step 6.

SilkPerformer required components are displayed in order of their importance to the installation. Enabled Install buttons in the Setup Launcher indicate requirements that were not found on your machine that must be installed before you can proceed with the SilkPerformer installation. If your computer does not meet all requirements, you cannot proceed with the installation.

4 Repeat this process until all requirements have been met. You may have to reboot your computer after installing each required component. After reboot, restart the Setup program.

5 Once all requirements have been met, the Continue button is enabled. Click this button to begin the installation of SilkPerformer.The InstallShield Wizard guides you through the setup procedure. At any point during the setup, you can click Back to return to the previous step, or click Cancel to exit the installation process.

6 The InstallShield Wizard welcome dialog appears.Click Next to continue the installation.

7 The License Agreement appears.



Read the license agreement carefully. If you accept the terms of the agreement, click Yes to continue.

8 The Customer Information dialog appears. Enter your user name and the name of your organization, and indicate whether SilkPerformer can be used by anyone using the computer or only by you. Click Next.

9 The Setup Type dialog appears.Choose SilkPerformer 2007 to install a SilkPerformer environment.The default installation destination is displayed in the Destination path section of the Setup Type dialog. To change the default installation directory, click Browse to open the Choose Folder dialog.Specify the folder in which you wish to install SilkPerformer, then click OK to return to the previous dialog.

Note SilkPerformer can only be installed on local drives. You’ll receive an error message if you specify an invalid installation destination.

Click Next to continue.10 The second Setup Type dialog appears.

- SilkPerformer 2007 Complete Installation installs all components incorporated in the SilkPerformer package.

- SilkPerformer 2007 Agent Only Installation installs SilkPerformer Agent software only.

- SilkPerformer 2007 Advanced Installation enables you to individually select tools for installation. This option is recommended only for advanced users.

Choose SilkPerformer 2007 Complete Installation to install a complete SilkPerformer environment. Click Next to continue.

Note If there is no .NET Framework installed on the computer, a message appears, informing you that SilkPerformer .NET Explorer can’t be installed. If you wish to install SilkPerformer .NET Explorer, click No to cancel Setup and install .NET Framework, then restart SilkPerformer Setup. If you don’t need SilkPerformer .NET Explorer, click Yes to continue the installation.

Note If the pre-installation requirements for the Visual Studio .NET Add-In for SilkPerformer are not fulfilled, a message appears.If you wish to install the Visual Studio .NET Add-In, click No to cancel



Setup and fulfill the pre-installation requirements, then restart SilkPerformer Setup. If you don’t need the Visual Studio .NET Add-In, click Yes to continue the installation.

Visual Studio .NET Add-In for SilkPerformer has the following pre-installation requirements:- .NET Framework- .NET Framework SDK- Visual Studio Environment- Visual Studio IDE- Development languages (either Visual Basic .NET, Visual C++

.NET, or Visual C# .NET)11 The Configure the Silk Launcher Service dialog appears.

The Silk Launcher Service is contacted by the SilkPerformer Multi Machine Controller in order to launch the agent for executing a load test.You can specify a password to protect the Silk Launcher Service from unauthorized use. You can enable remote configuration of your machine with the System Configuration Manager. You can also enable remote reboot. Select appropriate check boxes. Then click Next.

12 An Installation Options Summary dialog lists the settings you have selected during setup.Review the provided information. If you wish to change any settings, click Back to return to the appropriate dialog.If you’re satisfied with the settings, click Next to begin the installation process.

13 The status bar of the Setup Status dialog provides information about the installation process.

14 The Choose licensing mode dialog appears. You can select to install either of the following:

- Evaluation version: Installing an evaluation version of SilkPerformer grants you full product functionality for a period of 30 days, limited to 10 virtual users. If you want to upgrade to a full version at a later point in time, please contact your Borland sales representative.Proceed with step 18 if you choose the evaluation licensing mode.

- Full version: Installing a full version of SilkPerformer requires a license. Refer to “Obtaining a License for SilkPerformer” for further information regarding licensing.



Click Next to continue.15 The SilkPerformer licensing dialog appears.

This dialog provides generic information about SilkMeter licensing. For detailed information on SilkMeter licensing, click the Open SilkMeter ReadMe button. This will open the SilkMeter documentation in your default browser.

Note The Open SilkMeter ReadMe button is disabled if the document is not available in the installation source directory. This is usually the case when installing a SilkPerformer Web package.

Note Refer to “Licensing SilkPerformer” for further information regarding SilkMeter licensing options.

Provided that you’ve already installed a SilkMeter license server on your computer network, or you know which computer on your network will become the SilkMeter license server, or you want to run SilkMeter in standalone mode, you can open the Select SilkMeter License Server dialog by clicking OK.Click Cancel to continue the installation without specifying a SilkMeter license server.

16 If you selected OK in the previous step, the Select SilkMeter License Server utility opens. This utility checks your local system for the existence of SilkMeter license server configuration files. If the files are found, the configuration and type of license server are displayed and will be used for licensing. If no configuration data is found, the Select SilkMeter License Server dialog is displayed with the default settings.• In the Application drop-down list, select SilkPerformer as the

application you are licensing.Then select one of the following:• Using local or remote server - Enter the name of your SilkMeter

license server (the name of the machine on which SilkMeter is installed) in the License Server Host field. The default Port Number (5461) should not be changed, unless your network administrator has defined a different port. Click Apply to generate your license server configuration. Click Test Connection to verify that a SilkMeter server is accessible on the specified host and port. Testing the connection to the license server may fail during installation as required system libraries, which will be installed later with the software package, may not yet be available.



Note 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.mycompany.com.

• Not using server (standalone) - Runs SilkMeter standalone. You are prompted to import a SilkMeter License. If you select Yes you will be prompted to specify the location of your license file.

Note You can import your license file later. Click Close to skip this step. The Select SilkMeter License Server utility is installed with the product, so that you can access it later from the Start menu to test the connection.

17 Click Close to return to the InstallShield Wizard and continue the SilkPerformer installation.

18 Once the installation is complete, the InstallShield Wizard Complete dialog is displayed.Log files are generated during the installation process. If errors occur during installation, or if you experience problems accessing SilkPerformer, these log files may contain information that will be helpful in identifying the cause of the problems.Select the option Open the log files generated during the installation if you want to review the log files.

Note If the InstallShield Wizard failed to update a file during the installation (e.g., if a system library is locked by Windows) or if the InstallShield Wizard otherwise detects that the system needs to be rebooted, then you will be prompted to restart your computer. If you don’t restart your computer you may experience problems when accessing SilkPerformer.

Click Finish to complete the installation.

During the installation, a log file is written to your computer. If problems occurred during the installation, or if you have problems working with SilkPerformer, you should examine this file. The file is named SP75_Installation.log. This file can be found in the \Documents and Settings\<username>\Local Settings\Temp\SP75 folder of your system drive.


1 INSTALLING SILKPERFORMERAgent Only Installation

Agent Only Installation

Choose this option to install a SilkPerformer agent on your computer.

You must install an agent on each host that you want to use as a remote SilkPerformer agent. Agents are used to execute SilkPerformer scripts on remote computers.

Procedure To install a SilkPerformer agent:

1 Insert the SilkPerformer CD into the CD-ROM drive of your computer.If the Autostart option is enabled on your computer, the installation program will start automatically.If Autostart is not enabled, you must start the installation manually:a From the Windows Start menu, select Run.b In the Run dialog, click the Browse button, and then navigate to the

root directory of your SilkPerformer CD.c Select the executable file setup.exe, and then click Open.d In the Run dialog, click OK.





4 Repeat this process until all requirements have been met. You may have to reboot your computer after installing each required component. After reboot, restart the Setup Launcher program.



1 INSTALLING SILKPERFORMERAgent Only Installation


7 The License Agreement appears. Read the license agreement carefully. If you accept the terms of the agreement, click Yes to continue.

8 The Customer Information dialog appears. Enter your user name and the name of your organization. Also indicate whether SilkPerformer can be used by anyone using the computer or only by you. Click Next.

9 The Setup Type dialog appears. Choose SilkPerformer 2007 to install a SilkPerformer environment.The default installation destination is displayed in the Destination path section of the Setup Type dialog. To change the default installation directory, click Browse to open the Choose Folder dialog.Specify the folder in which you wish to install SilkPerformer, then click OK to return to the previous dialog.






Choose SilkPerformer 2007 Agent Only Installation to install SilkPerformer agent software only. Click Next to continue.

11 The Configure the Silk Launcher Service dialog appears.The Silk Launcher Service is contacted by the SilkPerformer Multi Machine Controller in order to launch the agent for executing a load test.


1 INSTALLING SILKPERFORMERAdvanced Installation

You can specify a password to protect the Silk Launcher Service from unauthorized use. You can enable remote configuration of your machine using the System Configuration Manager. You can also enable remote reboot. Select appropriate check boxes. Then click Next.

12 An Installation Options Summary dialog lists the settings you selected during setup.Review the provided information. If you wish to change any settings, click Back to return to the appropriate dialog.If you’re satisfied with the settings, click Next to begin the installation process.

13 The status bar on the Setup Status dialog provides information about the installation process.

14 Once the installation is complete, the InstallShield Wizard Complete dialog is displayed.Log files are generated during the installation process. If errors occur during installation, or if you experience problems accessing SilkPerformer, these log files may contain information that will be helpful in identifying the cause of the problems.Select the option Open the log files generated during the installation if you want to review the log files.Click Finish to complete the installation.




Advanced Installation

Custom Setup Choose this option to individually select tools for installation.

This option is recommended only for advanced users.



Procedure To install SilkPerformer:




requirements (see “Pre-Installation Requirements”). The dialog only appears if one or more of the software requirements are not fulfilled; if all requirements are fulfilled, please continue with step 6.SilkPerformer required components are displayed in order of their importance to the installation. Enabled Install buttons in the Setup Launcher indicate requirements that were not found on your machine that must be installed before you can proceed with the SilkPerformer installation. If your computer does not meet all requirements, you cannot proceed with the installation.





8 The Customer Information dialog appears.



Enter your user name and the name of your organization. Also indicate whether SilkPerformer can be used by anyone using the computer or only by you. Click Next.

9 The Setup Type dialog appears. Choose SilkPerformer 2007 to install a SilkPerformer environment.The default installation destination is displayed in the Destination path section of the Setup Type dialog. To change the default installation directory, click Browse to open the Choose Folder dialog.Specify the folder in which you wish to install SilkPerformer, then click OK to return to the previous dialog.






Choose SilkPerformer 2007 Advanced Installation to install SilkPerformer components based on your specific needs. Click Next to continue.

11 The InstallShield Wizard Select Features dialog appears.By default, Advanced Installation setup installs all components incorporated in the SilkPerformer package.- To install SilkPerformer Workbench, select the Workbench option.

You may further select Visual Studio .NET Add-In to use SilkPerformer’s .NET support.

- To install Performance Explorer, select the Performance Explorer option. This option is disabled when Workbench is selected because Performance Explorer is included in the Workbench installation.

- To install TrueLog Explorer, select the TrueLog Explorer option. This option is disabled when Workbench is selected because TrueLog Explorer is included in the Workbench installation.



- To install Java Explorer, select the Java Explorer option. This allows you to test java classes, archives, webservices, EJB’s and more.

- To install .NET Explorer, select the .NET Explorer option. This allows you to test .NET classes, remote objects and Web Services.

- Select the Sample Applications that you wish to install. The samples help you get started with specific SilkPerformer testing functionality.

Click Next to continue.

Note If there is no .NET Framework installed on the computer, a message appears, informing you that SilkPerformer .NET Explorer can’t be installed. If you wish to install SilkPerformer .NET Explorer, click No to cancel Setup and install .NET Framework (see “.NET Runtime Environment 1.1”), then restart SilkPerformer Setup. If you don’t need SilkPerformer .NET Explorer, click Yes to continue the installation.

Note If the pre-installation requirements for the Visual Studio .NET Add-In for SilkPerformer are not fulfilled, a message appears.If you wish to install the Visual Studio .NET Add-In, click No to cancel Setup and fulfill the pre-installation requirements, then restart SilkPerformer Setup. If you don’t need the Visual Studio .NET Add-In, click Yes to continue the installation.

Visual Studio .NET Add-In for SilkPerformer has the following pre-installation requirements:- .NET Framework (available on the SilkPerformer installation CD;

see “.NET Runtime Environment 1.1”)- .NET Framework SDK- Visual Studio Environment- Visual Studio IDE- Development languages (either Visual Basic .NET, Visual C++

.NET, or Visual C# .NET)12 The Configure the Silk Launcher Service dialog appears.

The Silk Launcher Service is contacted by the SilkPerformer Multi Machine Controller in order to launch the agent for executing a load test.You can specify a password to protect the Silk Launcher Service from unauthorized use. You can enable remote configuration of your machine with the System Configuration Manager. You can also enable remote reboot. Select appropriate check boxes. Then click Next.






- Evaluation version: Installing an evaluation version of SilkPerformer grants you full product functionality for a period of 30 days, limited to 10 virtual users. If you want to upgrade to a full version at a later point in time, please contact your Borland sales representative.Proceed with step 18 if you choose the evaluation licensing mode.

- Full version: Installing a full version of SilkPerformer requires a license. Refer to “Obtaining a License for SilkPerformer” for further information regarding licensing.

16 The SilkPerformer licensing dialog appears.This dialog provides generic information about SilkMeter licensing. For detailed information on SilkMeter licensing, click the Open SilkMeter ReadMe button. This will open the SilkMeter documentation in your default browser.

Note The Open SilkMeter ReadMe button is disabled if the document is not available in the installation source directory. This is usually the case when installing a SilkPerformer Web package.

Note Refer to “Licensing SilkPerformer” for further information regarding SilkMeter licensing options.

Provided that you’ve already installed a SilkMeter license server on your computer network, or you know which computer on your network will become the SilkMeter license server, or you want to run SilkMeter in standalone mode, you can open the Select SilkMeter License Server dialog by clicking OK.Click Cancel to continue the installation without specifying a SilkMeter license server.



17 If you selected OK in the previous step, the Select SilkMeter License Server utility opens. This utility checks your local system for the existence of SilkMeter license server configuration files. If the files are found, the configuration and type of license server are displayed and will be used for licensing. If no configuration data is found, the Select SilkMeter License Server dialog is displayed with the default settings.• In the Application drop-down list, select SilkPerformer as the

application you are licensing.Then select one of the following:• Using local or remote server - Enter the name of your SilkMeter

license server (the name of the machine on which SilkMeter is installed) in the License Server Host field. The default Port Number (5461) should not be changed, unless your network administrator has defined a different port. Click Apply to generate your license server configuration. Click Test Connection to verify that a SilkMeter server is accessible on the specified host and port. Testing the connection to the license server may fail during installation as required system libraries, which will be installed later with the software package, may not yet be available.

Note 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.mycompany.com.

• Not using server (standalone) - Runs SilkMeter standalone. You are prompted to import a SilkMeter License. If you select Yes you will be prompted to specify the location of your license file.

Note You can import your license file later. Click Close to skip this step. The Select SilkMeter License Server utility is installed with the product, so that you can access it later from the Start menu to test the connection.

18 Click Close to return to the InstallShield Wizard and continue the SilkPerformer installation.

19 Once the installation is complete, the InstallShield Wizard Complete dialog is displayed.


1 INSTALLING SILKPERFORMERUpgrading to a SilkPerformer Service Pack Release

Log files are generated during the installation process. If errors occur during installation, or if you experience problems accessing SilkPerformer, these log files may contain information that will be helpful in identifying the cause of the problems.Select the option Open the log files generated during the installation if you want to review the log files.Click Finish to complete the installation.




Upgrading to a SilkPerformer Service Pack Release

Major and minor releases of SilkPerformer can be installed next to each other on the same computer, e.g., version 7.2 and version 7.3 can co-exist on the same computer, but version 7.3 and version 7.3.1 (service pack) can not be installed on the same computer.

If you are upgrading from a minor release to a service pack release, you must remove the existing minor release before you can install the service pack release.

Procedure To upgrade to a SilkPerformer service pack release:

1 Remove the current installation of SilkPerformer (see “SilkPerformer Maintenance” for detailed information). Remember to remove your SilkPerformer agent installations as well.

Note Your projects directory will not get removed during this procedure.


1 INSTALLING SILKPERFORMERSilkPerformer Maintenance

2 Install the new SilkPerformer service pack (see “Complete Installation” for detailed information). If you want to install a SilkPerformer agent, see “Agent Only Installation”, or see “Installing Agent Software on Remote Computers” if you want to install an agent using remote setup.

SilkPerformer Maintenance

Uninstalling/ Changing the setup

Windows Installer enables you to modify, repair and remove installed applications. The following list provides a short description of each of Windows Installer’s maintenance features:• Modify: The state of all features of a given package are retrieved and

displayed in the Select Features dialog. You can then modify the selections and click Next to apply the changes.

• Repair: The Windows Installer keeps track of all key files of a given package. Key files are usually executables or important configuration files. The repair functionality allows you to check if all key files of the current installation are available, and then re-install any missing files.

• Remove: Uninstalls a given software package from your computer, including all files and registry entries.

Procedure To modify, repair or remove SilkPerformer components:

1 On the Windows Taskbar, go to Start/Settings/Control Panel.The Control Panel window appears.

2 Double-click the Add/Remove Programs icon.The Add/Remove Programs dialog appears.

3 In the list of software that can automatically be uninstalled by Windows, locate and select the SilkPerformer icon.

4 Click the Change/Remove button.5 The SilkPerformer Maintenance dialog appears, displaying the

maintenance options for SilkPerformer, with Remove pre-selected.Select the desired option and click Next to continue.a If you have opted to Modify your installation, the Select Features

dialog will open, displaying the current installation state of all SilkPerformer features.Modify the installation according to your needs, then click Next to let the InstallShield Wizard modify your installation.


1 INSTALLING SILKPERFORMERSilkPerformer Silent Mode Installation

Note You may only add features to an existing installation. To remove existing features, select the Remove option.

b If you have opted to Repair your installation, the InstallShield Wizard will begin examining your current installation and restoring any missing files.

c The default operation (Remove) displays a dialog to verify that you do in fact wish to remove SilkPerformer.Click OK to confirm, and the InstallShield Wizard will then remove the product from your computer.

6 The Maintenance Complete dialog is displayed once the operation is complete. Follow the instructions on the dialog and click Finish to complete the maintenance operation.Once you have removed SilkPerformer, we recommend that you reboot your computer to remove all temporary and orphaned files.

Note Uninstalling SilkPerformer does not remove all the files associated with the program from your computer. For example, files created while working with SilkPerformer are not deleted.

SilkPerformer Silent Mode Installation

InstallShield provides an option for installing a product without any user interaction. This option is called silent mode installation and can be used to install SilkPerformer. This feature is especially useful if you want to distribute software over a LAN or the internet via remote installation tools.

Note The silent mode installation option only works for SilkPerformer Enterprise Edition. It is not supported for SilkPerformer SOA (Service Oriented Architecture) Edition.

Installing in silent mode

Procedure To install SilkPerformer in silent mode:

1 Before you can customize the installation package to run in silent mode, you must prepare the installation files in a directory on the hard drive of the destination computer:a To prepare the installation package from a SilkPerformer installation

CD, copy the contents of the CD to an empty directory on your hard drive.


1 INSTALLING SILKPERFORMERSilkPerformer Silent Mode Installation

b To prepare the installation package from a downloaded SilkPerformer setup package, extract the setup package to an empty directory on your hard drive. The downloaded setup package offers an option for doing this automatically when you double-click the package.

2 In the folder where you copied the files, locate the SetupLauncher.ini file and open it in a test editor of your choice.

3 Locate the [STARTUP] section, where you can set the mode to SILENTMODE:

[STARTUP];;;;;; Settings for silent installations;;; NORMALMODE .. Standard installation with GUI, SILENTMODE .. silent installation modeMODE=SILENTMODE

4 Save the SetupLauncher.ini file.5 In the folder to where you copied the files, locate the file Install.iss and

open it in a text editor of your choice. Locate the szDir tag and define the target installation directory (the directory to where SilkPerformer should be installed).

6 Save the ISS file.7 To execute the silent mode setup, enter the following command line (in a

DOS shell, from a batch file, etc.).setup /s /f1"<prepared directory>\Install.iss"

Example:C:\temp\setup /s /f1"C:\temp\Install.iss"

Note To make the installation package run with the GUI again, simply change the MODE back to NORMALMODE.

Uninstalling in silent mode

Procedure To uninstall SilkPerformer in silent mode:

1 On a computer where you’ve installed SilkPerformer in silent mode, locate the directory where the prepared silent mode files are.

Alternative If you want to remove a normal SilkPerformer installation with silent mode, you need to prepare the installation files in a directory on the hard drive of the destination computer. Follow steps 1 through 4 of the “Installing in silent mode” procedure described above.

2 To execute the silent mode uninstallation procedure, enter the following command line (in a DOS shell, from a batch file, etc.).setup /s /f1"<prepared directory>\UnInstall.iss"


1 INSTALLING SILKPERFORMERInstalling ShopIt V 6.0

Example:C:\temp\setup /s /f1"C:\temp\UnInstall.iss"

Installing ShopIt V 6.0

SilkPerformer’s sample Web application is called ShopIt. ShopIt simulates a simple Web e-commerce site with a catalog of camping merchandise that is available for simulated online purchase. Use this application to experiment with SilkPerformer’s Web application capabilities. ShopIt is designed to generate errors, including missing Web links (due to merchandise being out of stock) and session errors.

ShopIt V 6.0 setup is available from• SilkPerformer installation CD (\Extras\ShopItV60.exe)• Download area (https://customers.segue.com/downloads/utilities/ShopIt/

ShopItV60.exe)

Procedure To install and configure ShopIt V 6.0:

1 Double-click the ShopItV60.exe file (in the \Extras folder of the installation CD, or at the location to which you downloaded it).

Note ShopIt requires that IIS (Internet Information Server) be installed on the computer on which ShopIt is installed.

2 Wait while InstallShield prepares the installation, after which the Welcome dialog appears. Click Next to continue.

3 The Choose Destination Location dialog appears.The default installation destination is displayed in the Destination Folder section of the Choose Destination Location dialog. To change the default installation directory, click Browse to open the Choose Folder dialog.Specify the folder in which you wish to install ShopIt V 6.0, then click OK to return to the previous dialog. Click Next to continue the installation process.

4 The Specify Virtual Directory dialog appears.Enter the name of the virtual directory for the Web application in the entry field. This is the name of the directory that will be created on the Web server. Click Next to continue.

5 Setup installs the files and configures IIS to run the ShopIt Web application. When done, the Installation Complete dialog appears.

6 Click Finish on the Installation Complete dialog.


https://customers.segue.com/downloads/utilities/ShopIt/ShopItV60.exe

https://customers.segue.com/downloads/utilities/ShopIt/ShopItV60.exe


The ShopIt Web application is now ready for use on the computer to which you installed it. You can access ShopIt with a Web browser of your choice by entering the following URL:http://<computer name>/<virtual directory name>/ Example:If your computer name is JohnSmith, and you haven’t modified the default value ShopItV60 for the virtual directory, the URL will be:http://JohnSmith/ShopItV60/ Or, if you access ShopIt from the computer on which you installed it, the following URL will also work:http://localhost/ShopItV60/


2
Chapter 2 Licensing SilkPerformer
This chapter provides a short overview of the licensing options that are available for SilkPerformer and also explains how to obtain licenses.


Overview

This chapter provides a short overview of the licensing options that are available for SilkPerformer and also explains how to obtain licenses. Instructions for installation and configuration of a SilkMeter license server and installation of licenses is contained in the SilkMeter_Runtime.htm document. This document can be found in the SilkMeter/WebHelp folder on the SilkPerformer installation CD.

SilkMeter license services may be configured and used in the following ways:• Standalone• License server

Standalone mode can be used when licenses need only be available to a local machine.

Note Evaluation installations don’t require SilkMeter licensing. See “SilkPerformer Evaluation Version” for details.

Section Page

Overview 31

SilkPerformer Evaluation Version 32

Obtaining a License for SilkPerformer 32


2 LICENSING SILKPERFORMERSilkPerformer Evaluation Version

SilkMeter must be run as a central license server to enable access to license pools for multiple machines running Borland test automation software. License server mode is recommended for use in most QA labs.

Note The SilkMeter License Server configuration can be changed at any time. To start the Change your License Server Configuration utility go to Start/Programs/Borland/SilkPerformer 2007/Administration Tools/Change your License Server Configuration.

SilkPerformer Evaluation Version

If you have installed the evaluation version of SilkPerformer, you may use the full product functionality for 30 days, limited to 10 virtual users. The software will stop operating once the evaluation period expires.

Tip To ease you into the process of working with SilkPerformer, it is recommended that you review the SilkPerformer Web Load Testing Tutorial. This PDF-based tutorial is accessible via SilkPerformer's Start menu.

To upgrade to the full version of SilkPerformer, contact your Borland sales representative. For details about obtaining, installing, and using SilkPerformer licenses, contact Borland Customer Support.

Obtaining a License for SilkPerformer

A SilkPerformer license is bound to the Host ID of the computer that runs SilkMeter. To obtain a valid policy file for your SilkMeter configuration, you will need to determine the Host ID of the machine that you will use as your SilkMeter license server. Then visit https://license.segue.com and provide the following information:• Company Name / Username• Customer ID / Password• Access Code

The Username is typically the first word of your company. The Customer ID and Access Code can be found on the sticker on the inside cover of the SilkPerformer Installation Guide, on the packing slip, or by contacting Borland Customer Service.

To determine the Host ID of your SilkMeter license server machine, run smHostInfo.exe (located in the SilkMeter subdirectory of your SilkPerformer Installation CD) on the license server machine.


https://license.segue.com

2 LICENSING SILKPERFORMERObtaining a License for SilkPerformer

Alternately, you can download smHostInfo.exe from:http://customers.segue.com/downloads/products/SilkMeter/win32/smHostInfo.exe


http://customers.segue.com/downloads/products/SilkMeter/win32/smHostInfo.exe

2 LICENSING SILKPERFORMERObtaining a License for SilkPerformer


3
Chapter 3 Installing SilkPerformer
SOA Edition

This chapter takes you through the process of installing and uninstalling SilkPerformer SOA (Service Oriented Architecture) Edition software.


Overview

The SilkPerformer Installation CD and setup program enable you to install the SilkPerformer Multi-Machine Controller and agent software on the controller computer, and install agent software on other computers you wish to use for testing. To use SilkPerformer with remote agent computers, you must install at least one controller computer.

To install SilkPerformer, your computer system must meet the requirements listed in the “Pre-Installation Requirements” section of the Introduction. The installation program checks your system, and optionally installs any required software.

Section Page

Overview 35

SOA Edition for Java Installation 36

SOA Edition for .NET Installation 39

SOA Edition Advanced Installation 43

SOA Edition Agent Only Installation 47

SilkPerformer Maintenance 50


3 INSTALLING SILKPERFORMER SOA EDITIONSOA Edition for Java Installation

The available setup options for SilkPerformer are:

SOA Edition for Java Installation

“SOA Edition for Java Installation” setup installs a complete SilkPerformer system on a single computer.

SOA Edition for .NET Installation

“SOA Edition for .NET Installation” setup installs a complete SilkPerformer system on a single computer.

SOA Edition Advanced Installation

“SOA Edition Advanced Installation” option gives you full control over the components that are installed on your machine.

SOA Edition Agent Only Installation

“SOA Edition Agent Only Installation” setup enables you to install only an agent, which can be used by a SilkPerformer controller to execute SilkPerformer scripts.

SOA Edition for Java Installation

Features installed with SilkPerformer for Java:

• SOA Workbench• Performance Explorer• TrueLog Explorer• Java Explorer• Java samples• Agent

Procedure To install SilkPerformer SOA Edition for Java:

1 Insert the SilkPerformer CD into the CD-ROM drive of your computer.If the Autostart option is enabled on your computer, the installation program will begin automatically.If Autostart is not enabled, you must start the installation manually:a From the Windows Start menu, select Run.b In the Run dialog, click the Browse button, and then navigate to the

root directory of the SilkPerformer CD.c Select the executable file setup.exe, and then click Open.d In the Run dialog, click OK.

2 A welcome dialog appears. Click Next to continue.



3 The Setup Launcher checks that your computer fulfills necessary requirements (see “Pre-Installation Requirements”) and detects the presence of any optional components.


Note A SilkMeter license server is only required if you wish to install a license server. This option won’t block the installation when not available.






9 The Setup Type dialog appears. Choose SilkPerformer SOA Edition 2007 to install a SilkPerformer environment.The default installation destination is displayed in the Destination path section of the Setup Type dialog. To change the default installation directory, click Browse to open the Choose Folder dialog.Specify the folder in which you wish to install SilkPerformer, then click OK to return to the previous dialog.





Choose SilkPerformer SOA Edition 2007 for Java to install SilkPerformer environment. Click Next to continue.

11 An Installation Options Summary dialog lists the settings you’ve selected during setup.Review the provided information. If you wish to change any settings, click Back to return to the appropriate dialog.If you’re satisfied with the settings, click Next to begin the installation process.



- Evaluation version: Installing an evaluation version of SilkPerformer grants you full product functionality for a period of 30 days. If you want to upgrade to a full version at a later point in time, please contact your Borland sales representative.Proceed with step 15 if you choose the evaluation licensing mode.

- Full version: Installing a full version of SilkPerformer requires a license. Refer to “Obtaining a Custom License” for further information regarding licensing.

14 You are prompted to import a SilkMeter License. If you select Yes you will be prompted to specify the location of your license file.

Note You can import your license file later. Refer to “Licensing SilkPerformer SOA Edition” for further information regarding SilkMeter licensing options. Click Close to skip this step for now.

15 Additional feature setups will be installed at this point. Click Yes to run a feature installation. Click No to skip any unwanted feature installations.

16 Once the installation is complete, the InstallShield Wizard Complete dialog is displayed.


3 INSTALLING SILKPERFORMER SOA EDITIONSOA Edition for .NET Installation

Log files are generated during the installation process. If errors occur during installation, or if you experience problems accessing SilkPerformer, these log files may contain information that will be helpful in identifying the cause of the problems.Select the option Open the log files generated during the installation if you want to review the log files.Click Finish to complete the installation.




SOA Edition for .NET Installation

Features installed with SilkPerformer for .NET:

• SOA Workbench• Visual Studio .NET Add-In• Performance Explorer• TrueLog Explorer• .NET Explorer• .NET samples• Agent

Procedure To install SilkPerformer SOA Edition for .NET:

1 Insert the SilkPerformer CD into the CD-ROM drive of your computer.If the Autostart option is enabled on your computer, the installation program will start automatically.If Autostart is not enabled, you must start the installation manually:



a From the Windows Start menu, select Run.b In the Run dialog, click the Browse button, and then navigate to the



requirements (see “Pre-Installation Requirements”) and detects the presence of any optional components.




5 Once all requirements have been met, the Continue button is enabled. Click this button to begin installation of SilkPerformer.The InstallShield Wizard guides you through the setup procedure. At any point during the setup, you can click Back to return to the previous step, or click Cancel to exit the installation process.




9 The Setup Type dialog appears.



Choose SilkPerformer SOA Edition 2007 to install a SilkPerformer environment.The default installation destination is displayed in the Destination path section of the Setup Type dialog. To change the default installation directory, click Browse to open the Choose Folder dialog.Specify the folder in which you wish to install SilkPerformer, then click OK to return to the previous dialog.



Choose SilkPerformer SOA Edition 2007 for .NET to install SilkPerformer. Click Next to continue.




.NET, or Visual C# .NET)11 An Installation Options Summary dialog lists the settings you have

selected during setup.



Review the provided information. If you wish to change any settings, click Back to return to the appropriate dialog.If you’re satisfied with the settings, click Next to begin the installation process.









Note If the InstallShield Wizard failed to update a file during the installation (e.g., if a system library is locked by Windows) or if the InstallShield Wizard otherwise detects that the system needs to be


3 INSTALLING SILKPERFORMER SOA EDITIONSOA Edition Advanced Installation

rebooted, then you will be prompted to restart your computer. If you don’t restart your computer you may experience problems when accessing SilkPerformer.



SOA Edition Advanced Installation

Custom Setup Choose this option to individually select tools for installation.

Procedure To install SilkPerformer SOA Edition:




requirements (see “Pre-Installation Requirements”) and detects the presence of any optional components.













Choose SilkPerformer SOA Edition 2007 Advanced Installation to install specific SilkPerformer components based on your needs. Click Next to continue.

11 The InstallShield Wizard Select Features dialog appears. By default, Advanced Installation setup installs all components incorporated in the SilkPerformer package.



- To install the SilkPerformer Workbench, select the Component Workbench option. You may further select Visual Studio .NET Add-In to use SilkPerformer’s .NET support.

- To install Java Explorer, select the Java Explorer option. This allows you to test Java classes, Java archives, Web Services, EJBs and more.

- To install .NET Explorer, select the .NET Explorer option. This allows you to test .NET classes, remote objects, and Web Services.

- To install Performance Explorer, select the Performance Explorer option. This option is disabled when Workbench is selected because Performance Explorer is included in the Workbench installation.

- To install TrueLog Explorer, select the TrueLog Explorer option. This option is disabled when Workbench is selected because TrueLog Explorer is included in the Workbench installation.

Click Next to continue.




.NET, or Visual C# .NET)12 An Installation Options Summary dialog lists the settings you have

selected during setup.



Review the provided information. If you wish to change any settings, click Back to return to the appropriate dialog.If you’re satisfied with the settings, click Next to begin the installation process.









Note If the InstallShield Wizard failed to update a file during the installation (e.g., if a system library is locked by Windows) you will be prompted to restart your computer so that the changes can take effect. If you don’t restart your computer you may experience problems when accessing SilkPerformer.


3 INSTALLING SILKPERFORMER SOA EDITIONSOA Edition Agent Only Installation



SOA Edition Agent Only Installation

Choose this option to install a SilkPerformer agent on your computer.

You must install an agent on each host that you want to use as a remote SilkPerformer agent. Agents are used to execute SilkPerformer scripts on remote computers.

Procedure To install a SilkPerformer SOA Edition agent:

















Choose SilkPerformer SOA Edition 2007 Agent Only Installation to install SilkPerformer agent software only. Click Next to continue.

11 The Configure the Silk Launcher Service dialog appears.The Silk Launcher Service is contacted by the SilkPerformer Multi-Machine Controller in order to launch the agent for executing a load test.



You can specify a password to protect the Silk Launcher Service from unauthorized use. You can enable remote configuration of your machine using the System Configuration Manager. You can also enable remote reboot. Select appropriate check boxes. Then click Next.








3 INSTALLING SILKPERFORMER SOA EDITIONSilkPerformer Maintenance

SilkPerformer Maintenance

Uninstalling/ Changing the setup

Windows Installer enables you to modify, repair and remove installed applications. The following list provides a short description of each of Windows Installer’s maintenance features:

• Modify: The state of all features of a given package are retrieved and displayed in the Select Features dialog. You can then modify the selections and click Next to apply the changes.

• Repair: The Windows Installer keeps track of all key files of a given package. Key files are usually executables or important configuration files. The repair functionality allows you to check if all key files of the current installation are available, and then re-install any missing files.

• Remove: Uninstalls a given software package from your computer, including all files and registry entries.

Procedure To modify, repair or remove SilkPerformer components:

1 On the Windows Taskbar, go to Start/Settings/Control Panel.The Control Panel window appears.

2 Double-click the Add/Remove Programs icon.The Add/Remove Programs dialog appears.

3 In the list of software that can automatically be uninstalled by Windows, locate and select the SilkPerformer icon.

4 Click the Change/Remove button.5 The SilkPerformer Maintenance dialog appears, displaying the

maintenance options for SilkPerformer, with Remove pre-selected.Select the desired option and click Next to continue.a If you have opted to Modify your installation, the Select Features

dialog will open, displaying the current installation state of all SilkPerformer features.Modify the installation according to your needs, then click Next to let the InstallShield Wizard modify your installation.

Note You may only add features to an existing installation. To remove existing features, select the Remove option.

b If you have opted to Repair your installation, the InstallShield Wizard will begin examining your current installation and restoring any missing files.



c The default operation (Remove) displays a dialog to verify that you do in fact wish to remove SilkPerformer.Click OK to confirm, and the InstallShield Wizard will then remove the product from your computer.

6 The Maintenance Complete dialog is displayed once the operation is complete. Follow the instructions on the dialog and click Finish to complete the maintenance operation.Once you have removed SilkPerformer, we recommend that you reboot your computer to remove any temporary or orphaned files.

Note Uninstalling SilkPerformer does not remove all files associated with the program from your computer. For example, files created while working with SilkPerformer are not deleted.


4
Chapter 4 Licensing SilkPerformer
SOA Edition

This chapter provides a short overview of the licensing options that are available for SilkPerformer SOA (Service Oriented Architecture) Edition and also explains how to obtain licenses.


Overview

This chapter provides a short overview of the licensing options that are available for SilkPerformer and also explains how to obtain licenses. Instructions for installation and configuration of a SilkMeter license server and installation of licenses is contained in the SilkMeter_Runtime.htm document. This document can be found in the SilkMeter/WebHelp folder on the SilkPerformer installation CD.

SilkMeter license services may be configured and used in the following ways:

• Standalone• License server

Section Page

Overview 53

SilkPerformer SOA Evaluation Version 54

Obtaining a Custom License 54


4 LICENSING SILKPERFORMER SOA EDITIONSilkPerformer SOA Evaluation Version

Standalone mode can be used when licenses need only be available to a local machine.

Note Evaluation installations don’t require SilkMeter licensing. See “SilkPerformer SOA Evaluation Version” for details.

SilkMeter must be run as a central license server to enable access to license pools for multiple machines running Borland test automation software. License server mode is recommended for use in most QA labs.

Note The SilkMeter License Server configuration can be changed at any time. To start the Change your License Server Configuration utility go to Start/Programs/Borland/SilkPerformer SOA Edition 2007/Administration Tools/Change your License Server Configuration.

SilkPerformer SOA Evaluation Version

If you have installed the evaluation version of SilkPerformer SOA Edition, you may use the full product functionality for 30 days. The software will stop operating once the evaluation period expires.

Tip To ease you into the process of working with SilkPerformer SOA Edition, it is recommended that you review the SilkPerformer .NET Testing and Java Testing books. These PDF-based books are accessible via SilkPerformer's Start menu.

To upgrade to the full version of SilkPerformer SOA Edition, contact your Borland sales representative. For details about obtaining, installing, and using SilkPerformer licenses, contact Borland Customer Support.

Obtaining a Custom License

A custom SilkPerformer license that meets your needs is bound to the Host ID of the computer that runs SilkMeter. To obtain a valid policy file for your SilkMeter configuration, you will need to determine the Host ID of the machine that you will use as your SilkMeter license server. Then visit https://license.segue.com and provide the following information:

• Company Name / Username• Customer ID / Password• Access Code




4 LICENSING SILKPERFORMER SOA EDITIONObtaining a Custom License

The Username is typically the first word of your company. The Customer ID and Access Code can be found on the sticker on the inside cover of the SilkPerformer Installation Guide, on the packing slip, or by contacting Borland Customer Service.

To determine the Host ID of your SilkMeter license server machine, run smHostInfo.exe (located in the SilkMeter subdirectory of your SilkPerformer Installation CD) on the license server machine.

Alternately, you can download smHostInfo.exe from:http://customers.segue.com/downloads/products/SilkMeter/win32/smHostInfo.exe


http://customers.segue.com/downloads/products/SilkMeter/win32/smHostInfo.exe

4 LICENSING SILKPERFORMER SOA EDITIONObtaining a Custom License


5
Chapter 5 Installing Agent Software on
Remote Computers

This chapter takes you through the process of setting up SilkPerformer Agent software on remote computers.


Overview

SilkPerformer provides a command-line tool that enables you to easily set up SilkPerformer Agent software on remote machines within your Windows domain/workgroup.

Warning Windows Server 2003 and Windows XP Professional: If the computer is joined to a workgroup and the "Force network logons using local accounts to authenticate as Guest" policy is enabled, the installation fails if you install a SilkPerformer agent for the first time on this computer. Note that this policy is enabled by default if the computer is joined to a workgroup. Ask your Windows administrator to change this setting so that local system accounts are not forced to be guest accounts.

Section Page

Overview 57

Remote Installation 58


5 INSTALLING AGENT SOFTWARE ON REMOTE COMPUTERSRemote Installation

Remote Installation

The SilkPerformer command-line tool allows you to upgrade agent software on remote computers anywhere on the Internet to the most recent version. It also allows you to uninstall agent software from remote computers anywhere on the Internet.

For assistance regarding use of the Remote Agent Setup command-line tool, call the tool (which is called perfRsManager.exe) without specifying any parameters.

Note The command-line tool must be started from the SilkPerformer installation sub directory.

This will display information similar to the following:

usage perfRsManager -mode -host <host name> {-option {values} }

-mode -i Install the agent software on a remote computer.-u Upgrade the agent software on a remote computer to the most

recent version.-r Uninstall the agent software from a remote computer.

-host host name Host name or IP address of the remote computer.



Installation The following options are available for installing the agent software:-log Write an installation log file, named spRsManager_

<hostname>.log, to the current directory. For example, if you install the agent software on the host “lab15,” the log file spRsManager_lab15.log will be generated.

-user Name of a Windows NT/2000 domain user. For remote access, a user who has appropriate permissions on the remote computer must be specified. Omit this parameter if you want to access the remote computer with your current user name.

-domain Name of the Windows NT/2000 domain to which the specified user belongs. Omit this parameter if the user belongs to the same domain as the computer from which you invoke the installation.

-pwdUser Password for the specified user. Omit this parameter if no password is required.

-denyConfig The remote agent computer denies configuration from a different computer.

-denyReboot The remote agent computer denies reboot from a different computer.

-doReboot If necessary, restarts the remote agent computer when installation is complete.

Note Before you install SilkPerformer Agent software on remote computers, ensure that no software on the remote computers is listening for connections on the ports 19200 and 19290.



Upgrade/ Uninstallation

These options are available for upgrading and removing agent software:-log Write a log file, called spRsManager_<hostname>.log, to the

current directory. For example, if you install agent software on the host "lab15", the log file spRsManager_lab15.log will be generated.

-port Number of the port to which the remote agent computer responds. The default port number is 19200.

-ssl Use SSL for communication with the remote agent computer. When SSL is used, the remote agent computer is contacted at the default port for secure connections, which is port 19201. If your agent computer responds to a different port, you must specify the port number with the “-port” parameter.

-httpProxy Name and port number of the HTTP proxy via which the communication with the remote computer should take place (syntax: -httpProxy <host name> <port number>).

-socksProxy Name and port number of the SOCKS proxy via which the communication with the remote computer should take place (syntax: -socksProxy <host name> <port number>).

-pwdService Password with which the agent software on the remote computer is protected from unauthorized access.

Note Upgrading and removing agent software works only for SilkPerformer 4.0 agents (or higher).

Examples perfRsManager -i -host DeepBlue -log -domain intra -user nobody -pwdUser 1234

perfRsManager -i -host deepblue -user alex -domain test -pwdUser 1234 -mayReboot -doReboot

perfRsManager -u -host 192.168.20.11

perfRsManager -u -host deepblue -log -ssl -port 19251 -socksproxy 192.168.20.111 1080 -pwdService 1rt34xy

perfRsManager -r -host deepblue -httpproxy proxy1 8080 -log



Average installation durationsThe following table shows approximately how long remote agent setup takes, depending on the type of modem you use.

ScenariosThis section illustrates a number of network environments in which the SilkPerformer Remote Agent Setup is used to install, upgrade and uninstall SilkPerformer Agent software on remote computers.• In Scenario 1, both the controller and agent computers are located in the

same Windows domain or workgroup.• In Scenario 2, the controller and agent computers are located in different

Windows domains or workgroups.• In Scenario 3, the user who works on the controller computer is logged

onto the computer locally, and is therefore not logged onto a domain.• In Scenario 4, the controller and agent computers are located in different

local area networks that are connected over the Internet.• In Scenario 5, the controller and agent computers are located in different

local area networks that are connected over the Internet. At least one of the local area networks is protected by a firewall, so the controller and agent computers must communicate via an HTTP proxy.

• In Scenario 6, the controller and agent computers are located in different local area networks that are connected over the Internet. At least one of the local area networks is protected by a firewall, so the controller and agent computers must communicate via a SOCKS proxy.

Scenario 1:One domain or workgroup

In Scenario 1, both the controller and agent computers are located in the same Windows domain or workgroup. The following figure illustrates this network environment.

Modem type Setup duration

Modem 56 kbps 37 min.




Modem 512 kbps 4 min.Table 1: Remote installation—average installation durations



Figure 1: Remote installation—one domain or workgroup

Working on the controller computer, you can install, upgrade, and uninstall the SilkPerformer Agent software on the remote agent computer (<agent name>).

To install the agent software, execute the following command:PerfRsManager -i -host <agent name> -log

This command sets up the agent computer so that it can be configured and rebooted from remote computers. If you want to disable any of these options, use the respective parameter (-denyConfig or -denyReboot). When you want to upgrade or remove agent software, you need to know the port to which the agent software responds (<port number>, 19200 by default) and, if in use, the password by which the agent software is protected from unauthorized access (<password>). To upgrade agent software, execute the following command:

PerfRsManager -u -host <agent name> -port <port number> -pwdService <password> -log

If the agent software responds to the default port 19200, you can omit the-port parameter. To uninstall the agent software from the computer, execute the following command:

PerfRsManager -r -host <agent name> -port <port number> -pwdService <password> -log

Again, if the agent software responds to the default port 19200, you can omit the -port parameter. All the commands shown above generate log files with detailed information about the installation, upgrade or deinstallation process. If you don’t want these log files to be generated, omit the -log parameter.

Scenario 2:Two domains or workgroup

In Scenario 2, the controller and agent computers are located in different Windows domains or workgroups. The following figure illustrates this network environment.

Figure 2: Remote installation—two domains or workgroups

Working on the controller computer, you can install, upgrade and uninstall the SilkPerformer Agent software on the agent computer (<agent name>) in the



remote domain or workgroup (<domain name>). To install the agent software, you must specify a user (and his or her password) who has administrator rights in the domain or workgroup where the agent computer is located (<user name>, <password>). Execute the following command:

PerfRsManager -i -host <agent name> -user <user name> -domain <domain name> -log

This command sets up the agent computer so that it can be configured and rebooted from remote computers. If you want to disable any of these options, use the respective parameter (-denyConfig or -denyReboot). When you want to upgrade or remove agent software, you need to know the port to which the agent software responds (<port number>, 19200 by default) and, if in use, the password by which the agent software is protected from unauthorized access (<password>). To upgrade agent software, execute the following command:





Scenario 3:User is logged on locally

In Scenario 3, the user who works on the controller computer is logged onto the computer locally and is therefore not logged onto a domain. The following figure illustrates this network environment.

Figure 3: Remote installation—locally logged on user

Working on the controller computer, you can install, upgrade and uninstall the SilkPerformer Agent software on the agent computer (<agent name>) in the remote domain or workgroup (<domain name>). To install the agent software, you must specify a user (and his or her password) who has administrator rights in the domain or workgroup where the agent computer is located (<user name>, <password>). Execute the following command:

PerfRsManager -i -host <agent name> -user <user name> -domain <domain name> -log



This command sets up the agent computer so that it can be configured and rebooted from remote computers. If you want to disable any of these options, use the respective parameter (-denyConfig or -denyReboot). When you want to upgrade or remove agent software, you need to know the port to which the agent software responds (<port number>, 19200 by default) and, if in use, the password by which the agent software is protected from unauthorized access (<password>). To upgrade the agent software, execute the following command:





Scenario 4:Two local area networks, connected over the Internet

In Scenario 4, the controller and agent computers are located in different local area networks that are connected over the Internet. The following figure illustrates this network environment.

Figure 4: Remote installation—two LANs connected over the Internet

Working on the controller computer, you can upgrade and uninstall the SilkPerformer Agent software on the remote agent computer (<agent name>). You need to know the port to which the agent software responds (<port number>, by default 19200 for non-secured communication, 19201 for secure communication) and, if in use, the password by which the agent software is protected from unauthorized access (<password>). To upgrade agent software, execute the following command:

PerfRsManager -u -host <agent name> -port <port number> -pwdService <password> -ssl -log

To uninstall agent software, execute the following command:PerfRsManager -r -host <agent name> -port <port number> -pwdService <password> -ssl -log

If the agent software responds to the default port, you can omit the -port parameter. Also, if you don’t want to secure the communication channel, omit the -ssl option. All the commands shown above generate log files with detailed



information about the upgrade or deinstallation process. If you don’t want these log files to be generated, omit the -log parameter.

Scenario 5:Two local area networks, connection via HTTP proxy

In Scenario 5, the controller and agent computers are located in different local area networks that are connected over the Internet. At least one of the local area networks is protected by a firewall, so the controller and agent computers must communicate via an HTTP proxy. The following figure illustrates this network environment.

Figure 5: Remote installation—two LANs connected over HTTP proxy

Working on the controller computer, you can upgrade and uninstall the SilkPerformer Agent software on the remote agent computer (<agent name>). The communication thereby takes place via an HTTP proxy (<proxy name>, <proxy port>). You need to know the port to which the agent software responds (<agent port>, by default 19200 for non-secured communication, 19201 for secure communication) and, if in use, the password by which agent software is protected from unauthorized access (<password>). To upgrade the agent software, execute the following command:

PerfRsManager -u -host <agent name> -port <agent port> -pwdService <password> -ssl -log -httpProxy <proxy name> <proxy port>

To uninstall agent software, execute the following command:PerfRsManager -r -host <agent name> -port <agent port> -pwdService <password> -ssl -log -httpProxy <proxy name> <proxy port>

If the agent software responds to the default port, you can omit the -port parameter. Also, if you don’t want to secure the communication channel, omit the -ssl option. All the commands shown above generate log files with detailed information about the upgrade or deinstallation process. If you don’t want these log files to be generated, omit the -log parameter.

Scenario 6:Two local area networks, connection via SOCKS proxy

In Scenario 6, the controller and agent computers are located in different local area networks that are connected over the Internet. At least one of the local area networks is protected by a firewall, so the controller and agent computers must communicate via a SOCKS proxy. The following figure illustrates this network environment.



Figure 6: Remote installation—two LANs connected over SOCKS proxy

Working on the controller computer, you can upgrade and uninstall SilkPerformer Agent software on the remote agent computer (<agent name>). The communication thereby takes place via a SOCKS proxy (<proxy name>, <proxy port>). You need to know the port to which the agent software responds (<agent port>, by default 19200 for non-secured communication, 19201 for secure communication) and, if in use, the password by which the agent software is protected from unauthorized access (<password>). To upgrade agent software, execute the following command:

PerfRsManager -u -host <agent name> -port <agent port> -pwdService <password> -ssl -log -socksProxy <proxy name> <proxy port>

To uninstall agent software, execute the following command:PerfRsManager -r -host <agent name> -port <agent port> -pwdService <password> -ssl -log -socksProxy <proxy name> <proxy port>

If the agent software responds to the default port, you can omit the -port parameter. Also, if you don’t want to secure the communication channel, omit the -ssl option. All the commands shown above generate log files with detailed information about the upgrade or deinstallation process. If you don’t want these log files to be generated, omit the -log parameter.

TroubleshootingThis section lists problems that can occur during setup and suggests ways of solving them:

PerfORB: 23 Connection could not be established. Possible error reasons:• The SilkPerformer Agent Service is not running on the remote computer.• You may have specified the wrong port number.

Solution: Start SilkPerformer Agent Service on the remote computer.

PerfORB: 29 ORB is down. The connection was closed for an unknown reason.

Solution: Run Remote Agent Setup again.

Remote Setup: 4 A newer version of SilkPerformer was detected on the remote computer.



Solution: Don’t install the older version of SilkPerformer.

Remote Setup: 5 SilkPerformer Agent software already exists on the remote computer. Installing agent software is possible only if SilkPerformer 4.0 (or higher) doesn’t exist on the remote computer.

Solution: Upgrade agent software on the remote computer rather than installing it.

Remote Setup: 6 SilkPerformer Controller Software already exists on the remote computer. Installing agent software is possible only if SilkPerformer 4.0 (or higher) doesn’t exist on the remote computer.

Solution: Upgrade agent software on the remote computer rather than installing it.

System: 32 Remote Agent Setup can’t access a particular file because the file is in use by another application.

Solution:• Close the application that currently accesses the file and run Remote

Agent Setup again.• If the file is locked by a system process, restart the computer and run

Remote Agent Setup again.

System: 53 The network path wasn’t found. It could be that the registry service isn’t running on the remote computer.

Solution: Start the registry service on the remote computer.

System: 1219 The supplied credentials conflict with an existing set of credentials. A network connection to the target computer already exists. This connection was established with a different user/password combination.

Solution: Execute the following DOS command to close the connection.net use \\<machine name> /delete

To check if the connection has in fact been closed, execute the following DOS command:

net use

Finally, start setup again.

System: 10054 An existing connection was closed by the remote computer. It could be that a time-out has occurred. This is likely to happen when you’re using a modem slower than 56 kbps.


Index

Symbols.NET Explorer

Pre-installation requirements 10, 21.NET Framework 10, 12, 21, 41, 45.NET Runtime Environment 3, 10, 21.NET Runtime Environment 1.0 6.NET Runtime Environment 1.1 6

AAcrobat Reader 3advanced installation 10, 18agent only installation 10, 16autorun 11, 16, 19, 36, 39, 43, 47

BBorland License Agreement 11, 17, 19, 48

Cchange installed features 25, 50Citrix 4Citrix ICA Client 4, 6complete installation 10

Eevaluation 32

SilkPerformer SOA 54

IInstallation

Upgrading 24installation

advanced 10, 18agent only 10, 16autorun 11, 16, 19, 36, 39, 43, 47complete 10destination path 12, 17, 20, 28, 37, 41, 44, 48maintenance 25, 50setup launcher 11, 16, 19, 37, 40, 43, 47ShopIt V 6.0 5, 27specify SilkMeter license server 14, 22un-install 25, 50

Installation requirements 2ISS file 27

JJava Development Kit 4Java Runtime Environment 4, 7

Kkey file 25, 50

Llicensing

Borland License Agreement 11, 17, 19, 48evaluation license 32, 54SilkPerformer 6 31SilkPerformer SOA Edition 53specify SilkMeter license server 14, 22

Mmaintenance mode 25, 50

PPowerPoint 3Powerpoint Viewer 7pre-installation requirements 11, 16, 19, 37, 40, 43,

47Prerequisites, installation of SilkPerformer 2

RRequirements, installation of SilkPerformer 2

SService pack 24setup launcher 11, 16, 19, 37, 40, 43, 47SetupLauncher.ini 26ShopIt V 6.0 5, 27Silent Mode Installation 26

Installing 26Uninstalling 27


SilkMeter 6specify license server 14, 22

SilkPerformerService Oriented Architecture Edition 35, 53

SilkPerformer .NET Explorer 4SOA (Service Oriented Architecture) Edition

Installing 35Licensing 53

SOA Edition.NET Installation 39Advanced Installation 43Agent Only Installation 47Java Installation 36

UUpgrading 24

VVisual Studio .NET Add-In for SilkPerformer 12, 41,

45Pre-installation requirements 10, 21

WWAP2 Add-On 4Windows Installer Service 6

key file 25, 50modify, repair, remove option 25, 50


installation guide

Documents

silkperformer software

silkperformer installation

higher silkperformer

potential of silkperformer

remote installation

installation programs

installation type

agent software