Home
Projects
Download
Support
Sponsors
Sponsor Benefits
Buy Gifts
Donate Now
Join Us
Open Cooperation
Contribute
Contributors (24)
Events (1)
Outsourcing
Contact Us
Outsourcing
Open Cooperation
Sponsor
Others
Recruitment
Ask Us
Chat With Us
About Us
Back to project ezyplatform

Recover EzyPlatform when an error occurs

Updated at 1694749813000
Some reasons for EzyPlatform errors and failure to start may include:
  1. Incorrect JDK version installation.
  2. Missing or invalid plugins installation.

How to identify the error

Usually, it's recommended to check the admin first because through the admin interface, you can start the web and socket components.

  1. Run the command: bash cli.sh "start <component_name>" ; tail -f logs/web-server.log. Replace <component_name> with admin, web, or socket. If there are no visible errors in the terminal but you still can't access the admin, proceed to step 2.
  2. Run the command: bash cli.sh "console <component_name>" and observe the thrown error.

Incorrect JDK version installation error

Please install JDK version 1.8.

Missing or invalid plugins installation error.

This error may cause the inability to restart the admin. You can follow these steps:

For example, you've just installed ezychat and encountered an error, you can use the following command: 

bash cli.sh "deactivate all ezychat"

Then try running the admin again with the command: bash cli.sh "console admin". If it runs without any errors, you can close it and run it again in the background mode. Install any missing plugins.

If the above method doesn't work, you can try the following steps:

1. Open the file $EZYPLATFORM_HOME/.runtime/admin/plugins.txt and remove the module you recently activated. For example, if the file has the following content: 

[{"name":"ezychat","active":false},{"name":"freestyle","active":false}]

And you recently activated ezychat, which caused the error, you can update the file to: 

[{"name":"freestyle","active":false}]

Then, try running the admin again using the command: bash cli.sh "console admin". If there are no errors, close it and run it again in the background. Install any missing plugins.

2. If the above step doesn't work, you can delete the entire plugins.txt file and run the admin again.

3. If the above steps still don't work, you can delete the $EZYPLATFORM_HOME/.runtime/admin directory and run it again.

4. If it still doesn't work, delete the $EZYPLATFORM_HOME/.runtime directory and run it again.

5. If all else fails, you may need to uninstall and reinstall EzyPlatform.