kopia lustrzana https://github.com/OpenDroneMap/WebODM
Fixed README conflict
commit
3c79673d02
57
README.md
57
README.md
|
@ -14,6 +14,7 @@ A free, user-friendly, extendable application and [API](http://docs.webodm.org)
|
|||
* [Enable SSL](#enable-ssl)
|
||||
* [Where Are My Files Stored?](#where-are-my-files-stored)
|
||||
* [Common Troubleshooting](#common-troubleshooting)
|
||||
* [Backup and Restore](#backup-and-restore)
|
||||
* [API Docs](#api-docs)
|
||||
* [OpenDroneMap, node-OpenDroneMap, WebODM... what?](#opendronemap-node-opendronemap-webodm-what)
|
||||
* [Roadmap](#roadmap)
|
||||
|
@ -126,7 +127,7 @@ While starting WebODM you get: `'WaitNamedPipe','The system cannot find the file
|
|||
While Accessing the WebODM interface you get: `OperationalError at / could not translate host name “db” to address: Name or service not known` or `ProgrammingError at / relation “auth_user” does not exist` | Try restarting your computer, then type: `./webodm.sh restart`
|
||||
Task output or console shows one of the following:<ul><li>`MemoryError`</li><li>`Killed`</li></ul> | Make sure that your Docker environment has enough RAM allocated: [MacOS Instructions](http://stackoverflow.com/a/39720010), [Windows Instructions](https://docs.docker.com/docker-for-windows/#advanced)
|
||||
After an update, you get: `django.contrib.auth.models.DoesNotExist: Permission matching query does not exist.` | Try to remove your WebODM folder and start from a fresh git clone
|
||||
Task fails with `Process exited with code null`, no task console output | If the computer running node-opendronemap is using an old or 32bit CPU, you need to compile [OpenDroneMap](https://github.com/OpenDroneMap/OpenDroneMap) from sources and setup node-opendronemap natively. You cannot use docker. Docker images work with CPUs with 64-bit extensions, MMX, SSE, SSE2, SSE3 and SSSE3 instruction set support or higher.
|
||||
Task fails with `Process exited with code null`, no task console output - OR - console output shows `Illegal Instruction` | If the computer running node-opendronemap is using an old or 32bit CPU, you need to compile [OpenDroneMap](https://github.com/OpenDroneMap/OpenDroneMap) from sources and setup node-opendronemap natively. You cannot use docker. Docker images work with CPUs with 64-bit extensions, MMX, SSE, SSE2, SSE3 and SSSE3 instruction set support or higher.
|
||||
On Windows, docker-compose fails with `Failed to execute the script docker-compose` | Make sure you have enabled VT-x virtualization in the BIOS
|
||||
Cannot access WebODM using Microsoft Edge on Windows 10 | Try to tweak your internet properties according to [these instructions](http://www.hanselman.com/blog/FixedMicrosoftEdgeCantSeeOrOpenVirtualBoxhostedLocalWebSites.aspx)
|
||||
Getting a `No space left on device` error, but hard drive has enough space left | Docker on Windows by default will allocate only 20GB of space to the default docker-machine. You need to increase that amount. See [this link](http://support.divio.com/local-development/docker/managing-disk-space-in-your-docker-vm) and [this link](https://www.howtogeek.com/124622/how-to-enlarge-a-virtual-machines-disk-in-virtualbox-or-vmware/)
|
||||
|
@ -134,6 +135,28 @@ Cannot start WebODM via `./webodm.sh start`, error messages are different at eac
|
|||
|
||||
Have you had other issues? Please [report them](https://github.com/OpenDroneMap/WebODM/issues/new) so that we can include them in this document.
|
||||
|
||||
### Backup and Restore
|
||||
|
||||
If you want to move WebODM to another system, you just need to transfer the docker volumes (unless you are storing your files on the file system).
|
||||
|
||||
On the old system:
|
||||
|
||||
```bash
|
||||
mkdir -v backup
|
||||
docker run --rm --volume webodm_dbdata:/temp --volume `pwd`/backup:/backup ubuntu tar cvf /backup/dbdata.tar /temp
|
||||
docker run --rm --volume webodm_appmedia:/temp --volume `pwd`/backup:/backup ubuntu tar cvf /backup/appmedia.tar /temp
|
||||
```
|
||||
|
||||
Your backup files will be stored in the newly created `backup` directory. Transfer the `backup` directory to the new system, then on the new system:
|
||||
|
||||
```bash
|
||||
ls backup # --> appmedia.tar dbdata.tar
|
||||
./webodm.sh start && ./webodm.sh down # Create volumes
|
||||
docker run --rm --volume webodm_dbdata:/temp --volume `pwd`/backup:/backup ubuntu bash -c "rm -fr /temp/* && tar xvf /backup/dbdata.tar"
|
||||
docker run --rm --volume webodm_appmedia:/temp --volume `pwd`/backup:/backup ubuntu bash -c "rm -fr /temp/* && tar xvf /backup/appmedia.tar"
|
||||
./webodm.sh start
|
||||
```
|
||||
|
||||
## API Docs
|
||||
|
||||
See the [API documentation page](http://docs.webodm.org).
|
||||
|
@ -199,11 +222,23 @@ There are many ways to contribute back to the project:
|
|||
- ⭐️ us on GitHub.
|
||||
- Spread the word about WebODM and OpenDroneMap on social media.
|
||||
- While we don't accept donations, you can purchase an [installer](https://webodm.org/download#installer) or a [premium support package](https://webodm.org/services#premium-support).
|
||||
- Become a contributor (see below).
|
||||
- Become a contributor (see below to get free swag 🤘)
|
||||
|
||||
## Become a Contributor
|
||||
|
||||
If you know Python, web technologies (JS, HTML, CSS, etc.) or both, it's easy to make a change to WebODM! Make a fork, clone the repository and run `./devenv.sh start`. That's it! See the [Development Quickstart](http://docs.webodm.org/#development-quickstart) and [Contributing](/CONTRIBUTING.md) documents for more information. All ideas are considered and people of all skill levels are welcome to contribute.
|
||||
The easiest way to get started is to take a look at our list of [outstanding issues](https://github.com/OpenDroneMap/WebODM/labels/help%20wanted) and pick one. You can also fix/improve something entirely new based on your experience with WebODM. All ideas are considered and people of all skill levels are welcome to contribute.
|
||||
|
||||
You don't necessarily need to be a developer to become a contributor. We can use your help to write better documentation and improve the user interface texts and visuals.
|
||||
|
||||
If you know how to code, we primarily use Python (Django), Javascript (React), HTML and SCSS. See the [Development Quickstart](http://docs.webodm.org/#development-quickstart) and [Contributing](/CONTRIBUTING.md) documents for more information.
|
||||
|
||||
To make a contribution, you will need to open a pull request ([here's how](https://github.com/Roshanjossey/first-contributions#fork-this-repository)). To make changes to WebODM, make a clone of the repository and run `./devenv.sh start`.
|
||||
|
||||
If you have questions visit us on the [forum](http://community.opendronemap.org/c/webodm) and we'll be happy to help you out with your first contribution.
|
||||
|
||||
When your first pull request is accepted, don't forget to fill [this form](https://goo.gl/forms/PZkiPPeNKUHNz0qe2) to get your **free** WebODM T-Shirt 🤘
|
||||
|
||||
<img src="https://user-images.githubusercontent.com/1951843/36511023-344f86b2-1733-11e8-8cae-236645db407b.png" alt="T-Shirt" width="50%">
|
||||
|
||||
## Architecture Overview
|
||||
|
||||
|
@ -229,23 +264,21 @@ The following pre-requisites are required:
|
|||
* Requires docker installed via system (ubuntu: `sudo apt-get install docker.io`)
|
||||
* Requires screen to be installed
|
||||
* Requires odm user member of docker group
|
||||
* Required WebODM directory checked out to /opt/WebODM
|
||||
* Requires that /opt/WebODM is recursively owned by odm:odm
|
||||
* Required WebODM directory checked out to /webodm
|
||||
* Requires that /webodm is recursively owned by odm:odm
|
||||
* Requires that a Python 3 environment is used at /webodm/python3-venv
|
||||
|
||||
If all pre-requisites have been met, and repository is checked out to /opt/WebODM folder, then you can use the following steps to enable and manage the service:
|
||||
|
||||
First, to install the service, and enable the service to run at startup from now on:
|
||||
First, to install the service, and enable the services to run at startup from now on:
|
||||
```bash
|
||||
sudo systemctl enable /opt/WebODM/service/webodm-gunicorn.service
|
||||
sudo systemctl enable /webodm/service/webodm-gunicorn.service
|
||||
sudo systemctl enable /webodm/service/webodm-nginx.service
|
||||
```
|
||||
|
||||
To manually stop the service:
|
||||
To manually start/stop the service:
|
||||
```bash
|
||||
sudo systemctl stop webodm-gunicorn
|
||||
```
|
||||
|
||||
To manually start the service:
|
||||
```bash
|
||||
sudo systemctl start webodm-gunicorn
|
||||
```
|
||||
|
||||
|
|
Ładowanie…
Reference in New Issue