Offline Instant Messaging v2
From OpenSimulator
Revision as of 16:55, 18 February 2013 by Allen Kerensky (Talk | contribs)
Contents |
Offline Instant Messaging v2
Diva Canto has contributed a new Offline Instant Messaging v2 module for OpenSim 0.7.6-dev r/22086 and later.
To configure this, instead of the Offline Messaging module which requires an external PHP script.
OpenSim.ini
Enabled the chosen instant messaging module in the [Messaging] block:
[Messaging] ;# {OfflineMessageModule} {} {Module to use for offline message storage} {OfflineMessageModule "Offline Message Module V2" *} ;; Module to handle offline messaging. The core module requires an external ;; web service to do this. See OpenSim wiki. ; OfflineMessageModule = OfflineMessageModule ;; Or, alternatively, use this one, which works for both standalones and grids ; OfflineMessageModule = "Offline Message Module V2" ;# {OfflineMessageURL} {OfflineMessageModule:OfflineMessageModule Offline Message Module V2:Offline Message Module V2} {URL of offline messaging service} {} ;; URL of web service for offline message storage. Leave it commented if your service is local to the sim. ; OfflineMessageURL = http://yourserver/Offline.php or http://yourrobustserver:8003 ;# {StorageProvider} {Offline Message Module V2:Offline Message Module V2} {DLL that provides the storage interface} {OpenSim.Addons.OfflineIM} ;; For standalones, use the service directly. This is the storage dll. ; StorageProvider = OpenSim.Addons.OfflineIM.dll ;# {MuteListModule} {OfflineMessageModule:OfflineMessageModule} {} {} MuteListModule ;; Mute list handler (not yet implemented). MUST BE SET to allow offline ;; messages to work ; MuteListModule = MuteListModule ;# {MuteListURL} {OfflineMessageModule:OfflineMessageModule} {} {} http://yourserver/Mute.php ;; URL of the web service that serves mute lists. Not currently used, but ;; must be set to allow offline messaging to work. ; MuteListURL = http://yourserver/Mute.php ;; Control whether group messages are forwarded to offline users. ;; Default is true. ;; This applies to the core groups module (Flotsam) only. ; ForwardOfflineGroupMessages = true
Robust.ini
If you use a Robust server, the Robust.ini needs the following updates:
[ServiceList] ... initial INI stuff ;; Uncomment this if you want offline IM to work ;OfflineIMServiceConnector = "8003/OpenSim.Addons.OfflineIM.dll:OfflineIMServiceRobustConnector" ... more INI stuff deleted ... [Messaging] ; OfflineIM StorageProvider = "OpenSim.Addons.OfflineIM.dll" OfflineIMService = "OpenSim.Addons.OfflineIM.dll:OfflineIMService"
Robust.HG.ini
If you use a Robust server with Hypergrid enabled, the Robust.HG.ini needs the following updates:
[ServiceList] ... initial INI stuff ;; Uncomment this if you want offline IM to work ;OfflineIMServiceConnector = "8003/OpenSim.Addons.OfflineIM.dll:OfflineIMServiceRobustConnector" ... more INI stuff deleted ... [Messaging] ; OfflineIM StorageProvider = "OpenSim.Addons.OfflineIM.dll" OfflineIMService = "OpenSim.Addons.OfflineIM.dll:OfflineIMService"
MySQL Database
The Offline Instant Messaging v2 Module uses the following MySQL storage:
:VERSION 1 # -------------------------- BEGIN; CREATE TABLE `im_offline` ( `ID` MEDIUMINT NOT NULL AUTO_INCREMENT, `PrincipalID` char(36) NOT NULL DEFAULT '', `Message` text NOT NULL, `TMStamp` timestamp NOT NULL, PRIMARY KEY (`ID`), KEY `PrincipalID` (`PrincipalID`) ) ENGINE=MyISAM; COMMIT; :VERSION 2 # -------------------------- BEGIN; INSERT INTO `im_offline` SELECT * FROM `diva_im_offline`; DROP TABLE `diva_im_offline`; COMMIT;