Skip to content

Server configuration

The first time you start a new client, the Server configuration dialog opens where you can configure the connection to the server.

Info

You may need some information from your system administrator for the server configuration. We recommend that you read this section carefully before starting the configuration so that you can clarify all questions in advance.

  1. Double click on the client shortcut.

  2. The Server configuration dialog opens.

    Figure: Server settings dialog

  3. Select Add.

  4. Enter a name for this server configuration in the Configuration name field. Your system administrator can tell you whether you should use a specific name. If this is not the case, assign a configuration name of your choice.
  5. Enter the name or IP address of the octoplant server in the Server address field.
  6. Activate the checkbox if you want to use the Single Sign-On option.
  7. If necessary, change the port numbers if the default port numbers in your network are occupied. Your system administrator can tell you whether this is necessary.
    You cannot enter the port for the Api manually. It is specified by the octoplant server and is only displayed when you test the connection or establish a connection to the server for the first time. You can change it on the server if necessary.
  8. Select Test connection to test the connection to the server. All ports of the octoplant server require a green checkmark, if the checkmark is red, you must change the port.
  9. The port for the database server is detected by the octoplant server and displayed here for information.
  10. Select Save and Close.
  11. The splash screen is now displayed with the newly configured server selected.

  12. Enter a valid Username, Password and Domain if necessary. These settings are made by the user when the server is installed. User name: octoplant Password: {password}

    Info

    You can have the password displayed as you enter it.

  13. Click on Log in.

  14. The server configuration is now complete and the client is started.

You can change the server configuration at any time when you open the Server dropdown menu in the Login dialog and select the Server configuration entry.

FAQ

Attempt to establish a connection to the server fail with an error message

Error message: The authenticity of the server xxx could not be verified. The transmitted certificate fingerprint is "00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00". Please contact the system administrator.

There are two possible causes for this:

  • The private key of the server archive has been deleted or changed. This may be because the server archive has been restored from a backup or because the path to a new server archive has already been used for another server archive.

  • The connection between client and server may be tampered with. If the private key of the server archive has not been deleted or changed, this error can also be caused by SSL connections being checked by a proxy or a firewall using man-in-the-middle techniques. However, it is also possible that a man-in-the-middle attack is taking place.

Necessary steps

Always check the network connection between the server and client for any indications of an attack.

Automating the login to the client applications
  1. Open the properties of the UserClient or AdminClient link with the right mouse button.
  2. In the Link > Target tab, add the following parameters: /account:{user}/domain:{domain}/password:{password}

Example

"D:\VD\vd\VDogClient.exe" /at:c "/rd:D:\vdClientArchive /account:YourUsername /domain:YourDomain /password:YourPassword"

Notes

  • Please note the security risks that arise here. Among other things, passwords are displayed in plain text.
  • The user must be logged into the User Management module of the AdminClient.
Login to a client fails with an error message

Error message:Error when calling a remote function [Function: CSC_OSAPI_SmartUpdate] [ID 30320], but when testing the connection, all ports are displayed with a green check mark.

The error message mentioned indicates network problems or a faulty firewall configuration. Please contact your network administrator for further information or assistance.