From c4b7de2a754e166c67cea40b35948c851b76ca6d Mon Sep 17 00:00:00 2001
From: Mike Gabriel <mike.gabriel@das-netzwerkteam.de>
Date: Fri, 19 Feb 2016 11:09:39 +0100
Subject: README(.md): Improve README(.md), rename file (-> .md), maintain
 README as symlink.

---
 README    |  8 +-------
 README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 7 deletions(-)
 mode change 100644 => 120000 README
 create mode 100644 README.md

diff --git a/README b/README
deleted file mode 100644
index 3519c77..0000000
--- a/README
+++ /dev/null
@@ -1,7 +0,0 @@
-A small service to grab various remote login possibilities from the local
-network configuration, network servers 
-that provide them, and present them to the user to log into for both
-applications and full desktop posibilities.
-
-This project has been forked by the X2Go/Arctica Project
-to support Remote Login against Linux machines via X2Go.
diff --git a/README b/README
new file mode 120000
index 0000000..42061c0
--- /dev/null
+++ b/README
@@ -0,0 +1 @@
+README.md
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..139cb77
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+# Remote Logon Service
+
+## Introduction
+
+A small service to grab various remote login possibilities from the local
+network configuration, network servers that provide them, and present
+them to the user to log into for both applications and full desktop
+posibilities.
+
+This project has been forked from Ubuntu's remote-login-service project
+[1] by the X2Go/Arctica Project to support Remote Login against Linux
+machines via X2Go.
+
+## Configuring the Remote Logon Service
+
+The service's configuration file is located in
+```
+  /etc/remote-logon-service.conf
+```
+Adapt the default configuration to your needs.
+
+### Using Arctica Session Broker as service backend
+
+This backend is not available, yet.
+
+### Using an X2Go Session Broker as service backend
+
+When using an X2Go Session Broker as service backend, adapt the service
+configuration file like this:
+
+```
+[Remote Login Service]
+Servers=MyUCCSTest
+
+[Server MyUCCSTest]
+Name=Remote Login
+URI=http://x2gobroker.localdomain:8080/uccs/inifile/
+```
+
+## Testing the service
+
+After you have installed and configured the Remote Logon Service, you can
+query the remote logon service manually using the ´´dbus-send´´ command:
+
+```
+dbus-send --session --print-reply --dest="org.ArcticaProject.RemoteLogon" \
+          /org/ArcticaProject/RemoteLogon org.ArcticaProject.RemoteLogon.GetServersForLogin \
+          string:'http://x2gobroker.localdomain:8080/uccs/inifile/' \
+          string:'<user>' \
+          string:'<password>' \
+          boolean:true
+```
+
+[1] https://launchpad.net/remote-login-service
-- 
cgit v1.2.3