Skip to main content Skip to complementary content

PutServer

Adds a new Replicate/Compose Server or updates the server definition (Connection Properties) if the specified server already exists. This method can be used together with AemGetServer in order to update the connection properties of an existing server.

First call AemGetServer, then edit the returned properties as required, and finally, call AemPutServer.

Required User Role: See Required Enterprise Manager permissions.

Syntax

public void PutServer(

AemServer payload,

string server

);

Parameters

Parameters
Parameter Type Description

payload

AemServer

AemReplicateServer or AemComposeServer that is inherited from AemServer.

Name

string

The name of the server.

Description

string

The server description.

Host

string

The host name or IP address of the server.

Port

string

The port through which the server is accessed.

Username

string

The user name to connect to the Replicate/Compose Server.

Password

string

The password to connect to the Replicate/Compose Server.

Information noteThe password identifier (GUID) that is returned by GetServer is valid only for the session in which it was generated. Using it in another session (for example as input for PutServer) will result in exception.

VerifyServerCertificate

bool

Set to "true" to ensure the Server certificate is trusted. As a rule, to reduce the chance of "man-in-the-middle" attacks, this option should always be set to "true".

  • When connecting directly to an Qlik Replicate replication server (default port 3552) with its automatically generated self-signed certificate, Qlik Enterprise Manager is able to validate the certificate without requiring any additional setup.
  • When connecting to a Replicate Server via the Replicate UI Server (typically using port 443) or to the Replicate replication server with a user-installed certificate, you must make sure that the SSL/TLS certificate used by the server is trusted by the Qlik Enterprise Manager machine. The same applies when connecting to a Compose Server with a user-installed certificate. You can easily verify whether the certificate is trusted by opening a Chrome browser window on the Qlik Enterprise Manager machine and connecting to Replicate. If there are no security warnings, the certificate is trusted.

For information on the different ways of connecting to Qlik Replicate, see Qlik Replicate Server Requirements in the Qlik Enterprise Manager Help.

Monitored

bool

Whether to retrieve tasks and messages from this server or not.

server

string

The name of the server.

Return values

N/A

Errors

All of the general errors as well as the errors listed in the table below.

Error responses
Error Message Description

DESERIALIZE_TO_TYPE

"Failed to deserialize json to type AemServer: {message}"

Returned when the JSON format is invalid. For example, such an error will be returned if the JSON contains an unknown role.

AEM_PUT_SERVER_INNER_ERR

Failed to put server "{server}".

Error: "{message}".

Returned if Qlik Enterprise Manager encounters an error/exception when trying to PUT the server.

AEM_INVALID_SERVER_TYPE

Server type {ServerType} for server "{ServerName}" is not valid.

Returned when an invalid server type is specified.

AEM_NAME_URL_MISMATCH

The name of the server in the request does not match the one that is specified in the URL.

Returned when the name of the server in the request does not match the one that is specified in the URL.

AEM_EMPTY_HOST

The host is missing from the request.

Returned when the host is missing from the request.

AEM_EMPTY_PORT

The port is missing from the request.

Returned when the port is missing from the request.

AEM_EMPTY_USERNAME

The username is missing from the request. Returned when the user name is missing from the request.

AEM_EMPTY_PASSWORD

The password is missing from the request. Returned when the password is missing from the request.
AEM_INVALID_PORT The port is invalid.

Returned when the specified port is not valid.

AEM_INVALID_USERNAME

The user name is invalid.

User names cannot exceed 104 characters and can contain all Unicode characters except for the following characters: Forward slash (/), Left square bracket ([), Right square bracket (]), Colon (:), Semicolon (;), Vertical bar (|), Equal sign (=), Plus sign (+), Asterisk (*), Question mark (?), Left angle bracket (<), Right angle bracket (>), Double quote (\").

Returned when the specified user name is not valid.

AEM_INVALID_DESC

The description is invalid.

Descriptions cannot exceed 250 characters.

Returned when the description exceeds 250 characters.

AEM_INVALID_HOST

The host is invalid.

Hosts cannot exceed 64 characters and can only contain letters (a-z or A-Z), digits, spaces, dots (.), dashes (-), and underscores (_).

Returned when the server host name exceeds 64 characters or contains invalid characters.

AEM_INVALID_NAME

The name of the server is invalid.

Server names cannot exceed 64 characters and can only contain letters (a-z or A-Z), digits, spaces, dots (.), dashes (-), and underscores (_).

Returned when the server name exceeds 64 characters or contains invalid characters.

AEM_HOST_PORT_ALREADY_EXIST

Host {name/IP} and port {number} are already in use by another server.

Returned when both the server host name/IP address and the server port are already in use by another server.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!