Skip to content

Configuration & Troubleshooting

Matthew Gallina edited this page Feb 20, 2019 · 10 revisions

Log Files

sMockin's log files can be found here within your user home directory: .smockin/log/smockin.log

If you continue to identify any issues within this file then please drop an email to [email protected]


Start Up Modes

To help development and debugging potential issues, sMockin can be started up using a number of different modes:

  • DEBUG Allows remote debugging from port 8008.
  • INMEM Uses an in-memory DB instead of the main DB.
  • RESET_SYS_ADMIN Resets the System Admin user's password back to factory default.
  • CONSOLE Runs sMockin in console view with DEBUG level logging.

Examples:

  • To run sMockin using console mode:

    • ./start.sh -CONSOLE
  • To run sMockin in debug mode:

    • ./start.sh -DEBUG

(Please note these modes are only available to MAC and Linux users at present)


Known Startup Issues

A common issue that prevents sMockin from starting up, is where there is a conflict of ports caused by other applications already having bound to these on your system.

By default sMockin launches a H2 database instance off of port 9095 and then binds to port 8000 itself.

If these ports are already in use, then you can change them by editing the .smockin/app.properties under your user home directory and amending the following two properties:

  • H2_PORT = 9095
  • APP_PORT = 8000

Once done you will need to restart sMockin to put this into effect.