The server installation is launched using the setup.exe bootstrapper. The installation will fail if the server MSI file is invoked directly.
The preferred method of installing EdgeSight Server is to use the bootstrapper and perform the installation using the Citrix EdgeSight Installer user interface. This method offers typical and custom installation options. A typical installation offers only the minimum set of properties required for installation. A custom installation offers the same set of public properties as a command-line installation.
If required, you can perform a command-line installation using the msiexec command. You must specify public properties to define installation settings. Review "Installing EdgeSight Server Using the Command Line" for a description of installation properties.
If you are upgrading, see Upgrading EdgeSight for more information.
If you are monitoring endpoint devices, download EdgeSight for Endpoints license files (CES_*.lic), then manually place them in the MyFiles folder of the license server directory, for example: %ProgramFiles%\Citrix\Licensing\MyFiles. These files will need to be in place prior to running the post-installation wizard.
The bootstrapper performs checks for the following software prerequisites and system characteristics. The conditions checked can be required or recommended. If any of the required conditions is not met, the installation stops. Correct the condition and restart the installation. Recommended conditions are flagged with a warning, but installation can continue at the discretion of the installer.
|.NET Framework 3.5 SP1||Yes|
|Windows Server 2003 or Windows Server 2008||Yes|
|Internet Information Services (IIS) 6.0 or later. See “IIS 7.0 Components Required on Windows Server 2008 Systems” in System Requirements for EdgeSight 5.4 for information specific to IIS 7.0 and Windows Server 2008.||Yes|
|Microsoft Message Queuing (MSMQ). The MSMQ service must be running.||Yes|
|SQL Server 2005 SP1 or later (Standard or better). This can be on a different machine from where the installation is being run.||Yes|
512 megabytes (MB) of RAM
Note that 2GB is recommended.
|No. Installation can continue, but performance may be affected.|
|SSL certificate from a recognized certificate authority. See Install and Configure for more information on SSL certificate considerations.||No, installation can continue, but security may be compromised.|
Note that some requirements for full operation, such as Citrix Licensing and SQL Server Reporting Services, are not checked by the bootstrapper.
Before performing an EdgeSight Server installation, set up a “run as” account for EdgeSight. You will need to supply the account username and password during server installation. Specify the account using the computer name and username (computername\username) or the domain name and username (domainname\username). Do not use a fully qualified domain name (FQDN), as this will result in an installer error.
Note that not all public installation properties are exposed when performing a typical installation using the user interface. Properties not explicitly set from the user interface are set to their default value if one exists. However, performing a custom installation will expose all available properties. The following procedure is based on a custom installation. To install a server using the user interface:
Database names must be unique within an instance of SQL Server and comply with the rules for identifiers. Also, the database name can not contain hyphens, the pipe character ( | ), single quotes, a period (.), or spaces.
For information on identifiers, see SQL Server Books Online for your version of SQL Server.
The MSI file uses public properties to specify custom install settings. You can edit public properties using the following methods:
See your MSI documentation for syntax rules for property values. The following table lists the public properties available when installing the Citrix EdgeSight Server. You only need to specify properties with default values if you want to specify a value other than the default. Also, whether some properties are specified depends on what other properties are being specified. For example, if Windows authentication is not enabled using the WINDOWS_AUTH property, the DBUSERNAME and DBPASSWORD properties must be defined.
|PREREQUISITES_PASSED||If this property is specified with any value, the bootstrapper is bypassed and you are allowed to perform a command-line installation of the server.|
|DATABASEOPTIONS||Specifies whether to install a new Citrix EdgeSight database or upgrade an existing database. Valid values are new or upgrade; the default value is new.|
|DATABASESERVER||The name of the server running an existing Citrix EdgeSight database. It is not necessary to specify a value when running the database locally.|
|DBUSERNAME||The username for the SA user. It is not necessary to specify a value if Windows authentication is enabled (WINDOWS_AUTH=1).|
|DBPASSWORD||The password for the SA user. It is not necessary to specify a value if Windows authentication is enabled (WINDOWS_AUTH=1).|
|WINDOWS_AUTH||Specifies whether to use
Windows authentication. Valid values are
1 (use Windows authentication) or
0 (do not use Windows authentication); the default
Note: If Windows authentication is not used, the DBUSERNAME and DBPASSWORD properties must be defined.
|DBNAME||The name of the Citrix EdgeSight database that will be created during installation. Database names must be unique within an instance of SQL Server and comply with the rules for identifiers. Also, the database name can not contain the pipe character ( | ), single quotes, a period (.), a hyphen (-), or spaces. For information on identifiers, see SQL Server Books Online for the your version of SQL Server. The default value is EdgeSight.|
|ACCOUNTNAME||The account name for the EdgeSight “run as” account. Specify the account using the computer name and username (computername\username) or the domain name and username (domainname\username). Do not use an FQDN.|
|ACCOUNTPASSWORD||The password for the EdgeSight “run as” account.|
|DATAFILESIZE||Specifies the initial size in megabytes of a data file. Each of the eight files in the file group is created using the specified size. The default value is 500 and is sufficient for most installations.|
|LOGFILESIZE||Specifies the initial size in megabytes of the log file. The default value is 500 and is sufficient for most installations.|
|RECOVERYMODEL||Specifies the database recovery model. Valid values are FULL, SIMPLE, and BULK_LOGGED; the default value is SIMPLE.|
|DATADIR||EdgeSight Server uses
temporary files for storing data uploads from agents, including crash reports.
The default directory is
Monitoring\Server\EdgeSight\Data. Because there may be significant
file growth in this directory, it may be desirable to locate this directory on
a separate drive or partition.
Note: The data directory cannot be on a mapped drive.
|EDGEDIR||Contains the web pages, scripts, .Net components and other components that make up the EdgeSight Server Web site. The default value is %ProgramFiles%\Citrix\System Monitoring\.|
|INSTALLOPTIONS||Specifies which components are to be installed. Set the value to full to install the database, Web server, and script handler components. Set the value to dbonly to install only the database component.|
Use the msiexec command to install the server using the command-line interface. Public properties are specified as KEY=value pairs. Note that path names must be enclosed in quotes. The following is a sample msiexec command line:
Msiexec /i EdgeSightServer.msi /l*v logfile.log /qn PREREQUISITES_PASSED=1 WINDOWS_AUTH=1 ACCOUNTNAME=mydomain\myaccount ACCOUNTPASSWORD=mypass DBNAME=EdgeSight50 DATADIR=”D:\Citrix\System Monitoring\Data”
The /i flag is used to specify the package being installed. The /l*v flag is used to specify the installation log file name. (Capturing a verbose installation log is strongly recommended.) Use the /qn (quiet) flag to install an agent with no user interaction. For a complete list of standard MSI command-line arguments, open a Command Prompt window and type msiexec /h to invoke help, or refer to The Command-Line Options for the Microsoft Windows Installer Tool Msiexec.exe at http://support.microsoft.com/kb/314881.
To configure your Citrix EdgeSight Server:
EdgeSight for XenApp, Basic—Basic agents require only that you have a XenApp Enterprise license available on your Citrix License Server.
EdgeSight for XenApp, Advanced—Advanced agents provide the fully featured version of EdgeSight for XenApp and require that you have either a XenApp-Platinum Edition license or an EdgeSight for XenApp license available on your Citrix License Server.
EdgeSight for Endpoints—Endpoint agents provide monitoring and data collection for endpoint devices.
EdgeSight for XenDesktop—EdgeSight for Virtual Desktops agents provide monitoring and data collection for XenDesktop devices.