nativeInstallerexo-platform-community

Enable development or debug mode

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

Development or debug modes are disabled by default in the Bitnami Stack for eXo Platform because of their performance impact. Enabling these modes will help you debug eXo Platform in case of problems.

Development mode

Linux and Mac OS X

Follow these steps:

  • Open the installdir/apps/exoplatform/scripts/setenv-customize.sh file in a text editor. Uncomment the lines below so they look like this:

      EXO_DEV=true
  EXO_JCR_SESSION_TRACKING=true
  EXO_TOMCAT_UNPACK_WARS=true

  • Restart Tomcat in order for these changes to take effect, either using the manager or manually:

      $ sudo installdir/ctlscript.sh restart tomcat

Windows

Follow these steps:

  • Open the installdir/apps/exoplatform/scripts/setenv-customize.bat file in a text editor. Uncomment the lines below so they look like this:

      SET EXO_DEV=true
  SET EXO_JCR_SESSION_TRACKING=true
  SET EXO_TOMCAT_UNPACK_WARS=%EXO_DEV%

  • Reinstall the service by running the following commands from an elevated command prompt:

      installdir/serviceinstall.bat REMOVE
  installdir/serviceinstall.bat INSTALL
  installdir/servicerun.bat START

  • Restart Tomcat in order for these changes to take effect using the manager.

Debug mode

Linux and Mac OS X

Follow these steps:

  • Open the installdir/apps/exoplatform/scripts/setenv-customize.sh file in a text editor. Uncomment the lines below so they look like this:

      EXO_DEBUG=true
  EXO_DEBUG_PORT="8000"

  • Restart Tomcat in order for these changes to take effect, either using the manager or manually:

      $ sudo installdir/ctlscript.sh restart tomcat

Windows

Follow these steps:

  • Open the installdir/apps/exoplatform/scripts/setenv-customize.bat file in a text editor. Uncomment the lines below so they look like this:

      SET EXO_DEBUG=true
  SET EXO_DEBUG_PORT=8000

  • Reinstall the service by executing these commands from the Windows command prompt:

      installdir/serviceinstall.bat REMOVE
  installdir/serviceinstall.bat INSTALL
  installdir/servicerun.bat START

  • Restart Tomcat in order for these changes to take effect using the manager.

You can find more information about these modes in the documentation for Debug mode and Development mode.

Last modification September 5, 2018