Troubleshooting

How do I find my Weave Server Assistant folder?

  • Windows
    • Open a run prompt by holding down the Windows Key + R
    • Type in the text prompt: %APPDATA%
    • Hit Enter
    • Find the folder named .weave
  • Mac OS X
    • Open a terminal window and input the following:
    • cd ~/Library/Application\ Support/.weave/
  • Linux
    • Open a terminal window and input the following:
    • cd ~/.weave/

Weave Server Assistant won't open after updating

  • Check to make sure you have installed all system requirements
  • Run the Weave Server Assistant under an account with Administrative privileges
  • Check the log files for startup errors found in /.weave/logs/ (instructions above)

I cannot select the webapps folder for my Tomcat installation

  • Make sure there is a ROOT folder inside of the webapps folder to store all Weave files

I receive a Server Not Found error when opening the AdminConsole / session state

This is caused by a communication issue between the client and server.

  • If you are using Tomcat:
    • Make sure your Tomcat installation is running
    • Restart the Tomcat service to see if the problem persists
    • Make sure that the port defined in the Weave Server Assistant matches the port the Tomcat service is running on
  • If you are using Jetty:
    • Restart the Weave Server Assistant
    • If the problem still persists, open the .weave folder (instructions above)
    • Navigate to /plugins/Jetty/logs/
    • Find the most recently modified stdout and stderr files.
    • Include these in a bug report describing the issue.

I receive a 404 Not Found error when opening the AdminConsole / session state

This is caused by the client requesting content the server does not have.
If you are receiving this error after downloading and installing Weave, you may not have write permissions to the directory.
Please make sure you are running on a system account with administrator privileges.

  • If you are using Tomcat:
    • Make sure you have selected the correct webapps folder in the Weave Server Assistant for your Tomcat installation
    • Navigate to your Tomcat's webapps folder using your system's file browser
    • Check to see if these files exist
      • WeaveServices.war
      • /ROOT/AdminConsole.html
      • /ROOT/weave.html
    • Redeploy the Weave install files by using the Weave Server Assistant
    • If the problem persists, check the most recent log files under .weave/logs/
  • If you are using Jetty:
    • Navigate to Jetty's webapps folder found in .weave/plugins/Jetty/webapps/
    • Check to see if these files exist
      • WeaveServices.war
      • /ROOT/AdminConsole.html
      • /ROOT/weave.html
    • Redeploy the Weave install files by using the Weave Server Assistant
    • If the problem persists, check the most recent log files under .weave/logs/