Troubleshooting and Server Logs for WebShare Enterprise
Troubleshooting
If you face a problem during the installation, check below for a known solution or workaround:
- After running
sudo apt-get installfaro-webshare
The error message is immediately shown stating the docker.io or docker-ce dependency is missing.- Solution: Either run
sudo apt-get updateif the server has internet connection or install the dependency manually offline. Then repeatsudo apt-get install faro-webshare
- Solution: Either run
- After running
sudo apt-get install...
The installation progresses but fails at the end (e.g., during database upgrade or initialization).- Solution: First, make sure that WebShare is entirely stopped:
sudo faro-webshare stop. Then proceed with one of the following options:
- Solution #1: (keeping the existing data): Run
sudo apt-get remove faro-webshareand then proceed with the installation again.
- Solution #2: factory reset (erasing existing data!): Run
sudo faro-webshare purge
This deletes all WebShare data and configuration, without deleting the program itself. Then proceed with the configuration, see Server Configuration UI below.
- Solution #3: reinstall (erasing existing data!): Run
sudo apt-get purge faro-webshare
Then proceed with the usual installation procedure usingsudo apt-get installThis solution is a bit slower compared to the factory reset.
- Solution #1: (keeping the existing data): Run
- Solution: First, make sure that WebShare is entirely stopped:
- When trying to access WebShare the browser displays an error message such as "Your connection is not private", "Potential Security Risk Ahead", or "This site is not secure".
- Solution: This is because you neither specified your own valid certificate nor used the Let’s Encrypt option. For production, set your certificates correctly. For testing you can continue on to the site by clicking:
- Advanced > Proceed to localhost (Chrome)
- Advanced > Accept the risk and continue (Firefox)
- Details > Go on to the webpage (MS Edge)
- Solution: This is because you neither specified your own valid certificate nor used the Let’s Encrypt option. For production, set your certificates correctly. For testing you can continue on to the site by clicking:
Server Logs
This page is only accessible to users with the Domain Administrator role. To access the server logs:
- From the Administration menu go to Server Administration > Server Logs.
- Choose a time range, select one or multiple containers, and view the corresponding logs.
Unhandled Errors
Allows to view unexpected errors that occurred in the WebShare backend server or processing workers. Also allows to flag errors as handled if they’re no longer relevant.
