Jabberruis » History » Version 1
Joseph Foley, 2015-09-05 03:15
1 | 1 | Joseph Foley | h1. Jabber Instant Messaging at RU |
---|---|---|---|
2 | |||
3 | Welcome to the Instant Messaging (Jabber/XMPP) at Reykjavik University. This project is being implemented by Joe Foley with support from RU IT. |
||
4 | |||
5 | Please register with username.affiliation as your username if you are not an RU student or staff |
||
6 | * RU users: foo@ru.is should register as foo |
||
7 | * LHI users: bar@lhi.is should register as bar.lhi |
||
8 | * Corporate users: bob@marel.is should register as bob.marel |
||
9 | |||
10 | Registration |
||
11 | |||
12 | * Most IM accounts allow you to register when creating an "identity" in their menus. There is commonly a checkbox on the bottom of the dialog for Jabber/XMPP. |
||
13 | * Register for an account here: https://jabber.ru.is:9091/plugins/registration/sign-up.jsp* |
||
14 | |||
15 | Once you have registered, put these settings in your account following the client directions in the section below: |
||
16 | |||
17 | server: jabber.ru.is |
||
18 | domain: jabber.ru.is |
||
19 | |||
20 | Once you have installed a client as shown below, you may want to join a conference. This is usually under "Add chat" or "Add a group chat". |
||
21 | |||
22 | |||
23 | * Room: <whatever the room name is> |
||
24 | * Server: conference.jabber.ru.is |
||
25 | |||
26 | On some clients, this shows up as: conferencename@conference.jabber.ru.is |
||
27 | |||
28 | You also probably want to set "Autojoin" |
||
29 | |||
30 | |||
31 | h1. Client install |
||
32 | |||
33 | These client instructions derived from http://tig.csail.mit.edu/wiki/TIG/Jabber(XMPP)InstantMessaging |
||
34 | |||
35 | |||
36 | h2. Adium |
||
37 | |||
38 | * Download Adium from http://adium.im and install/drag to Applications. |
||
39 | * From the Setup Wizard, enter: |
||
40 | ** "Account type:" XMPP |
||
41 | ** "Username:" _username.affiliation e.g. foley or aki.lhi |
||
42 | **"Domain:" jabber.ru.is |
||
43 | ** "Password:" (your registration password) |
||
44 | * Click OK. |
||
45 | * If you see "Adium can't verify the identity of jabber", click Accept. |
||
46 | |||
47 | If you add the account later, make sure that you give the username without the @jabber.ru.is |
||
48 | otherwise it will not register correctly. |
||
49 | |||
50 | |||
51 | |||
52 | h2. iChat |
||
53 | |||
54 | * The following instructions assume that you are using iChat for the first time. |
||
55 | * Open the iChat application (on a fresh Mac OS installation it will be in your dock already). At the first screen, click "Continue". |
||
56 | * At the Account Setup screen... |
||
57 | ** "Account Type:" Jabber Account |
||
58 | ** "Account Name:" _username@server e.g. foley@jabber.ru.is or aki.lhi@jabber.ru.is_ |
||
59 | ** "Password:" (your registration password) |
||
60 | ** "Server Options" -- click the disclosure triangle... |
||
61 | ** "Server:" jabber.ru.is |
||
62 | ** "Use SSL:" YES |
||
63 | ** Click "Continue", then "Done". |
||
64 | *To add a new contact ("buddy") to your roster ("buddy list"), click on the "+" button in the main iChat window. To join a conference, select "Go to Chat..." from the File menu, and enter the full Jabber ID of the conference room (e.g., watercooler@jabber.ru.is). |
||
65 | |||
66 | h2. Pidgin http://pidgin.im/ |
||
67 | |||
68 | * Get to the Add Account screen (click the Add button, or if there isn't one, go to Accounts/Add-Edit) |
||
69 | * Choose "Protocol": XMPP |
||
70 | * Split your account into "Screen name" and "Domain." (e.g., joe@ru.is will enter Screen name: joe and Domain: jabber.ru.is) |
||
71 | * Enter your password in "Password" and put a check mark next to "Remember password" |
||
72 | * Click "Save." |
||
73 | * You should now be connected. To add a new contact ("buddy") to your roster, go to Buddies/Add Buddy, and enter their localpart (i.e., joe) under "Screen Name". To join a conference, go to Tools/Room List, and click "Get List" followed by "Find Rooms." Select the room you want, then click "Join." |
||
74 | |||
75 | h2. Spark |
||
76 | |||
77 | * Spark is very easy to configure. When it starts up for the first time, it will prompt you for the information it requires: |
||
78 | * Under "Username", enter your username (not the full Jabber ID). |
||
79 | * Under "Password", enter your password. |
||
80 | * Under "Server", enter jabber.ru.is |
||
81 | * Click "Login". |
||
82 | * That's it. To add a new contact to your roster, from the menu select "Contacts" => "Add Contact", and type in the contact's Jabber ID e.g. joe.ru@jabber.ru.is. To join a conference, select the "Conferences" tab, then click on the icon that looks like two small balloons (the ToolTip? reads "Join a Conference Room"). Spark will show you a list of public conferences, and you can bookmark conferences you join frequently. To join a conference, simply double click on it. To start a private conference, select "Actions" => "Start a Conference" and enter the Jabber IDs of the users you wish to invite to the conference. (Under "Room" you can change the name of the conference to something more meaningful; by default it's your name with a random string appended.) |
||
83 | |||
84 | Questions, comments, problems to webmaster@list.ru.is |
||
85 | |||
86 | h1. For administrators |
||
87 | |||
88 | * How to setup SRV records: http://wiki.xmpp.org/web/SRV_Records |
||
89 | <pre>_xmpp-client._tcp.ru.is. 86400 IN SRV 5 0 5222 jabber.ru.is. |
||
90 | _xmpp-server._tcp.ru.is. 86400 IN SRV 5 0 5269 jabber.ru.is. |
||
91 | _stun._tcp.ru.is. 86400 IN SRV 5 0 3478 jabber.ru.is. |
||
92 | _stun._udp.ru.is. 86400 IN SRV 5 0 3478 jabber.ru.is. |
||
93 | _stuns._tcp.ru.is. 86400 IN SRV 5 0 5349 jabber.ru.is. |
||
94 | _turn._tcp.ru.is. 86400 IN SRV 5 0 3478 jabber.ru.is. |
||
95 | _turn._udp.ru.is. 86400 IN SRV 5 0 3478 jabber.ru.is. |
||
96 | _turns._tcp.ru.is. 86400 IN SRV 5 0 5349 jabber.ru.is. |
||
97 | </pre> |
||
98 | |||
99 | * Note, the certificate setup is really tricky and a bit of a hack. Talk to Joe to learn more about it. |
||
100 | |||
101 | h2. Admin interfaces for openfire |
||
102 | |||
103 | * Admin interface https://jabber.ru.is:9091/ |
||
104 | * Admin interface (No SSL) https://jabber.ru.is:9090/ |
||
105 | * Samvinna main page https://samvinna.ru.is/ |
||
106 | |||
107 | h2. References for jabberd2 |
||
108 | |||
109 | * Wiki for installation https://github.com/Jabberd2/jabberd2/wiki/InstallGuide |
||
110 | |||
111 | |||
112 | * [[Jabber Certificates HOWTO]] |