Setting the server connectivity

Set one or several server connections to be able to save, remove, generate, and publish a mapping to a Mapper Server, and to import a mapping from a Mapper Server.

  1. Select Windows > Preferences.
  2. Expand the view of Mapper and select Server Connectivity.
  3. Click New.
  4. Specify this information:
    Alias

    Specify a descriptive name for this connection.

    Host

    Specify the IP, or the host name, for the Mapper Server.

    The Mapper Server is part of the EC Server. For more details on EC server properties access the EC Management Page in Grid.

    Port

    Specify the Grid port for HTTP or HTTPS communication.

    You retrieve the port value from Grid Management > Configuration Manager > Default Router> HTTP value.

    Timeout

    Specify the timeout in milliseconds for the connection, for example 5000 ms.

    Context Root

    Specify the Context Root for the EC application. You find the Context Root in the Grid Management pages. The Context Root for the module MecMapGen and the Rest Service type must be used.

    By default the context root is ecmapgen.

    Security

    Select Secure Communication (HTTPS) or Unsecure Communication (HTTP).

    Secure communication (HTTPS) is recommended. HTTPS and HTTP use different ports, as set up in Grid.

    Authentication

    Select Windows User or Custom User.

    Your current Windows user is used, if Windows User is selected. The view shows your current domain and user name in the Username field. You cannot change either user name or password for this authentication. To be able to use Windows User authentication, you must enable in Grid the ntlm Authentication method.

    If Custom User is selected, you must specify a user name and a password. The Authentication method must be enabled in Grid to be able to use Basic User authentication. Do not use Custom User authentication over HTTP because it will send unencrypted user name and password to Grid.

    Username and Password

    If Custom User authentication is selected, specify the user name and password.

  5. Click OK to add the new connection to the Configured Server locations list.
  6. Optionally, select the new server and click Test Connection to verify the connection to the server.

    If the connection is successful, the view shows the Mapper Server version. Otherwise, an error message is displayed. Click OK to return to the Server Connectivity page.

  7. Optionally, select this server and click Make Default.
  8. Click Apply to save the connection settings.
  9. Click OK.

Default server connection preference

If the file mapper.properties exists in the home directory of Eclipse (eclipse.home.location, where eclipse.exe resides), and the server connection given in the file does not already exist, it is automatically added.

If the server connection given in the file already exists, confirm whether to update the database connection from the file. This will happen only once when the mapper is (re)started. You can also go to Window > Preferences > Mapper and click Refresh in the Default Configuration group. The user can then change or complement these preferences, if necessary.

When the file mapper.properties is changed, the same functionality is triggered the next time the mapper is (re)started. For a list of examples, see "Default Database Connection Preference" in Setting the Mapper database connectivity

Note: When using Web Service communication, the current Windows user is used for authentication as default. You can manually change this in the preferences UI.