Difference between revisions of "Vines"

From diaspora* project wiki
Jump to: navigation, search
(Update)
(#REDIRECT)
 
(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]]
 

Latest revision as of 10:08, 17 June 2016

Redirect to:

»» Important
This page moved to Integration/Chat