Configuration file

From Connector for Web Services 10.5.1 a new-style configuration file is used.

The format of this file is identical to the format that is used for the configuration of LN UI. Connector for Web Services can inherit several settings from LN UI: you can use the "environment" settings of LN UI for the "ERP Server" settings of Connector for Web Services.

The configuration file is modified when applying changes to the configuration pages of Connector for Web Services. In a multi-tenant cloud installation, you typically use a text editor to change the configuration file.

The configuration file is called c4wsProperties.xml and is located in the folder specified by the configLocation parameter of the web application. For a default installation, the file is located at c:\Infor\ese\c4ws\config\c4wsProperties.xml.

Example contents: 

<?xml version="1.0" encoding="utf-8"?>	
<c4ws>
  <general>
    <cloudEnabled>true</cloudEnabled>
    <lnuiConfigFile>../../lnui/config/webuiProperties.xml</lnuiConfigFile>
  </general>

  <!-- overrides/additions to LN UI settings -->
  <environments>
    <environment name="infor">
      <!-- (settings like "host", "port", "bshell", "bse" are inherited
            from the LN UI settings)
      -->
      <keepalive>60</keepalive>
    </environment>
  </environments>

  <!-- C4WS settings, not present in LN UI -->
  <cloud>
    <environmentID>infor</environmentID>
    <consumerkey>c4wsclient</consumerkey>
    <consumersecret cleartext="true">T0p$3cr3t</consumersecret>
  </cloud>

 </c4ws>

Available settings

This table shows settings that are inherited from webuiProperties.xml:

Path (relative to "c4ws" root node) Description
general/cloudEnabled If "true", this is a, multi-tenant, cloud installation.
environments Contains one or more LN UI environments.
environments/environment Contains the settings for an LN UI environment.
environments/environment/@name Name (ID) of the environment.
environments/environment/host Hostname of LN server.
environments/environment/port Port number to connect to, such as 512 for "rexec".
environments/environment/activation Activation type: "rexec", "baanlogin", "baanlogin_ssl".
environments/environment/bse BSE directory.
environments/environment/bshell Bshell name.
environments/environment/command Command line parameters for bshell.
environments/environment/username User name to be used for Connector for Web Services admin tasks, that is, deploying BDEs.

This user name is also used for Keystore management in LN UI.

environments/environment/password Encrypted password for user.

This table shows settings for Connector for Web Services:

Path (relative to "c4ws" root node) Description
general/lnuiConfigFile Path to webuiProperties.xml to be included.
cloud/environmentID ID of the environment to be used in the multi-tenant cloud installation. This ID must match some "environments/environment/@name".
cloud/consumerkey The consumer key to be used for OAuth1.0a authentication.
cloud/consumersecret The consumer secret, that is, password, for OAuth1.0a authentication. Usually stored in encrypted format.
cloud/consumersecret/@cleartext If "true", the consumer secret is stored in cleartext format. Only used when manually editing the file.
cloud/keystore Path to keystore/truststore for baanlogin_ssl connections.
cloud/keystorepassword Password for keystore/truststore for baanlogin_ssl connections. Usually stored in encrypted format.
cloud/keystorepassword/@cleartext If "true" the password is stored in cleartext format. Only used when manually editing the file.
environments/environment/company Company number.
environments/environment/keepalive Keep-alive timeout for connection pooling.
environments/environment/maxconnections Maximum number of connections.
environments/environment/maxreferences Maximum number of references for shared connections.
environments/environment/maxthreads Maximum number of waiting threads.
environments/environment/anonymous If "true", anonymous requests, that are using the admin account, are allowed
environments/environment/trace If "true", server tracing is active.

$BSE/log/trace.jca.xxxx

backends Contains one or more LN server specifications for on-premises/single-tenant mode.
backends/backend/@name Server name, that is, "connectionpoint", as used in request URL.
backends/backend/@ref Reference to LN UI environment. This reference must match some "environments/environment/@name".