#weblin

Und wieder einmal bekommt ein Prinzip, das wir bei Weblin entwickelt und benutzt haben, einen Namen: Microservices. "Microservices is a software architecture design pattern, in which complex applications are composed of small, independent processes communicating with each other using language-agnostic APIs" Wir haben es natürlich nicht erfunden. Viele andere gute Softwareingenieure haben zur gleichen Zeit das gleiche gemacht und inzwischen ist das Prinzip (=architecture design pattern) im Mainstream angekommen und hat einen Namen und es gibt viele Artikel und Vorträge. Es geht darum, dass man nicht eine fette Anwendung macht, sondern mehrere (viele) von einander logisch getrennte Web-Services, die jeweils eine Funktionalität des Gesamtsystems bereitstellen und untereinander kommunizieren. Das betrifft sowohl Client/Server Kommunikation, als auch Server-Frontend/Backend und innerhalb vom Backend. Microservices können in verschiedenen Sprachen geschrieben sein und haben typischerweise jeweils eigene Datenbanken (wenn auch oft auf dem gleichen Datenbankserver). Microservices können horizontal oder vertikal skalieren,d.h. alle können auf der gleichen Server Farm laufen oder man ordnet einzelnen Microservices dedizierte Server zu. Welches Web-Service Protokoll man wählt spielt eine untergeordnete Rolle. Eigentlich kann man Transportprotokoll und Datenformat beliebig kombinieren. REST/JSON ist dafür momentan das Mittel der Wahl. Aber SOAP geht auch. XMLRPC war mal sehr verbreitet. Bei Weblin hatten wir oft Key/Value/LF als Datenformat (auch liebevoll SRPC genannt), weil das meistens völlig ausreicht. Es geht aber auch anspruchsvoller, z.B. mit Protocol Buffers als Datenformat. Als Transportprotokoll bietet sich HTTP an. Aber es geht auch plain TCP oder ein Message-Bus. Bei Weblin hatten wir Microservices für:

Userdaten (Identity), vom Frontend bespielt, vom Client benutzt

User created content upload (der berühmte File-Service: files.zweitgeist.com)

Download-Server

Wallet-Service und Punktekonto

Topsites-Service

XMPP-Server Management Service

Unit-Test (System-Runtime-Test) als Web-Service

GeoIP Auflösung als Web-Service

Kontaktlistenverwaltung

Wuscheln, Publisher (alles, was der Client wollte, ich sage nur "srpc.php")

VPI-Server

Compute-Service (Avatar-Generator)

Locatr

Ad-Server

Es passiert ja nicht wirklich viel im Weblin-Land, aber manchmal gibt es doch einen Grund zu feiern. Wir haben den ersten Weblin mit mehr als 2^16 Punkten (=65536) und deshalb mit schwarzer Krone am Avatar. Hier ein Screenshot von http://www.weblin.com/toplins.php:

Macr@Soft ist ewiger Ruhm sicher.

In the forum of the Open Virtual World project someone posted a way to reactivate Weblin. Based on this information and after my own tests I can confirm, that it works. It is even simpler and works without programming. All you need is a Web space to put some files. You create a Jabber account on a public Jabber server, (e.g. http://register.jabber.org). Then put some files on your Web space and configure Weblin to use them. You need 2 XML files and an image as avatar. If you want an animated avatar then you need an additional XML and some animated GIFs. Quick Try: Enter in the Windows registry ...

[HKEY_CURRENT_USER\Software\zweitgeist\Firebat\2.0.0\Config\Operation] PlatformLoginURL=http://ydentiti.org/test/Planta/login.xml

Restart Weblin .. and you are Planta. But, we do not want to be Planta, therefore to create your own... HowTo: The 2 most important files are login.xml and identity.xml. I have put both as examples on my web server:

http://ydentiti.org/test/Planta/login.xml http://ydentiti.org/test/Planta/identity.xml

In login.xml is the URL of identity.xml and you have to enter the Jabber account: Jabber passwort ("secret"), Jabber user name ("planta") und Jabber server ("jabber.org"). In identity.xml is a link to the avatar image:

http://ydentiti.org/test/Planta/still.gif

Now you tell Weblin to use login.xml at startup. You set the registry key like this:

[HKEY_CURRENT_USER\Software\zweitgeist\Firebat\2.0.0\Config\Operation] PlatformLoginURL=http://ydentiti.org/test/Planta/login.xml

Of course, that's the URL of your web space. Where do you get the software from? Just copy the folder "C:\Program Files\weblin" from a friend. There is no installer required. For Advanced Users: Because the PlatformLoginURL is public, anyone can use this avatar (and the Jabber account). The Weblin login screen requests a password. It sends the password, but your web space probably returns the login.xml without checking the password. If you want to protect your login.xml, then you must create a login.php instead of the login.xml. Your login.php can check the HTTP Basic Authentication. You could also protect the login.xml with .htaccess. Attention: .htaccess protects the entire folder. Do not accidentally deny access to the other files. Anyone must be able to fetch your identity.xml and avatar image. You can put login.xml into a separate folder and set PlatformLoginURL accordingly. For Advanced Users: identity2.xml has an additional link to an animation file:

http://ydentiti.org/test/Planta/avatar.xml

which links to animated GIFs. This provides your weblin with actions and animations. Required:

                                 For the start copy this file and use your own GIFs. The XML and the GIFs are cached by the client. If you change something, you have to delete the client cache (C:\Documents and Settings\%USERNAME%\Application Data\zweitgeist\cache). avatar.xml format in short:

has multiple

has one

has an attribut "group". This is the action, walk, stand, sleep, wave. If there are multiple actions in the same "group", then Weblin searches a randomly controlled by the relative "probability".

has an attribut "name". Must be unique, but can be anything.

has an attribut "probability": relative frequency of the in a "group"

has an attribut "type" with values "status", "basic", "emote". "emote" appear as actions in the avatar-menu.

attributes "in" and "out" can be ignored. They are for advanced uses with automatic selection of transitions between actions.

has only the attribut "src". An animated GIF URL absolute or relative the XML file

Im Forum des Open Virtual World Projekts hat jemand einen Weg gepostet mit dem man Weblin wieder betreiben kann obwohl die Server abgeschaltet worden sind. Basierend auf diesen Informationen und nach meinen eigenen Tests kann ich bestätigen, dass es geht. Es ist sogar noch einfacher und ohne Programmierkenntnisse. Man muss nur auf einem öffentlichen Jabber Server einen Jabber Account anlegen (z.B. http://register.jabber.org). Dann auf einem Web-Space ein paar Dateien hinlegen und Weblin konfigurieren, dass es diese Dateien benutzt. Man braucht 2 XML Dateien. Dann natürlich ein Bild als Avatar und je nachdem, ob man ein animiertes Avatar will, noch ein XML mit GIF Animationen. Schnell mal ausprobieren: In Registry eintragen...

[HKEY_CURRENT_USER\Software\zweitgeist\Firebat\2.0.0\Config\Operation] PlatformLoginURL=http://www.ydentiti.org/test/Planta/login.xml

Weblin neu starten ... und du bist Planta. Aber wir wollen ja nicht jeder Planta sein, deshalb... So geht es: Die 2 wichtigsten Dateien sind login.xml und identity.xml. Als Beispiele habe ich diese 2 Dateien gemacht und auf meinen eigenen Webserver gelegt:

http://www.ydentiti.org/test/Planta/login.xml http://www.ydentiti.org/test/Planta/identity.xml

In login.xml steht der URL von identity.xml und man muss den JabberAccount, also Jabber Passwort ("secret"), Jabber Username ("planta") und Jabber Server ("jabber.org") eintragen. In identity.xml ist ein Link auf das Avatarbild:

http://ydentiti.org/test/Planta/still.gif

Jetzt muss man nur noch Weblin beibringen, dass es das login.xml benutzt beim Starten. Dazu einen Registry Key setzen. Beispiel:

[HKEY_CURRENT_USER\Software\zweitgeist\Firebat\2.0.0\Config\Operation] PlatformLoginURL=http://www.ydentiti.org/test/Planta/login.xml

Natürlich muss hier der richtige URL von deinem Web-Space stehen. Vielleicht programmiert Marmel ja ein Tool dafür :-) Ach ja, wo bekommt man die Software her? Einfach von eine(r|m) Freund(in|) den Ordner C:\Programme\weblin kopieren. Kein Installer nötig. Für Fortgeschrittene: Da der PlatformLoginURL öffentlich ist, kann jeder dieses Avatar (und den Jabber Account) benutzen. Weblin fragt beim Start zwar ein Passwort. Das wird aber nicht verwendet, da bei PlatformLoginURL ein statischer URL eingetragen ist und nicht eine echte Web-Applikation, die das Passwort prüfen würde. Wenn man nicht will, dass andere das gleiche Avatar verwenden, muss man wie in dem Forum Post vorgehen und statt login.xml ein login.php programmieren, dass HTTP Basic Authentication prüft. Alternativ kann man auch das login.xml durch .htaccess schützen. Vorsicht: dabei nicht Zugriff auf die anderen Dateien verbieten. Man kann das login.xml dafür in ein anderes Verzeichnis legen und den PlatformLoginURL entsprechend setzen. Für Fortgeschrittene: Man kann den PlatformLoginURL auch in Firebat.sreg eintragen, wenn man mit leerer Registry startet. Registry überschreibt Einstellungen in Firebat.sreg. Für Fortgeschrittene: In identity2.xml ist auch ein Link auf eine Animationsdatei:

http://ydentiti.org/test/Planta/avatar.xml

die auf die GIFs mit den Animationen verweist. Dann hat der Weblin auch Aktionen und bewegt sich. Notwendig ist mindestens:

Zum Start am Besten dieses kopieren und nur eigene GIFs verwenden. Das XML und die GIFs werden im Client gecached. Wenn man was ändert und die Änderung sehen will, dann Client Cache löschen (C:\Dokumente und Einstellungen\%USERNAME%\Anwendungsdaten\zweitgeist\cache). Format in Kürze:

hat mehrere

hat ein

hat Attribut "group". Das ist die Aktion, laufen, stehen, schlafen, winken. Es kann mehrer mit gleicher "group" geben, dann sucht Weblin eine der s zufällig aus gesteuert durch die relative Häufigkeit ("probability").

hat Attribut "name". Muss nur eindeutig sei, aber beliebig.

hat Attribut "probability": Relative Häufigkeit der innerhalb einer "group"

hat Attribut "type" mit Werten "status", "basic", "emote". "emote" tauchen als Aktionen im Avatar-Menu auf.

Attribute "in", "out" kann man mal ignorieren

hat nur das Attribut "src". GIF URL absolut oder relative zu der XML Datei (mit oder ohne http://...)