Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The following sections describe how to run WSO2 Enterprise Integrator (WSO2 EI).

...

Starting the Integration profile

Info
  • If you are using IBM JDK 1.8, change the value of the org.owasp.csrfguard.PRNG.Provider property to 'IBMJCE' in the <EI_HOME>/conf/security/Owasp.CsrfGuard.Carbon.properties file.
  • The data integration functionalities of WSO2 EI comes with the ESB profile. Therefore, you need to start the ESB profile to use them.
  1. Open a command prompt (or a shell in Linux) and go to the <EI_HOME>\bin directory.
  2. Execute one of the following commands:
    • To start the Integration profile in a typical environment:
      • On Windows:integrator.bat --run
      • On Linux/Mac OS:sh integrator.sh

    • To start the Integration profile in the background mode of Linux: sh integrator.sh start
      To stop the Integration profile running in this mode: sh integrator.sh stop

    • To provide access to the production environment without allowing any user group (including admin) to log in to the Management Console:

      • On Windows: integrator.bat --run -DworkerNode
      • On Linux/Mac OS: sh integrator.sh -DworkerNode
    • To check for additional options you can use with the startup commands, type -help after the command, such as: 
      sh integrator.sh -help.
  3. The operation log keeps running until the Integration profile starts, which usually takes several seconds. Wait until the Integration profile fully boots up and displays a message similar to "WSO2 Carbon started in n seconds."

...

Info
  • When starting the analytics profile, you may intermittently get a BindException error (i.e., Cannot assign requested address: Service 'sparkDriver' failed after 16 retries!) if the Apache Spark client does not start properly (due to an issue in socket binding on computers with multiple IP interfaces). Add the same hostname that you specify in the /etc/hosts file of your system as the value of the <HostName> element in the <EI_HOME>/wso2/analytics/conf/carbon.xml file to rectify this.
  • If you are using IBM JDK 1.8, change the value of the org.owasp.csrfguard.PRNG.Provider property to 'IBMJCE' in the <EI_HOME>wso2/analytics/conf/security/Owasp.CsrfGuard.Carbon.properties file.
  • If you get the Caused by: java.lang.IllegalArgumentException: java.lang.NoClassDefFoundError: Could not initialize class org.xerial.snappy.Snappy exception when starting WSO2 EI Analytics in certain environments such as Windows or Red Hat linux, download the snappy-java_1.1.1.7.jar file and add it to the <EI_HOME>/lib directory.

...