Niels Lindenthal
8 years ago
parent
f16d51412d
commit
100c330a02
@ -1,12 +0,0 @@ |
||||
# Packaged installation Backup Guide |
||||
|
||||
The detailed backup instructions for our packages [can be found here](./packaged/README.md). |
||||
|
||||
|
||||
# Manual installation |
||||
|
||||
The backup guide for your manual installation [can be found here](./manual/README.md). |
||||
|
||||
# Docker installation |
||||
|
||||
The backup guide for your Docker-based installation [can be found here](./docker/README.md). |
||||
@ -1,130 +0,0 @@ |
||||
# Incoming Emails |
||||
|
||||
OpenProject is able to receive emails and create and update work packages and reply in forums depending on the content of the email. |
||||
|
||||
## Setup |
||||
|
||||
Receiving emails is done via a rake task that fetches emails from an email server, parses them and performs actions depending on the content of the email. This rake task can be executed manually or automatically, e.g. with the help of a Cron job. |
||||
|
||||
### IMAP |
||||
|
||||
The rake task `redmine:email:receive_imap` fetches emails via IMAP and parses them. |
||||
Example: |
||||
|
||||
```bash |
||||
bundle exec rake redmine:email:receive_imap host='imap.gmail.com' username='test_user' password='password' port=993 ssl=true allow_override=type,project project=test_project |
||||
``` |
||||
|
||||
Available arguments for this rake task that specify the email behavior are |
||||
|
||||
|key | description| |
||||
|----|------------| |
||||
| `host` | address of the email server | |
||||
| `username` | the name of the user that is used to connect to the email server| |
||||
| `password` | the password of the user| |
||||
| `port` | the port that is used to connect to the email server| |
||||
| `ssl` | specifies if SSL should be used when connecting to the email server| |
||||
| `folder` | the folder to fetch emails from (default: INBOX)| |
||||
| `move_on_success` | the folder emails that were successfully parsed are moved to (instead of deleted)| |
||||
| `move_on_failure` | the folder emails that were ignored are moved to| |
||||
|
||||
Available arguments that change how the work packages are handled: |
||||
|
||||
| key | description | |
||||
|---|---| |
||||
| `project` | identifier of the target project | |
||||
| `tracker` | name of the target tracker | |
||||
| `category` | name of the target category | |
||||
| `priority` | name of the target priority | |
||||
| `allow_override` | specifies which attributes may be overwritten though specified by previous options. Comma separated list | |
||||
|
||||
|
||||
### POP3 |
||||
|
||||
The rake task `redmine:email:receive_pop3` fetches emails via IMAP and parses them. |
||||
Example: |
||||
```bash |
||||
bundle exec rake redmine:email:receive_pop3 host='pop.gmail.com' username='test_user' password='password' port=995 allow_override=priority |
||||
``` |
||||
|
||||
Available options that specifiy the email behavior are: |
||||
|
||||
|key | description| |
||||
|----|------------| |
||||
|`host` | address of the email server (default: 127.0.0.1)| |
||||
| username | name of the user that is used to connect to the email server| |
||||
| password | password of the user| |
||||
| port| POP3 server port (default: 110)| |
||||
| apop | use APOP authentication (default: false)| |
||||
| delete_unprocessed | delete messages that were ignored (default: leave them on the server)| |
||||
|
||||
Available arguments that change how the work packages are handled: |
||||
|
||||
|key | description| |
||||
|----|------------| |
||||
| `project` | identifier of the target project| |
||||
| `tracker` | name of the target tracker| |
||||
| `category` | name of the target category| |
||||
| `priority` | name of the target priority| |
||||
| `allow_override` | specifies which attributes may be overwritten though specified by previous options. Comma separated list| |
||||
|
||||
If you set a default value it will be used when creating a work package. |
||||
|
||||
But then no other value is possible (even when you update the work package) unless you specify this with the use of `allow_override`. Some attributes (like `type, status, priority`) are only changeable if you specify this via `allow_override`. But notice: Some attributes have to specified in another format here, e.g. Assignee can be allowed to be overriden with `allow_override=assigned_to`. |
||||
|
||||
|
||||
## Format of the Emails |
||||
|
||||
### Work Packages |
||||
|
||||
#### Sending user address |
||||
|
||||
The address the mail is sent from must match an existing account in order to map the user action. |
||||
If a matching account is found, the mail handler impersonates the user to create the ticket. |
||||
|
||||
If no matching account is found, the mail is rejected. To override this behavior and allow unknown mail address |
||||
to create work packages, set the option `no_permission_check=1`. |
||||
|
||||
**Note**: This feature only provides a mapping of mail to user account, it does not authenticate the user based on the mail. |
||||
Since you can easily spoof mail addresses, you should not rely on the authenticity of work packages created that way. |
||||
|
||||
#### Attributes |
||||
|
||||
The Attributes you can use in your email are the same whether you create or update a work package. |
||||
|
||||
Only the `project` attribute is a bit special: |
||||
|
||||
You must either add `project` to the set of allowed overridden attributes with `allow_override=project,..` in order to use it in a mail, |
||||
OR set it as fixed variable with `project=identifier`. |
||||
|
||||
The subject of the work package that shall be created is derived from the subject of the email. The body of the email gets parsed and all lines that contain recognized keys are removed. What is left will become the description. |
||||
|
||||
Other available keys for the email are: |
||||
|
||||
|Key|Description|Example| |
||||
|---|---|---| |
||||
| Project | sets the project. Use the project identifier | Project:test\_project | |
||||
| Assignee | sets the assignee. Use the email or login of the user | Assignee:test.nutzer@example.org | |
||||
| Type | sets the type | type:Milestone | |
||||
| Version | sets the version | version:v4.1.0 | |
||||
| Start date | sets the start date | start date:2015-02-28 | |
||||
| Due date | sets the due date | | |
||||
| Done ratio | sets the done ratio. Use a number | Done ratio:40 | |
||||
| Status | sets the status | Status:closed | |
||||
| priority | sets the priority | priority:High | |
||||
|
||||
If you want to set a custom field just use the name as it is displayed in your browser, e.g. `Custom field:new value` |
||||
|
||||
**Notice: The keys are not case-sensitive but the values you want to set are.** |
||||
|
||||
#### Attachments |
||||
|
||||
If you create or update a work package via email the attachments of the email will be attached to the relevant work package. |
||||
|
||||
#### Watchers |
||||
|
||||
If you create a work package via email and sent it to another email (to or bcc) OpenProject will search for a user with this email and add it as watcher. |
||||
|
||||
### Truncate Emails |
||||
|
||||
In the administator's setting you can specify lines after which an email will not be parsed anymore. That is useful if you want to reply to an email automatically sent to you from OpenProject. E.g. you could set it to `--Truncate here--` and insert this line into your email below the updates you want to perform. |
||||
@ -1,52 +0,0 @@ |
||||
# System Requirements |
||||
|
||||
__Note__: The configurations described below are what we use and test against. |
||||
This means that other configurations might also work but we do not |
||||
provide any official support for them. |
||||
|
||||
## Server |
||||
|
||||
### Hardware |
||||
|
||||
* __Memory:__ 512 MB (1024 recommended) |
||||
* __Free disc space:__ 300 MB (4096 recommended) |
||||
|
||||
### Operating System |
||||
|
||||
| Distribution (64 bits only) | Identifier | init system | |
||||
| :------------------------------ | :----------- | :---------- | |
||||
| CentOS/RHEL 7.x | centos-7 | systemd | |
||||
| Debian 7 Wheezy | debian-7 | sysvinit | |
||||
| Debian 8 Jessie | debian-8 | systemd | |
||||
| Suse Linux Enterprise Server 11 | sles-11 | sysvinit | |
||||
| Suse Linux Enterprise Server 12 | sles-12 | sysvinit | |
||||
| Ubuntu 14.04 Trusty Tahr | ubuntu-14.04 | upstart | |
||||
| Ubuntu 16.04 Xenial Xerus | ubuntu-16.04 | upstart | |
||||
|
||||
|
||||
### Dependencies |
||||
|
||||
* __Runtime:__ [Ruby](https://www.ruby-lang.org/en/) Version >= 2.2.5, < 2.4.0 |
||||
* __Webserver:__ [Apache](http://httpd.apache.org/) |
||||
or [nginx](http://nginx.org/en/docs/) |
||||
* __Application server:__ [Phusion Passenger](https://www.phusionpassenger.com/) |
||||
or [Unicorn](http://unicorn.bogomips.org/) |
||||
* __Database:__ [MySQL](https://www.mysql.com/) Version >= 5.6 |
||||
or [PostgreSQL](http://www.postgresql.org/) Version >= 9.1 |
||||
|
||||
Please be aware that the dependencies listed above also have a lot of |
||||
dependencies themselves. |
||||
|
||||
## Client |
||||
|
||||
OpenProject supports the latest versions of the major browsers. In our |
||||
strive to make OpenProject easy and fun to use we had to drop support |
||||
for some older browsers. |
||||
|
||||
* [Mozilla Firefox](https://www.mozilla.org/en-US/firefox/products/) (Version >= 45 ESR) |
||||
* [Microsoft Egde](https://www.microsoft.com/de-de/windows/microsoft-edge) |
||||
* [Google Chrome](https://www.google.com/chrome/browser/desktop/) |
||||
|
||||
## Screen reader support (accessibility) |
||||
|
||||
* [JAWS](http://www.freedomscientific.com/Products/Blindness/JAWS) >= 17.0 |
||||
Loading…
Reference in new issue