|
|
| (31 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| {{Work_in_progress}}
| | #REDIRECT [[Integration/Chat]] |
| {{Note|Report issues and suggestions to the Vines server at https://github.com/diaspora/vines/issues}}
| | {{Serious|This page moved to [[Integration/Chat]]}} |
| {{Note|The pull request integrating this with Diaspora is at https://github.com/diaspora/diaspora/pull/5073}}
| |
| | |
| This wiki-page is about setting up [http://getvines.org Vines] on your Diaspora installation.
| |
| | |
| {{Quote|Vines is an XMPP chat server that connects you with large clusters of machines as easily as chatting with a friend.<br>
| |
| It's a new, simpler way to manage your servers in the cloud or the data center.| http://www.getvines.org/}}
| |
| | |
| = Installation =
| |
| | |
| == Set up branch ==
| |
| | |
| Checkout or merge XMPP chat feature branch from zauberstuhl/diaspora.git:
| |
| | |
| <syntaxhighlight lang="bash">
| |
| git remote add zauberstuhl https://github.com/Zauberstuhl/diaspora.git
| |
| git fetch zauberstuhl && git checkout -b xmpp_chat_feature zauberstuhl/xmpp_chat_feature
| |
| </syntaxhighlight>
| |
| | |
| {{Serious|xmpp_chat_feature-branch is based upon Diaspora develop-branch!}} | |
| | |
| | |
| == Update ==
| |
| | |
| All required dependencies are included in your <tt>Gemfile</tt>. The only thing you have to do now is follow the [[Updating|Update guide]]!
| |
| In short, execute following:
| |
| | |
| <syntaxhighlight lang="bash">
| |
| export RAILS_ENV=development
| |
| bundle install
| |
| bundle exec rake db:migrate
| |
| </syntaxhighlight>
| |
| | |
| = Configuration =
| |
| | |
| You'll find all required configuration parameters in <tt>diaspora.yml.example</tt>. If you'd like to activate the chat feature
| |
| you have to copy paste the chat section from <tt>diaspora.yml.example</tt> to your actual <tt>diaspora.yml</tt> configuration file and
| |
| activate the chat globally:
| |
| | |
| <syntaxhighlight lang="yaml">
| |
| chat:
| |
| enabled: true
| |
| </syntaxhighlight>
| |
| | |
| If you have already a working XMPP server and need only the front-end:
| |
| | |
| <syntaxhighlight lang="yaml">
| |
| chat:
| |
| enabled: true
| |
| server:
| |
| enabled: false
| |
| </syntaxhighlight>
| |
| | |
| It is also possible to configure the port and address of the client-to-server, server-to-server and the BOSH service.
| |
| You'll also find the required parameters in <tt>diaspora.yml.example</tt> with a small description.
| |
| | |
| == Certificates ==
| |
| | |
| {{Serious|For encrypted communication we need a cerificate and the related key.<br>}}
| |
| Put your files in the vines-cert folder, you can configure the path in diaspora.yml under the chat section.
| |
| | |
| The default path is <code>/path_to_diaspora_installation/config/vines/</code>.<br>
| |
| Also the domain name should be included in the file name e.g.:
| |
| | |
| * example.com.crt
| |
| * example.com.key
| |
| | |
| | |
| If you have no certificate and want to generate a self-signed you can do that with vines, too.
| |
| Just execute in you diaspora environment <code>bundle exec vines cert example.com</code> and you should be good to go ..
| |
| | |
| {{Note|If you use your server in a development mode, think about enabling acceptance of self-signed certificates in your diaspora.yml!}}
| |
| | |
| = Run it =
| |
| | |
| If you are finished configuring the chat server you can start Diaspora as normal:
| |
| | |
| <syntaxhighlight lang="bash">
| |
| ./script/server
| |
| </syntaxhighlight>
| |
| | |
| Log into Diaspora and you should see the web client in the right corner.
| |
| You can also log into it with your favorite desktop client like Pidgin.
| |
| | |
| For that use your Diaspora ID and your Diaspora password.
| |
| | |
| = Debugging =
| |
| | |
| On default Vines will log to <tt>log/vines.log</tt> and has a log level of <tt>info</tt> set.
| |
| Set the logging level to <tt>debug</tt>, <tt>info</tt>, <tt>warn</tt>, <tt>error</tt>, or <tt>fatal</tt>. The <tt>debug</tt> level logs all XML sent and received by the server.
| |
| | |
| <syntaxhighlight lang="yaml">
| |
| chat:
| |
| server:
| |
| log:
| |
| file: 'log/vines.log'
| |
| level: 'debug'
| |
| </syntaxhighlight>
| |
| | |
| | |
| [[Category:Podmin]] [[Category:Installation]]
| |
Warning: