Adding a connection

  1. In the configuration console, select the top-level node, Infor LN Transfer Service, in the tree to open the console's main view.
  2. Click Add Connection.
  3. Specify the name for the connection and click OK.
    The connection is displayed in the tree.
  4. Select the connection node in the tree to open the Connection view.
  5. Specify the connection settings.
    1. Specify this information:
      Enabled
      If this check box is selected, the connection is processed by the service.
      If this check box is cleared, the LN Transfer Service does not handle printers, file shares, download folders, or upload folders for the connection.

      Even printers, file shares, download folders, or upload folders, for which the Enabled check box in the Printer view is selected, are not handled.

      Authentication Type
      The authentication type to be used when connecting to the LN UI server:
      • Select Basic if the user authentication is performed by the LN server. This is the case for on-premises or single-tenant cloud installations of LN that do not use ION API.
      • Select OAuth2 if the user authentication is performed by ION API. This is the case for all multi-tenant cloud installations of LN, and for some on-premises or single-tenant cloud installations that use the ION API gateway.

      Depending on this choice, some of the next parameters are not available.

    2. If you selected the Basic authentication type, specify this information:
      Base URL
      The base URL for the LN UI server that connects to the LN server.

      For example:

      http://server.example.com:8312/webui

      https://server.example.com:8443/webui

      Environment
      The environment name that identifies the LN server, as defined on the LN UI server.

      You can use environments that use the "BaanLogin" or "Rexec" protocol.

      If the LN UI server has been configured for Single Sign On using Infor Federation Services, you can also use environments with the "BaanLogin SSL" protocol.

      For details about the configuration of LN UI, see the Infor LN UI Administration Guide and the online help for the LN UI Administration Webapp.

      Command
      Optional command line arguments for starting the BShell on the LN server.
      Username
      Username used for logon to the LN server.
      Password
      Password used for logon to the LN server.
    3. If you selected the OAuth2 authentication type, specify this information:
      ION-API File
      The .ionapi file containing the OAuth2-related settings.
      You can download such a file when you add Infor LN Transfer Service as a client application to the ION-API application in Infor Ming.le or to the API Gateway in Infor OS Portal.
      See Adding an authorized app for the Infor LN Transfer Service and Downloading the credentials of an authorized app.
      Click Browse to select the .ionapi file. You can use the Tenant ID and URL fields to verify that the correct file was chosen.
      Environment
      This property is only applicable for on-premises installations and single-tenant cloud installations.
      Specify the environment name that identifies the LN server, as defined on the LN UI server.

      Only use environments that use the "BaanLogin SSL" protocol.

      Tenant ID
      (Read-only) value of the "tenant ID" that is specified in the selected ION-API file.
      URL
      (Read-only) value of the "ION-API URL" that is specified in the selected ION-API file.
    4. Specify this information:
      Polling Interval
      If no more print items are available, the LN server is contacted again after waiting for the specified number of seconds.
      • The default value is 60 seconds.
      • For production environments, the minimum value is 5 seconds. For non-production environments, the minimum value is 30 seconds.
      • A low value can negatively impact the performance of LN.
      Keep Connection Open
      If this check box is selected, the connection to the LN server is not closed during the polling interval. Select this check box for short polling intervals, to prevent the overhead of closing and reopening connections.
      If this check box is cleared, the connection to the LN server is closed when the polling interval starts. The connection is reopened when the polling interval has ended. Clear this check box for polling intervals of several minutes, to prevent idle connections.
      By default, this check box is selected for polling intervals of less than 5 minutes.
      Handle all Printers
      If this check box is selected, these printers are handled by the LN Transfer Service: all available printers defined on the LN server, except those that have been configured in the LN Transfer Service and are not enabled.
      If this check box is cleared, only the printers that have been explicitly configured in the LN Transfer Service are handled. Any additional printers that are defined on the LN server are not handled.
      See Enabling a printer or file share.
  6. Click Save.
After saving the connection, a new child node is present in the tree. When you select the node, a "Connection view" is displayed.