Versions Compared

Old Version 17

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

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.
  1. Open a command prompt (or a shell in Linux) and go to the <EI_HOME>\wso2\analytics\bin directory.
  2. Execute one of the following:

    • On Linux/Mac OS:sh wso2server.sh

    • On Windows:wso2server.bat

  3. The operation log keeps running until the Analytics profile starts, which usually takes several seconds. Wait until the Analytics profile fully boots up and displays a message similar to "WSO2 Carbon started in n seconds."
Info

If you want to optimize the size of the distribution and run a selected profile, execute the following scripts:

  • On Linux/Mac OS: sh profile-creator.sh

  • On Windows: profile-creator.bat

However, this creates a distribution of the selected profile in the <EI_HOME> directory and deletes all the files that are not required to run the selected profile. Therefore, you may loose any changes you did to the other profiles.

Stopping a profile

To stop a profile, press Ctrl+C in the command window, or click the Shutdown/Restart link in the navigation pane in the Management Console. 

...