Silk Performer for TrueSight Operations

Management 16.5

Installation Guide
 Borland Software Corporation
700 King Farm Blvd, Suite 400
Rockville, MD 20850

Copyright © Micro Focus 2015. All rights reserved. Portions Copyright © 1992-2009 Borland
Software Corporation (a Micro Focus company).

MICRO FOCUS, the Micro Focus logo, and Micro Focus product names are trademarks or
registered trademarks of Micro Focus IP Development Limited or its subsidiaries or affiliated
companies in the United States, United Kingdom, and other countries.

BORLAND, the Borland logo, and Borland product names are trademarks or registered
trademarks of Borland Software Corporation or its subsidiaries or affiliated companies in the
United States, United Kingdom, and other countries.

All other marks are the property of their respective owners.

2015-09-09

ii
Contents
Introduction ........................................................................................................ 4
System Requirements .........................................................................................................4
Installing Silk Performer TrueSight ...................................................................6
Complete Installation ...........................................................................................................6
Installing and Uninstalling the Network Emulation Driver Manually .................................... 7
Installing ShopIt V 6.0 ......................................................................................................... 8
Installing the Eclipse Plug-In ............................................................................................... 9
Uninstalling Silk Performer TrueSight ..................................................................................9
Uninstalling in Silent Mode ..................................................................................................9

Contents | 3
 Introduction
This Help provides all the information you need to install and uninstall Silk Performer TrueSight software
and to prepare the monitoring environment. It suggests pre-installation hardware and software
requirements and offers alternative installation options.
Before you can install Silk Performer TrueSight, the Setup wizard confirms that all the software you need
for installation and use of Silk Performer TrueSight is available on your computer. If this is not the case, the
Setup wizard provides options for installing the missing software.
This section describes the required and recommended installation options for each installation type.

System Requirements
The following tables identify the system requirements for installing and running Silk Performer TrueSight.

Hardware Requirements

To use Silk Performer TrueSight for traffic recording purposes, scripting, and monitoring, your system must
meet the following minimum requirements:
System Area Requirement

Processor Pentium IV or equivalent CPU

RAM 256 MB

Hard disk space 440 MB

Network TCP/IP

Operating System Requirements

• A Silk Performer TrueSight Controller installation requires Windows Vista or newer.
• A Silk Performer TrueSight Agent installation requires Windows 2003 or newer.
• Installing the network emulation driver is not supported for Windows 2003 and Windows 2003 R2.
• Installing the network emulation driver is currently not supported for Windows 10.
• Windows XP is not supported.

Software Requirements
To install and run Silk Performer TrueSight, your system requires a minimum set of software components:
The required components vary based on installation type. For example, to run Silk Performer TrueSight
Java Explorer, your system must be equipped with the appropriate Java Development Kit. Download
components from the respective websites.
• Internet Explorer 7, 8, 9, 10, 11 for browser-driven load testing
• PDF viewer to view documentation
• Citrix XenApp Client 12.x or Citrix Receiver for Microsoft Windows 3.x, 4.x to test Citrix applications
• 32-bit Java Development Kit 1.4, 1.5, 1.6, 1.7, 1.8 to test Java applications with Java Explorer

4 | Introduction
Working with Silk Performer TrueSight on a multi-user system
Silk Performer TrueSight can be installed on a machine with terminal services enabled for multi-user
access. In general, it is not recommended to work in multiple sessions simultaneously. If you want to do so
nevertheless, keep the following in mind:
• Recording: The Silk Performer TrueSight Recorder uses a system-wide hooking mechanism. If one
user starts the Recorder, the traffic of all other users might be recorded as well.
• Workbench: Multiple users can work on different projects simultaneously. Working on the same project
is not recommended. The project will be opened in read-only mode for the second and all further users.
• Executing tests: Multiple users can execute tests simultaneously from one machine. However, multiple
simultaneously running tests will influence each other as they share the same resources (CPU,
memory, network bandwidth).
• Monitoring tests: Performance Explorer cannot differentiate between test metrics of multiple running
tests. Therefore, real-time values of the wrong test might be displayed.

Introduction |5
 Installing Silk Performer TrueSight
Before beginning installation, confirm that your computer meets the pre-installation requirements. The
installation program checks your system, and when required, installs any missing software packages.

Complete Installation
Before you start, download the Silk Performer TrueSight executable file or insert the Silk Performer
TrueSight DVD into the DVD drive.
Features installed with a complete Silk Performer TrueSight installation:
• Workbench
• Visual Studio .NET Add-On (only if Visual Studio is installed)
• Performance Explorer
• TrueLog Explorer
• Java Explorer
• .NET Explorer
• All samples
Note: To avoid potential issues, make sure to run the installation with an administrator account that
has unrestricted rights.

1. Locate and double-click the Silk Performer TrueSight executable file.

If you have a Silk Performer TrueSight DVD, insert it. If the setup wizard does not start automatically,
click Start > Run and enter <cddrive>:\Setup.exe.
The setup wizard opens, displaying the Copyright Information page.
2. Click Next to read the Introduction, then click Next again. The License Agreement page displays.
3. Read the license agreement carefully. If you accept the terms of the agreement, click the I accept the
terms of the License Agreement option button, then click Next. The Choose Install Folder page
displays.
4. Specify the installation folder. Note that product subfolders (for Silk Performer TrueSight or TrueLog
Explorer, for example) will be created automatically. Select whether or not a desktop shortcut icon shall
be created and then click Next.
To change the default installation directory, perform the following steps:
a) Click Choose. The Browse For Folder dialog box opens.
b) Specify the folder in which you want to install Silk Performer TrueSight, and then click OK to return to
the Choose Install Folder page.
Note: Silk Performer TrueSight must be installed on a local drive.

The Pre-Installation Summary page displays.

5. Review the provided information and perform one of the following steps:
• To change any settings, click Previous to return to the appropriate page.
• If you are satisfied with the settings, click Install to start the installation process.
The status bar on the Installing page provides information about the installation process.
6. Click one of the following option buttons, then click Next:

6 | Installing Silk Performer TrueSight

 • Evaluation – Installs an evaluation version of Silk Performer TrueSight, which grants you full product
functionality for 45 days. The usage is limited to 10 virtual users. To upgrade to a full version at a
later point in time, contact your sales representative.
• Licensed – Installs an unrestricted version of Silk Performer TrueSight, which requires a Silk
Performer TrueSight license.
7. Depending on the components you have selected for installation, the Select Silk Meter License Server
page displays. If you have not installed any of the components that require licensing and the page does
not open, proceed to the next step. Click one of the following option buttons, then click Next:
• Using local or remote server: In the License server host field, type the name of the computer on
which Silk Meter is installed. Do not change the default port number, 5461, unless your network
administrator has defined a different port. Click Test Connection to verify that a Silk Meter server is
accessible on the specified host and port.
Note: In some cases, specifying the simple name of the license server in the License server
host field, such as licenseserver, might not work. A message box stating Connection to
Silk Meter license server failed opens. To resolve this issue, specify the hostname
by using a fully qualified name, such as licenseserver.mycompany.com.
• Using a standalone license: Runs Silk Meter standalone. Specify the location of your Silk Meter
license file using the Choose button.
The Network Emulation Driver Installation page displays.
8. Select one of the following options, then click Next:
• you can Install the network emulation driver, or
• you can skip network emulation driver installation.
Note: During installation and uninstallation of the network emulation driver, the network will be
disconnected for a moment.
Note: The network emulation driver is not compatible with all network adapters. In such a case,
machines or network interfaces might no longer be accessible and the network might slow down.
The Installation Complete page displays.
9. Click Done to complete the installation.
Note: If the setup wizard fails to update a file during the installation because a system library is
locked by Windows, you are prompted to restart your computer. If you do not restart your
computer, you might experience problems when accessing Silk Performer TrueSight.

In case the installation fails, you can view the installation's log file Install.log in the installation folder.

Installing and Uninstalling the Network Emulation Driver

Manually
1. Open an elevated command prompt: right-click the command prompt and click Run as administrator.
2. Navigate to the Silk Performer TrueSight installation folder by entering a string that resembles the
following: c:\> cd "c:\Program Files (x86)\Silk\Silk Performer <version>
\NetworkDriver"
3. Enter the following command ...
• to install the network emulation driver: installNetworkDriver.exe -i netipfw.inf
• to uninstall the network emulation driver: installNetworkDriver.exe -u

Installing Silk Performer TrueSight |7

 Note: During installation and uninstallation of the network emulation driver, the network will be
disconnected for a moment.
Note: The network emulation driver is not compatible with all network adapters. In such a case,
machines or network interfaces might no longer be accessible and the network might slow down.

Installing ShopIt V 6.0

The Silk Performer TrueSight sample web application is ShopIt V 6.0. ShopIt V 6.0 simulates a simple e-
commerce website with a catalog of camping merchandise that is available for simulated online purchase.
Use this application to experiment with Silk Performer TrueSight web application capabilities. ShopIt V 6.0
is designed to generate errors, including missing links (due to merchandise being out of stock) and session
errors.
Before you install ShopIt V 6.0, refer to the Release Notes to ensure that your system supports the use of
ShopIt V 6.0.
ShopIt V 6.0 setup is available from the following locations:
• You can start it from the Silk Performer TrueSight installation DVD: \Extras\ShopItV60.exe
• You can download it from the product updates site.

1. Double-click the file ShopItV60.exe

Note: IIS (Internet Information Server) must be installed on the computer. For IIS 7, also install
Role Services ASP and ISAPI Extensions.
InstallShield prepares the installation and then the Welcome page opens.
2. Click Next. The Choose Destination Location page opens.
3. To change the default installation directory, click Browse to open the Choose Folder dialog box.
The default installation destination is displayed in the Destination Folder section.
Specify the folder to which you want to install ShopIt V 6.0, then click OK to return to the previous dialog
box.
4. Click Next to continue the installation process.
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.
The Specify Virtual Directory dialog box opens.
5. Setup installs the files and configures IIS to run the ShopIt V 6.0 web application. The Installation
Complete dialog box opens.
6. Click Finish on the Installation Complete dialog box. The ShopIt V 6.0 web application is now ready
for use. You can access ShopIt V 6.0 with a browser of your choice by entering the following URL:
http://<computer name>/<virtual directory name>/

Example:
If the name of your computer is JohnSmith and you have not modified the default value ShopItV60
for the virtual directory, the URL is:
http://JohnSmith/ShopItV60/

Or, if you access ShopIt V 6.0 from the computer on which you installed it, the following URL also
works:
http://localhost/ShopItV60/
7. For IIS 7: Add the virtual directory to IIS manually.
• Alias: ShopItV60

8 | Installing Silk Performer TrueSight

 • Physical path: Install directory of ShopIt.

Installing the Eclipse Plug-In

You can download the Eclipse Plug-In from the product updates site or from your DVD.
The Eclipse SDK and Silk Performer TrueSight must be installed your computer. Make sure to run Silk
Performer TrueSight at least once before you start the installation.

1. Use the standard procedure for installing Eclipse plug-ins from the Eclipse SDK ( Help > Install New
Software ).
If you are not sure how to install plug-ins in Eclipse, refer to the Eclipse documentation.
2. When asked for the site to add, specify the site that contains your Silk Performer TrueSight Extras
folder.
The Extras folder is located in the Silk Performer TrueSight installation folder.
3. Browse to and select the Eclipse Plug-in directory in your Silk Performer TrueSight Extras directory
(.../Extras/eclipseplugin/).
4. Make sure that the Group items by category check box is not checked.
5. Once the Silk Performer TrueSight Eclipse Plug-in is listed, click the plus sign of the new local site to
expand its contents.
6. Check the check box of the plug-in feature (Silk Performer STM Feature) and then click Install. The
Install dialog box opens.
7. Click Next. A license description appears on the Install dialog box.
8. If you agree to the terms of the license agreement, click the I accept the terms of the license
agreement option button and then click Finish.
9. Click Yes to restart the Eclipse Workbench. When the Eclipse Workbench is restarted, a Silk Performer
TrueSight menu entry appears in the Eclipse Workbench.

Uninstalling Silk Performer TrueSight

The remove functionality uninstalls a given software package from your computer, including all files and
registry entries.

1. Open the Windows Add or Remove Programs window.

2. From the list of installed software, select Silk Performer STM 16.5.
3. Click Uninstall/Change. The Change Silk Performer STM 16.5 Installation wizard opens.
4. Click Next. The Remove Features page displays.
5. Click Next to start the uninstallation. The status bar provides information about the uninstallation
progress. The Uninstallation Complete page displays.
6. The Uninstallation Complete page provides you with information about items that could not be
removed. These are usually shared files that should not be removed. Files that were created while
working with Silk Performer TrueSight are also not deleted, for example your Silk Performer TrueSight
projects. Click Done to complete the uninstallation.

Uninstalling in Silent Mode

The setup provides the possibility to uninstall Silk Performer TrueSight without any user interaction. This
option is called silent mode uninstallation.

Installing Silk Performer TrueSight |9

 1. Open a command line prompt and navigate to the following folder: <Silk Performer home>\_Silk
Performer 16.5_installation
2. Execute the following command: "Change Silk Performer 16.5 Installation.exe" -i
silent

Example
C:\Program Files (x86)\Silk\Silk Performer 16.5\_Silk
Performer 16.5_installation\
"Change Silk Performer 16.5 Installation.exe" -i silent

10 | Installing Silk Performer TrueSight

Index
C manual driver uninstallation 7

complete
installation 4, 6, 8, 9 O
overview
E installing Silk Performer 6
introduction 4
Eclipse plug-in
installing 9
R
I removing installed features 9

installation
overview 4, 6 S
ShopIt sample Web application 8 ShopIt sample Web application 8
uninstalling 9 silent mode
uninstallation 9
N
network emulation W
manual driver installation 7 Windows Installer service 9

Index | 11