Skip to content

EasySOA v2.0 doc

Jump to bottom Edit New page
Marc Dutoo edited this page Nov 14, 2013 · 27 revisions

Summary

  1. Prerequisites
  2. Setup
  3. Installing it
  4. Browser configuration
  5. Running it
  6. Troubleshooting

Prerequisites

  • Java JDK 7 (download). Make sure the JAVA_HOME variable is set to your Java install directory.

Setup

Installing it

Get the EasySOA Registry 2.0 archive on the official website, then unzip it anywhere.

If you're a developer and want to use the Java source code Discovery Maven plugin, copy the contents of the easysoa-discovery-code-mavenplugin/m2_repo in your local Maven repository (usually below your home directory in .m2/repository ).

Note that EasySOA Registry comprises the core collaborative SOA - Business registry, with "collaborative documentation" and "portal" (indicators, matching, business monitoring, browsing) user interfaces for collaborative documentation. Its release also provides the Discovery by Browsing web proxy and user interface, the Discovery by Monitoring HTTP Proxy probe and its management user interface, and the Java source code Discovery plugin.

Other EasySOA 2.0 components are released independently and are available :

Browser configuration

You have to set a specific HTTP proxy for your browser if you want to use Discovery by Browsing in HTTP Proxy mode (but otherwise the Bookmarklet mode is still available). This proxy si the port 8081 of the machine where you've installed Discovery by Browsing, for instance if it's on your own computer : http://127.0.0.1:8081, like below (in which case you have to remove any proxy exception, such as localhost or 127.0.0.1).

Running it

  • Start EasySOA Registry by going in the nuxeo-cap-5.7.1-tomcat/bin directory and running Start Nuxeo.bat on Windows, ./nuxeoctl start on Linux . Its home (including "service portal" user interfaces) is at http://127.0.0.1:8080 . Its collaborative documentation user interface is at http://127.0.0.1:8080/nuxeo . Default user/password is Administrator/Administrator.
  • Start Discovery by Browsing (requires EasySOA Registry) by going in the easysoa-discovery-browsing directory and running start-web.bat on Windows, ./start-web.sh on Linux. Its user interface is at http://localhost:9080/easysoa-proxy-web http://127.0.0.1:8083 (it is also linked from the EasySOA Registry UI).
  • Start EasySOA Proxy (provides Runtime Discovery, which requires EasySOA Registry) by going in the apache-tomcat7-proxy/bin directory and running startup.bat on Windows, ./startup.sh on Linux. Its user interface is at http://localhost:9080/easysoa-proxy-web (it is also linked from the EasySOA Registry UI).

If you want to Reset all data, delete the nuxeo-cap-5.7.1-tomcat/nxserver/data folder once EasySOA Registry is stopped.

Troubleshooting

Here are the most frequent problems you can get while using EasySOA. If your problem is not here, feel free to create an issue.

Discovery by browsing

The browser doesn't seem to use the proxy

Check your browser configuration for proxy exclusions, ex. 'localhost, 127.0.0.1': you need to remove all of these.

If you are using the Chrome browser, you can also try to run : chromium-browser --proxy-server="127.0.0.1:8081" --proxy-bypass-list="". It will launch the browser with the right configuration.

Service registry

Nuxeo doesn't restart at the end of the wizard

Restart manually after setting in bin/nuxeo.conf the property: nuxeo.wizard.done=true

EasySOA Light

When using a service, I get an "Error code 0"

Something has not been properly launched, probably because a server wasn't ready yet before to start the next one (your computer was slower than expected!). Take a look at the log files to see which server failed, and launch it manually (each server has a start-xxx.sh and .bat script).

Add a custom footer
Add a custom sidebar
Clone this wiki locally