Fortinet Document Library

Version:

Version:

Version:

Version:

Version:

Version:

Version:

Version:


Table of Contents

EMS Administration Guide

Installing FortiClient EMS using the CLI

Installing FortiClient EMS using the CLI allows you to enable certain options during installation, such as customizing the EMS installation directory, using custom port numbers, and so on.

The following table provides a description of all options available when installing FortiClient EMS using the CLI. These options are case-sensitive:

Option

Description

AllowedWebHostnames

The default value is localhost, 127.0.0.1. To clear this value, first enter AllowedWebHostnames=*, then enter the desired AllowedWebHostnames value. Otherwise, the value entered will be appended to [localhost, 127.0.0.1], so that AllowedWebHostNames=localhost, 127.0.01, <new_value>.

ApacheServerAdminEmail

Enter the Apache Server administrator's email address. By default, this is admin@yourcompany.com.

BackupDir

Enter the desired backup directory path for SQL Server.

ClientDownloadPort

Enter the HTTP port number. The default is 80.

RemoteManagementPort

Enter the HTTPS port number. The default is 443.

InstallFolder

Specify the directory to install EMS to.

InstallSQL

Controls whether the installer will install SQL Server Express on the same server as FortiClient EMS. Enter 1 to install SQL Server Express; otherwise, enter 0. By default, SQL Server Express is installed with FortiClient EMS.

ScriptDB

Controls where the installer will attempt to create the database from db scripts. Enter 1 to create the database from db scripts. 0 should only be entered if databases have already been set up on the server and you are only installing EMS components locally.

ServerHostname

Enter the preferred hostname (the remote hostname). The default is the local host.

SQLAuthType

Enter sql.

SQLCmdlineOptions="/INSTANCEDIR"

Enter the desired directory to install SQL Server Express to.

SQLCmdlineOptions="/INSTANCENAME"

Enter the SQL Server instance name.

SQLEncryptConnection

(Optional) Enter yes to encrypt the connection to SQL Server. Otherwise, enter no. The default is yes.

SQLPort

Enter the port number the remote SQL Server instance is listening on. You should configure SQL Server to use a static port number.

SQLServer

Enter the DSN name of the computer where SQL Server is already installed.

SQLServerInstance

Enter the SQL Server instance name.

SQLService

If using a default database instance, enter the instance name. If using a named database instance, enter mssql$<instance_name>. For example, if your instance is named "database000", enter mssql$database000.

SQLTrustServerCertificate

(Optional) Enter yes to trust the SQL Server certificate on the machine where FortiClient EMS is installed. If entering no, you must install the issuing CA certificate of SQL Server's certificate onto the machine you are connecting FortiClient EMS from.

SQLUser

Enter the SQL username used to connect to the database instance. This must be pre-configured in SQL Server as described in .

SQLUserPassword

Enter the SQL password used to connect to the database instance.

WindowsUser

Enter the Windows username used to connect to the database instance. This must be pre-configured in SQL Server as described in .

WindowsUserPassword

Enter the Windows password used to connect to the database instance.

The following topics describe how to use the options above for specific use cases.

Installing FortiClient EMS using the CLI

Installing FortiClient EMS using the CLI allows you to enable certain options during installation, such as customizing the EMS installation directory, using custom port numbers, and so on.

The following table provides a description of all options available when installing FortiClient EMS using the CLI. These options are case-sensitive:

Option

Description

AllowedWebHostnames

The default value is localhost, 127.0.0.1. To clear this value, first enter AllowedWebHostnames=*, then enter the desired AllowedWebHostnames value. Otherwise, the value entered will be appended to [localhost, 127.0.0.1], so that AllowedWebHostNames=localhost, 127.0.01, <new_value>.

ApacheServerAdminEmail

Enter the Apache Server administrator's email address. By default, this is admin@yourcompany.com.

BackupDir

Enter the desired backup directory path for SQL Server.

ClientDownloadPort

Enter the HTTP port number. The default is 80.

RemoteManagementPort

Enter the HTTPS port number. The default is 443.

InstallFolder

Specify the directory to install EMS to.

InstallSQL

Controls whether the installer will install SQL Server Express on the same server as FortiClient EMS. Enter 1 to install SQL Server Express; otherwise, enter 0. By default, SQL Server Express is installed with FortiClient EMS.

ScriptDB

Controls where the installer will attempt to create the database from db scripts. Enter 1 to create the database from db scripts. 0 should only be entered if databases have already been set up on the server and you are only installing EMS components locally.

ServerHostname

Enter the preferred hostname (the remote hostname). The default is the local host.

SQLAuthType

Enter sql.

SQLCmdlineOptions="/INSTANCEDIR"

Enter the desired directory to install SQL Server Express to.

SQLCmdlineOptions="/INSTANCENAME"

Enter the SQL Server instance name.

SQLEncryptConnection

(Optional) Enter yes to encrypt the connection to SQL Server. Otherwise, enter no. The default is yes.

SQLPort

Enter the port number the remote SQL Server instance is listening on. You should configure SQL Server to use a static port number.

SQLServer

Enter the DSN name of the computer where SQL Server is already installed.

SQLServerInstance

Enter the SQL Server instance name.

SQLService

If using a default database instance, enter the instance name. If using a named database instance, enter mssql$<instance_name>. For example, if your instance is named "database000", enter mssql$database000.

SQLTrustServerCertificate

(Optional) Enter yes to trust the SQL Server certificate on the machine where FortiClient EMS is installed. If entering no, you must install the issuing CA certificate of SQL Server's certificate onto the machine you are connecting FortiClient EMS from.

SQLUser

Enter the SQL username used to connect to the database instance. This must be pre-configured in SQL Server as described in .

SQLUserPassword

Enter the SQL password used to connect to the database instance.

WindowsUser

Enter the Windows username used to connect to the database instance. This must be pre-configured in SQL Server as described in .

WindowsUserPassword

Enter the Windows password used to connect to the database instance.

The following topics describe how to use the options above for specific use cases.