Silk Performance Manager Installation and Setup Help

Transcription

1 Silk Performance Manager 18.5 Installation and Setup Help

2 Micro Focus The Lawn Old Bath Road Newbury, Berkshire RG14 1QN UK Copyright Micro Focus. All rights reserved. MICRO FOCUS, the Micro Focus logo, and Silk Performance Manager 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. All other marks are the property of their respective owners

3 Contents Introduction 1 Pre-Installation Requirements 1 Contacting Customer Support 3 Chapter 1 Installation 5 Overview 6 Standard Installation 7 Advanced Installation 10 Execution Server Setup 15 Upgrading to Silk Performance Manager Silk Performance Manager 18.5 Maintenance 22 Parallel Installations 22 Chapter 2 Choosing a Database 25 Overview 25 Choosing a Relational Database Management System (RDBMS) 26 Configuring Your RDBMS 26 Database Size Calculation 27 Index 29 Silk Performance Manager Installation and Setup Help iii

4 iv Silk Performance Manager Installation and Setup Help

5 Introduction What you will learn This manual provides all the information you need to install or uninstall Silk Performance Manager It describes hardware and software requirements and details the various setup options. The information in this document also helps you configure database access and begin using Silk Performance Manager This chapter contains the following sections: Section Page Pre-Installation Requirements 1 Contacting Customer Support 3 Pre-Installation Requirements Each computer you wish to use in your Performance Manager environment must meet minimum hardware and software requirements. Depending on which setup option you choose, there may be additional requirements. Preinstallation requirements are listed below. Silk Performance Manager 18.5 Hardware Requirements Enterprise installation If you wish to install Performance Manager as an enterprise system, the Performance Manager servers (application server, front-end server, charting server, execution server, and database system) should be installed on separate machines, as outlined in Advanced Installation. You may also install any Silk Performance Manager Installation and Setup Help 1

6 INTRODUCTION Pre-Installation Requirements Demo Installation combination of these components on separate machines. To improve performance however, it s recommended that the database system be installed separately, as a standalone system. Each computer in your system must meet the following minimum requirements: Processor: Intel Core i5 or better Memory: 6 GB minimum Free disk space: 30 GB minimum, except for the database server Network: 100 MBit Power supply: Uninterruptible power supply (UPS) for all environments to reduce risks of power outages If you wish to install Performance Manager for demonstration purposes, all components can run on a single machine. Note however that, due to system resource limitations, such an installation won t provide full performance. Silk Performance Manager 18.5 Software Requirements Operating System In addition to the preceding hardware requirements, your system must also meet certain software conditions to ensure the efficient setup and use of Performance Manager. The availability of these requirements is checked when the Setup Launcher opens. Silk Performance Manager 18.5 cannot be installed while required components are missing. Your computer must be running one of the following operating systems: Microsoft Windows Server 2008 R2 Service Pack 1 64-bit Microsoft Windows Server 2012 Microsoft Windows Server 2012 R2 Microsoft Windows Server 2016 Microsoft Windows 7 32-bit/64-bit Service Pack 1 (execution server) Microsoft Windows 8 32-bit/64-bit (execution server) Microsoft Windows bit/64-bit (execution server) Microsoft Windows bit/64-bit (execution server) 2 Silk Performance Manager Installation and Setup Help

7 INTRODUCTION Contacting Customer Support Important: Update for Universal C Runtime in Windows is required for all Microsoft Windows operating systems. For Microsoft Windows Server 2016, the installation option Windows Server (Server with Desktop Experience) is required. MS SQL Server Adobe Acrobat Reader To use Performance Manager, you must create a repository. Silk Performance Manager 18.5 supports MS SQL Server 2012, 2014 and 2016, including MS SQL Server Express. Note MS SQL Server Express is only recommended and supported for demonstration and evaluation purposes. For production installations, MS SQL Server must be used. Once both Performance Manager and SQL Server have been installed and are operational, you can create the Performance Manager repository (see Performance Manager Administration Help for more information on creating a repository). For instructions on an independent installation of MS SQL Server Express, or for setting up a repository within an alternative database system, see Advanced Installation. You will need a PDF viewer to view the documentation that s provided with Performance Manager. If no PDF viewer or Adobe Acrobat Reader is available, you can download the Adobe Acrobat Reader from the Adobe home page. Operating System - Administrator Privileges To install the Performance Manager software, you must have Windows administrator privileges. If you don t have administrator privileges, you ll receive an error message when the Windows Installer Service opens the installation package and performs the initial requirements checks. Contacting Customer Support Questions? Need help? Micro Focus is committed to providing world-class technical support and consulting services. Micro Focus provides worldwide support, delivering timely, reliable service to ensure every customer's business success. Silk Performance Manager Installation and Setup Help 3

8 INTRODUCTION Contacting Customer Support All customers who are under a maintenance and support contract, as well as prospective customers who are evaluating products, are eligible for customer support. Our highly trained staff respond to your requests as quickly and professionally as possible. How to contact Technical Support Customer Information Visit to communicate directly with Micro Focus SupportLine to resolve your issues, or supportline@microfocus.com. Visit Micro Focus SupportLine at for upto-date support news and access to other support information. First time users may be required to register to the site. When contacting Micro Focus SupportLine, please include the following information if possible. The more information you can give, the better Micro Focus SupportLine can help you. The name and version number of all products that you think might be causing an issue. Your computer make and model. System information such as operating system name and version, processors, and memory details. Any detailed description of the issue, including steps to reproduce the issue. Exact wording of any error messages involved. Your serial number. To find out these numbers, look in the subject line and body of your Electronic Product Delivery Notice that you received from Micro Focus. 4 Silk Performance Manager Installation and Setup Help

9 1 Installation 1Chapter In this chapter This chapter takes you through the process of installing, uninstalling and customizing Silk Performance Manager The Silk Performance Manager 18.5 setup offers the flexibility of creating an application environment that meets your needs. You may want to read through the various options before deciding how to proceed. Each setup option must meet certain pre-installation requirements, as outlined in Pre-Installation Requirements. After fulfilling these requirements, proceed to the instructions for the setup option of your choice. This chapter contains the following sections: Section Page Overview 6 Standard Installation 7 Advanced Installation 10 Execution Server Setup 15 Upgrading to Silk Performance Manager Silk Performance Manager 18.5 Maintenance 22 Parallel Installations 22 Silk Performance Manager Installation and Setup Help 5

10 Overview Overview Standard Installation Advanced Installation Execution Server Silk Performer Monitor Workbench This chapter explains the setup options that are available when installing Silk Performance Manager The setup you choose depends on the application environment you want to create and the resources that are available to you. The Silk Performance Manager 18.5 setup program enables you to install all Performance Manager software components on a single computer or install components individually on separate computers. To install Silk Performance Manager 18.5, your computer system must meet the requirements outlined in Pre-Installation Requirements. The installation program checks that your system meets these requirements and then enables you to install all necessary software. Warning It is essential that you ensure that only one application server is connected to a specific Performance Manager database (repository). Connecting multiple application servers to a single Performance Manager database will result in data inconsistency. Standard Installation setup installs a complete Silk Performance Manager 18.5 system on a single computer. It requires minimal user input as it automatically configures a local Web server, application server, chart server, and execution server. This installation type is ideal for demonstration purposes. Advanced Installation setup gives you full control over the Silk Performance Manager 18.5 installation. This option must be used if you plan to set up a distributed environment. Note If setup finds an Internet Information Server installation, it will be selected as the default Web Server for hosting the Performance Manager home page. For details on setting up SSL on the Silk Performance Manager Web server, see the Silk Performance Manager Administration Help. Selecting the Execution Server option installs a Performance Manager execution server on your machine. This option can be used to set up distributed test/monitoring execution computers. Silk Performance Manager 18.5 uses Silk Performer Monitor Workbench for creating monitor scripts. Silk Performer Monitor Workbench is available as a separate setup package. For more information about Silk Performer, see the accompanying documentation. 6 Silk Performance Manager Installation and Setup Help

11 Standard Installation Standard Installation The Standard Installation option should be used to set up standalone installations, where all features are installed on a single machine. Use the following instructions to install a standalone version of Silk Performance Manager To customize your Performance Manager installation, see Advanced Installation. Note Remember that standalone installations do not provide the full performance of Silk Performance Manager This installation type should only be used for demonstration purposes. Warning When installing Performance Manager on a computer where a previous version of Performance Manager is already installed, the server services of both versions are launched on startup. See Parallel Installations for detailed information about how to disable the services that you want to deactivate. Procedure To install a standalone Performance Manager environment: 1 Locate the Silk Performance Manager 18.5 executable. - If you have a Silk Performance Manager 18.5 DVD: Insert your DVD. If the Setup Program does not start automatically, manually start the Performance Manager Setup Program by selecting Start/ Run and typing <DVD drive>:\setup.exe. - If you have already downloaded Performance Manager: o Navigate to the location in which you saved the.exe file, and double-click this file. - If you are downloading Performance Manager: o Navigate to and follow the instructions to download your software. o Save the executable to a location on your disk. o Navigate to the location in which you saved the.exe file, and double-click this file. Note If your Windows TEMP environment variable does not point to a valid directory, an error message will be displayed. In order to successfully install Performance Manager, your TEMP environment variable must point to a valid directory. To reset your TEMP environment variable: Silk Performance Manager Installation and Setup Help 7

12 Standard Installation a b c d e Click Start/Settings/Control Panel and double-click the System icon. Click the Advanced tab, then click Environment Variables. Under User Variables or System Variables, double-click the TEMP variable. Enter a valid directory, then click OK. Restart the Performance Manager installation by double-clicking the.exe file. 2 Choose whether to remove the installation files when installation completes and then click Next. If you do not plan to run setup again later, you might choose to unpack the files to a temporary location that is automatically removed after installation completes. Setup extracts, prepares, and installs the files that are needed for installation. 3 A welcome dialog appears. Click Next to continue. 4 The Setup Launcher checks that your computer fulfills the 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 the next step. The Performance Manager 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 Performance Manager installation. If your computer does not meet all requirements, you cannot proceed with the installation. Install these required components prior to installing Performance Manager. Once your computer meets all the Pre-Installation Requirements outlined in the introduction, you can proceed with the installation. a 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. b Once all requirements have been met, the Continue button is enabled. Click this button to begin the installation of Silk Performance Manager The InstallShield Wizard welcome dialog appears. 8 Silk Performance Manager Installation and Setup Help

13 Standard Installation 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. Note If you want to read the Silk Performance Manager 18.5 Release Notes document, click the Open the Release Notes button. This document contains last-minute information that has not been incorporated in the Performance Manager documentation. To avoid problems, you should read this document before installing any Performance Manager components. Click Next to continue the installation. 6 The License Agreement appears. Read the license agreement carefully. If you accept the terms of the agreement, click Yes to continue. 7 The Setup Type dialog appears. Choose Silk Performance Manager 18.5 Standard Installation to install a standalone Performance Manager 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 want to install Performance Manager, then click OK to return to the previous dialog. Note Performance Manager can only be installed on local drives. You will receive an error message if you specify an invalid installation destination. On the Setup Type dialog, click Next to continue the installation. 8 The Installation options summary dialog lists the settings you have selected during setup. Review the provided information. If you want to change any settings, click Back to return to the appropriate dialog. If you are satisfied with the settings, click Next to begin the installation process. 9 The status bar of the Setup Status dialog provides information about the installation process. 10 Once the installation is complete, the InstallShield Wizard Complete dialog is displayed. Select the "Open the Silk Performance Manager Administration Help" check box if you want to view this documentation. Silk Performance Manager Installation and Setup Help 9

14 Advanced Installation Click Finish to complete the installation. Note A log file is generated during the installation process. If errors occur during installation, or if you experience problems accessing Silk Performance Manager 18.5, this log file may contain information that will be helpful in identifying the cause of the problems. You can access the installation log file at the following location: C:\Users\<username>\AppData\Local\Temp\SPM<version>.l og Alternative If the InstallShield Wizard fails to update a file during the installation (for example, 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 do not restart your computer you may experience problems when accessing Performance Manager. Advanced Installation Advanced Installation setup gives you full control over the Silk Performance Manager 18.5 installation. This option must be used if you plan to set up a distributed environment. Use the following instructions to install a distributed Silk Performance Manager 18.5 environment. Warning When installing a Performance Manager server on a computer where a previous version of Performance Manager is already installed, the server services of both versions are launched on start-up. See Parallel Installations for detailed information about how to disable the services that you want to deactivate. Procedure To install a distributed Performance Manager environment: 1 Locate the Silk Performance Manager 18.5 executable. - If you have a Silk Performance Manager 18.5 DVD: Insert your DVD. If the Setup Program does not start automatically, manually start the Performance Manager Setup Program by selecting Start/ Run and typing <DVD drive>:\setup.exe. - If you have already downloaded Performance Manager: o Navigate to the location in which you saved the.exe file, and double-click this file. - If you are downloading Performance Manager: 10 Silk Performance Manager Installation and Setup Help

15 Advanced Installation o Navigate to and follow the instructions to download your software. o Save the executable to a location on your disk. o Navigate to the location in which you saved the.exe file, and double-click this file. Note If your Windows TEMP environment variable does not point to a valid directory, an error message will be displayed. In order to successfully install Performance Manager, your TEMP environment variable must point to a valid directory. To reset your TEMP environment variable: a Click Start/Settings/Control Panel and double-click the System icon. b Click the Advanced tab, then click Environment Variables. c d e Under User Variables or System Variables, double-click the TEMP variable. Enter a valid directory, then click OK. Restart the Performance Manager installation by double-clicking the.exe file. 2 Choose whether to remove the installation files when installation completes and then click Next. If you do not plan to run setup again later, you might choose to unpack the files to a temporary location that is automatically removed after installation completes. Setup extracts, prepares, and installs the files that are needed for installation. 3 A welcome dialog appears. Click Next to continue. 4 The Setup Launcher checks that your computer fulfills the necessary requirements (see Pre-Installation Requirements ). If one or more requirements are not fulfilled, the Setup Launcher dialog appears. The Performance Manager 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 Silk Performance Manager Installation and Setup Help 11

16 Advanced Installation a your machine that must be installed before you can proceed with the Performance Manager installation. If your computer does not meet all requirements, you cannot proceed with the installation. Install these required components prior to installing Performance Manager. Once your computer meets all the Pre-Installation Requirements outlined in the introduction, you can proceed with the installation. 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. b Once all requirements have been met, the Continue button is enabled. Click this button to begin the installation of Silk Performance Manager The InstallShield Wizard Welcome Dialog displays general information about the package contents. 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. Note If you want to read the Silk Performance Manager 18.5 Release Notes document, click the Open the Release Notes button. This document contains last-minute information that has not been incorporated in the Performance Manager documentation. To avoid problems, you should read this document before installing any Performance Manager components. Click Next to continue the installation. 6 The License Agreement appears. Read the license agreement carefully. If you accept the terms of the agreement, click Yes to continue. 7 The Setup Type dialog appears. Choose Silk Performance Manager 18.5 Advanced Installation to install a distributed Performance Manager 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 want to install Performance Manager, then click OK to return to the previous dialog. 12 Silk Performance Manager Installation and Setup Help

17 Advanced Installation Note Performance Manager may only be installed on local drives. You will receive an error message if you specify an invalid installation destination. On the Setup Type dialog box, click Next to continue the installation. 8 The InstallShield Wizard Select Features dialog box opens. By default, the Advanced Installation setup installs all components incorporated in the Silk Performance Manager 18.5 package. To set up a distributed environment, select the components you want to install on each computer. - To install the Silk Performance Manager Web Server (front-end server), select the Silk Performance Manager Web Server option. If Microsoft Internet Information Services (IIS) is installed on your system, and the default IIS site is running, IIS is selected as the default Silk Performance Manager Web Server and an Internet Server Application Program Interface (ISAPI) filter is installed to perform the URL parsing. If IIS is not detected, this option is not available, and the Silk Performance Manager Tomcat Web Server is selected by default. To use IIS as the Silk Performance Manager Web Server, you need to install the IIS features before installing Silk Performance Manager 18.5: o CGI o ISAPI Extensions o ISAPI Filters Note You must install a Web-based product with the server. Note Choose only one Web server option. The InstallShield Wizard will report an error message if you select more than one Web server type for installation. Note The front-end server must be located in the same LAN as the application server, otherwise the application system will suffer from the slowed down internal network traffic. Note You can install multiple front-end servers, each on a dedicated computer, that connect to one application server. Refer to the Performance Manager Administration Help for detailed information on configuring the location of the application server. Silk Performance Manager Installation and Setup Help 13

18 Advanced Installation - To install the Silk Performance Manager Application Performance Monitoring System, select the Performance Manager option under the Products section. - To install the Performance Manager Application Server, select the Performance Manager Application Server option. - To install the Performance Manager Execution Server, select the Performance Manager Execution Server option. - To install the Performance Manager Chart Server, select the Performance Manager Chart Server option. Note We recommended to install the chart server on a separate computer due to its high memory consumption when handling reporting requests. Click Next to continue. 9 The Installation options summary dialog lists the settings you have chosen during setup. Review the provided information. If you want to change any settings, click Back to return to the appropriate dialog. If you are satisfied with the settings, click Next to begin the installation process. 10 The status bar of the Setup Status dialog provides information about the installation process. 11 When the installation is complete the InstallShield Wizard Complete dialog will be displayed. Select the option "Open the Silk Performance Manager Administration Help" if you want to view this documentation. Click Finish to complete the installation. Note A log file is generated during the installation process. If errors occur during installation, or if you experience problems accessing Silk Performance Manager 18.5, this log file may contain information that will be helpful in identifying the cause of the problems. You can access the installation log file at the following location: C:\Users\<username>\AppData\Local\Temp\SPM<version>.l og 14 Silk Performance Manager Installation and Setup Help

19 Execution Server Setup Alternative If the InstallShield Wizard fails to update a file during the installation (for example, 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 do not restart your computer you may experience problems when accessing Performance Manager. Execution Server Setup Choose this option to install a Performance Manager Execution Server on your computer. You must install an Execution Server on each POP (Point of Presence) that you want to use as a remote Performance Manager Execution Server. The Execution Server is used to execute Performance Manager monitors on remote computers. Warning When installing an execution server on a computer where a previous version of Performance Manager is already installed, the server services of both versions are launched on start-up. See Parallel Installations for detailed information about how to disable the services that you want to deactivate. Procedure To install a Performance Manager Execution Server: 1 Locate the Silk Performance Manager 18.5 executable. - If you have a Silk Performance Manager 18.5 DVD: Insert your DVD. If the Setup Program does not start automatically, manually start the Performance Manager Setup Program by selecting Start/ Run and typing <DVD drive>:\setup.exe. - If you have already downloaded Performance Manager: o Navigate to the location in which you saved the.exe file, and double-click this file. - If you are downloading Performance Manager: o Navigate to and follow the instructions to download your software. o Save the executable to a location on your disk. o Navigate to the location in which you saved the.exe file, and double-click this file. Silk Performance Manager Installation and Setup Help 15

20 Execution Server Setup Note If your Windows TEMP environment variable does not point to a valid directory, an error message will be displayed. In order to successfully install Performance Manager, your TEMP environment variable must point to a valid directory. To reset your TEMP environment variable: a Click Start/Settings/Control Panel and double-click the System icon. b Click the Advanced tab, then click Environment Variables. c d e Under User Variables or System Variables, double-click the TEMP variable. Enter a valid directory, then click OK. Restart the Performance Manager installation by double-clicking the.exe file. 2 A welcome dialog appears. Click Next to continue. 3 The Setup Launcher checks that your computer fulfills the necessary requirements (see Pre-Installation Requirements ). If one or more requirements are not fulfilled, the Setup Launcher dialog appears. The Performance Manager 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 Performance Manager installation. If your computer does not meet all requirements, you cannot proceed with the installation. Install these required components prior to installing Performance Manager. Once your computer meets all the Pre-Installation Requirements outlined in the introduction, you can proceed with the installation. a 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. b Once all requirements have been met, the Continue button is enabled. Click this button to begin the installation of Silk Performance Manager The InstallShield Wizard Welcome Dialog displays general information about the package contents. 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. 16 Silk Performance Manager Installation and Setup Help

21 Execution Server Setup Note If you want to read the Silk Performance Manager 18.5 Release Notes document, click the Open the Release Notes button. This document contains last-minute information that has not been incorporated in the Performance Manager documentation. To avoid problems, you should read this document before installing any Performance Manager components. Click Next to continue the installation. 5 The License Agreement appears. Read the license agreement carefully. If you accept the terms of the agreement, click Yes to continue. 6 The Setup Type dialog appears. Choose Silk Performance Manager 18.5 Execution Server to install only a Performance Manager execution server. 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 want to install Performance Manager, then click OK to return to the previous dialog. Note Performance Manager can only be installed on local drives. You will receive an error message if you specify an invalid installation destination. On the Setup Type dialog, click Next to continue the installation. 7 The Installation Options Summary dialog lists the settings you have chosen during setup. Review the provided information. If you want to change any settings, click Back to return to the appropriate dialog. If you are satisfied with the settings, click Next to begin the installation process. 8 The status bar of the Setup Status dialog provides information about the installation process. 9 Once the installation is complete, the InstallShield Wizard Complete dialog is displayed. Click Finish to complete the installation. Silk Performance Manager Installation and Setup Help 17

22 Upgrading to Silk Performance Manager 18.5 Note A log file is generated during the installation process. If errors occur during installation, or if you experience problems accessing Silk Performance Manager 18.5, this log file may contain information that will be helpful in identifying the cause of the problems. You can access the installation log file at the following location: C:\Users\<username>\AppData\Local\Temp\SPM<version>.l og Alternative If the InstallShield Wizard fails to update a file during the installation (for example, 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 do not restart your computer you may experience problems when accessing Performance Manager. Upgrading to Silk Performance Manager 18.5 Considerations When upgrading to a new version of Performance Manager, please be aware of the following facts: If you need to upgrade additional execution servers after the initial upgrade path, re-start the application server and refresh the UI. Ignore any error messages that may display. See Upgrading execution servers for more information. Information that is stored in the database, such as monitors and schedules, is automatically retained during the upgrade. However, information in manually edited configuration files is not retained. Therefore, these files must be backed up before upgrading, and the corresponding files in the upgrade must be edited manually to retain the changes. The timezone of the application server influences the daylight savings time (DST) of schedule exclusions and blackout periods that you have defined. It is therefore important that the timezone of your application server is set correctly. It is recommended that you specify the application server s timezone. Proceed as follows: a b In the conf\appserver folder of the Silk Performance Manager directory on the application server, create a new file named dbupgrade.properties. Open the dbupgrade.properties file with a text editor and add the following line: 18 Silk Performance Manager Installation and Setup Help

23 Upgrading to Silk Performance Manager 18.5 Upgrading execution servers exclusion.timezone = <timezone code> <timezone code> is any valid Java timezone code. A sample list of timezone codes can be found at zones.html. Example: exclusion.timezone = PST c Save and close the file. d Restart the application server service. If the current version contains new canned reports that were not available in the previously installed version, these new reports will not be available in your existing projects when you re-connect to an existing repository. To make new reports available in an existing repository, proceed as follows: Create a new project. A newly created project automatically contains all canned reports, thus making new reports available within the newly created project. To minimize the downtime when upgrading your distributed Performance Manager installation, an automated procedure for simultaneously upgrading all execution servers is available. Before you begin: You need the administrator password for the Performance Manager server. Back up your database. Important: Do not uninstall any Silk Performance Manager components before you have upgraded your execution servers. If you do, you will have to upgrade each execution server manually. The procedure below also applies to patch updates. Note This procedure cannot be performed on an execution server that is installed on the same host computer as Performance Manager. If the user attempts to upgrade such an execution server, the following error message is displayed: Other servers installed no upgrade possible (<version information>) Silk Performance Manager Installation and Setup Help 19

24 Upgrading to Silk Performance Manager 18.5 Procedure To upgrade execution servers to Silk Performance Manager 18.5: 1 On the Performance Manager application server, create a folder named "upgrade" in the current Silk Performance Manager root directory of your application server. Example: C:\Program Files (x86)\silk\silk Performance Manager 18.5\upgrade\ 2 If you are not using the default installation path, locate the file Install.iss in the "execution server only" Web setup package and open it in a text editor of your choice. Locate the szdir tag and define the directory to which the execution server should be installed. Note If you are upgrading to a patch version, the name of the.zip archive differs from the names outlined above. 3 Copy the setup package to the new upgrade directory on your application server. Note If you are upgrading to a patch version, the name of the.zip archive differs from the names outlined above. 4 Log on to the Silk Performance Manager web console as an administrator. 5 Select the Administration/Upgrade tab. The Available Packages list displays the patch that you copied to the upgrade directory. 6 Click the package name to continue to the execution server overview. All active execution servers are listed. Note Deactivated execution servers will not be upgraded. If you want to exclude certain execution servers from the upgrade, make sure to deactivate them before continuing the version upgrade process. 7 Click Start Upgrade and confirm the following message. 8 The Upgrade Status page shows the current status of each execution server s upgrade progress. Use your browser s Refresh button to refresh the displayed information. 9 If an error occurs, the respective step is marked with a red X. You can mouse-over the icon to view the error that has occurred. After fixing the error, click Retry in the Action column to try again. 10 When all execution servers have been upgraded, the Switch link is clickable. Click this link to reboot all execution servers and confirm the following message. 20 Silk Performance Manager Installation and Setup Help

25 Upgrading to Silk Performance Manager 18.5 Upgrading other servers 11 Wait until all execution servers have rebooted. Use your browser s Refresh button to view the current status. If the Version Info column displays the message "Error while retrieving status info", the execution server is still in the process of rebooting. Note If an execution server is started with "Run as process", the application server will not receive a response from the execution server because it is waiting for login credentials. For such execution servers, you must login on the machine before it is responsive. 12 After all execution servers have been upgraded, you can proceed to upgrade the application, front-end, and chart server(s) (see the following procedure). Procedure To upgrade application, front-end, and chart server to Silk Performance Manager 18.5: 1 Back up your Performance Manager repository (database) before you begin upgrading to a new version. 2 If you have made changes to any of the XML-based configuration files in your current installation s /conf directory, or have added new files to this directory, you should make a backup copy of the /conf directory before proceeding. 3 Remove the current installation of Silk Performance Manager s front-end server, application server, and chart server (see Silk Performance Manager 18.5 Maintenance for detailed information). Skip this step if you want to install Silk Performance Manager 18.5 while retaining the previous installation. See Parallel Installations if you choose this approach. 4 Install Silk Performance Manager 18.5 front-end server, application server, and chart server (see Advanced Installation for detailed information). 5 The database settings will automatically be updated, however some advanced configuration settings (for example, displaying the host name in the browser title bar) must be edited manually in the new configuration files with a text or XML editor. For detailed information about advanced settings in the configuration files, consult the Silk Performance Manager Administration Help. Before editing your XML files, make sure that the front-end server service is stopped. 6 After editing your configuration files you must restart the front-end server service. Consult the Silk Performance Manager Administration Help for detailed information about stopping and starting services. Silk Performance Manager Installation and Setup Help 21

26 Silk Performance Manager 18.5 Maintenance 7 After installing the front-end server, application server, and chart server components, you need to connect to the database. This is simply done by entering the correct data on your Web front-end (see the Silk Performance Manager Administration Help for detailed information). Note Your existing database is automatically updated to the current version when you connect. This can take up to several hours, depending on the size of the database and the release of Performance Manager from which you are upgrading. Silk Performance Manager 18.5 Maintenance Uninstalling Performance Manager Windows Installer enables you to remove installed applications. Procedure To remove Performance Manager 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 Silk Performance Manager 18.5 icon. 4 Click the Uninstall/Change button and follow the instructions of the setup wizard. Parallel Installations When installing Silk Performance Manager 18.5 on a computer where a previous version of Performance Manager is already installed, the server services of both versions are launched on start-up. Having two versions of Performance Manager services installed may be desired if you consider a fall-back to the previous version. However you must manually define which services you want to be active, as active identical services of both versions will conflict with each other. Note When you remove the older version of Performance Manager from your computer, the silkroot IIS folder, which is needed by the newer version, is also removed. Therefore the IIS configuration is broken and you need to perform a repair of the new version before the system is usable again. This issue does not occur when you uninstall the older version before installing the new one. 22 Silk Performance Manager Installation and Setup Help

27 Parallel Installations Procedure To disable Performance Manager services 1 Shut down all services of the installed version of Performance Manager that you do not want to be active. Do this by using the Windows Services Manager. 2 Change the service Startup Type of the services you want to disable from Automatic to either Manual or Disabled. 3 Manually restart the Performance Manager services that you want to be active. Silk Performance Manager Installation and Setup Help 23

28 Parallel Installations 24 Silk Performance Manager Installation and Setup Help

29 2 Choosing 2Chapter a Database Introduction What you will learn This chapter provides an overview of the database systems that are supported by Performance Manager. This chapter contains the following sections: Section Page Overview 25 Choosing a Relational Database Management System (RDBMS) 26 Configuring Your RDBMS 26 Database Size Calculation 27 Overview Repositories can only be configured by a System Administrator (see the Silk Performance Manager Administration Help for more information regarding user roles). Once you have installed and configured your Relational Database Management System (RDBMS) and installed Silk Performance Manager 18.5, you can create one or more repositories, or connect to existing repositories. For more information about working with repositories, see the Silk Performance Manager Administration Help. Silk Performance Manager Installation and Setup Help 25

30 2 CHOOSING A DATABASE Choosing a Relational Database Management System (RDBMS) Choosing a Relational Database Management System (RDBMS) To create or access Silk Performance Manager repositories, you must identify which type of database system you want to use. For instructions about connecting to a database, please refer to the Silk Performance Manager Administration Help. Note See the Release Notes for details regarding the databases that are supported by each Silk Performance Manager product. RDBMS Pre-Requisites Server distribution Required information It is recommended that you not install Silk Performance Manager and the RDBMS software on the same machine. The following table describes what you need for each database type. RDBMS Microsoft SQL Server Have ready Server host name and port number. MS SQL Server system username or Windows domain\username, and password. Name for your Silk Performance Manager 18.5 repository. Name of your Silk Performance Manager 18.5 database user and password. Configuring Your RDBMS This section lists additional RDBMS-specific information that you should be aware of when using Silk Performance Manager Note If you plan to upgrade your RDBMS, make sure you stop all Performance Manager services first to avoid result writing activity. Consult the Silk Performance Manager Administration Help for detailed information about stopping and starting services. 26 Silk Performance Manager Installation and Setup Help

31 2 CHOOSING A DATABASE Database Size Calculation Microsoft SQL Server Notes Database user privileges Windows authentication users for SQL Server are supported. To connect to SQL Server with a Windows user account, enter the Username in Silk Performance Manager including the domain information in the format <domain>\<username>. Install and setup Microsoft s SQL Server as described in your RDBMS documentation. Once you ve installed Microsoft SQL Server, you are ready to install Silk Performance Manager Using the database administrator user for maintaining your Silk Performance Manager repository is not recommended due to security risks. If MS SQL Server is your DBMS for Silk Performance Manager, the following database roles (database user privileges) for your Silk Performance Manager repository allow you to work with Silk Performance Manager: db_owner db_ddladmin Either of these two roles allow for creating and configuring repository tables, for working with an already created database, and for installing and upgrading the software. Giving less privileges to the Silk Performance Manager database user will result in errors. Database Size Calculation This section helps you estimate needed disk space for the database server. As data is collected, the database grows in size. The following rules of thumb apply: A measure consumes approximately 100 bytes in the database, while each page timer will require approximately 300 bytes. Health rates have an additional three measures for each transaction. The database size in the example below comes to approximately 175 MB per month. This already includes some TrueLogs on Error. Silk Performance Manager Installation and Setup Help 27

32 2 CHOOSING A DATABASE Database Size Calculation We recommend that you discuss your calculations with your database administrator. 28 Silk Performance Manager Installation and Setup Help

33 2 Index A administrator privileges 3 Adobe Acrobat Reader 3 Advanced installation 10 advanced installation 6 C customer support 4 D Database size calculations 27 Database user privileges SQL Server 27 Databases upgrading 26 DBMS Pre-requisites 26 Supported 26 distributed installation 1, 6 application server 10 chart server 10 execution server 6, 10 front-end server 10 E execution server 6 installation 15 H hardware requirements 1 I Installation Silk Performance Manager Installation and Setup Help 29

34 INDEX Upgrading 18 installation administrator privileges 3 Adobe Acrobat Reader 3 advanced 6 database system 3 demo installation 2 destination path 9, 12, 17 distributed installation 1 execution server 6, 15 hardware requirements 1 MS SQL Server 3 operating system 2 pre-installation requirements 1 release notes 9, 12, 17 repository 3 setup launcher 8, 11, 16 software requirements 2 stand-alone 7 standard 6 standard installation 7 un-install 22 Internet Explorer 3 ISS file 20 L License Agreement 9, 12, 17 licensing License Agreement 9, 12, 17 M MS SQL Server 3, 26 O operating system 2 P Parallel installations 22 pre-installation requirements 1, 8, 11, 16 R RDBMS Pre-requisites 26 Supported 26 release notes 9, 12, 17 repository 3 requirements Adobe Acrobat Reader 3 database system 3 demo installation 2 enterprise installation 1 30 Silk Performance Manager Installation and Setup Help

35 INDEX S hardware requirements 1 operating system 2 pre-installation requirements 1 software requirements 2 setup launcher 8, 11, 16 software requirements 2 SQL Server 27 Database user privileges 27 Requirements 26 Windows authentication 27 stand-alone installation 7 standalone installation 6 standard installation 6, 7 support technical support 4 technical support hours 4 T technical support 4 U Upgrading 18 databases 26 Parallel installations 22 Upgrading to latest version 18 W Windows Installer Service uninstall option 22 Silk Performance Manager Installation and Setup Help 31

36 INDEX 32 Silk Performance Manager Installation and Setup Help