V2 Groups
From OpenSimulator
(Difference between revisions)
m (Fixed a few typos and correct name of database field) |
|||
| Line 1: | Line 1: | ||
As of OpenSimulator 0.7.6 Diva implemented the V2 Groups, which are now part of OpenSimulator core. Using the new groups do not need to use any third Party modules any more. | As of OpenSimulator 0.7.6 Diva implemented the V2 Groups, which are now part of OpenSimulator core. Using the new groups do not need to use any third Party modules any more. | ||
| − | The below script helps, converting | + | The below script helps, converting existing Flotsam Groups or jOpenSim Groups (which uses Flotsam anyway) to the new Groups. This ensures, that you dont lose any Group information, when you want to switch over. |
---- | ---- | ||
| Line 17: | Line 17: | ||
---- | ---- | ||
| − | '''NOTE''': | + | '''NOTE''': You do not need to consider the field '''BinaryBucket''' in the flotsam table '''osgroupnotice''' as long as you did not apply the patch attached to [http://opensimulator.org/mantis/view.php?id=6699 Mantis #6699]. If you have applied it, then maybe the following information will help, if you do not want to miss the content in the new tables: |
Byte offset and description of bucket data: | Byte offset and description of bucket data: | ||
| Line 29: | Line 29: | ||
* ??: NUL byte to terminate the attachment name | * ??: NUL byte to terminate the attachment name | ||
| − | This information is copied from the original patch and describes the content format of field | + | This information is copied from the original patch and describes the content format of field BinaryBucket. |
---- | ---- | ||
Revision as of 07:17, 15 September 2013
As of OpenSimulator 0.7.6 Diva implemented the V2 Groups, which are now part of OpenSimulator core. Using the new groups do not need to use any third Party modules any more.
The below script helps, converting existing Flotsam Groups or jOpenSim Groups (which uses Flotsam anyway) to the new Groups. This ensures, that you dont lose any Group information, when you want to switch over.
Differences between jOpenSim and Flotsam (the table names):
- jos_opensim_groupactive = osagent
- jos_opensim_group = osgroup
- jos_opensim_groupinvite =osgroupinvite
- jos_opensim_groupmembership = osgroupmembership
- jos_opensim_groupnotice = osgroupnotice
- jos_opensim_grouprolemembership = osgrouprolemembership
- jos_opensim_grouprole = osrole
NOTE: You do not need to consider the field BinaryBucket in the flotsam table osgroupnotice as long as you did not apply the patch attached to Mantis #6699. If you have applied it, then maybe the following information will help, if you do not want to miss the content in the new tables:
Byte offset and description of bucket data:
- 0: 1 byte indicating if attachment is present
- 1: 1 byte indicating the type of attachment
- 2: 16 bytes - Group UUID
- 18: 16 bytes - UUID of the attachment owner
- 34: 16 bytes - UUID of the attachment
- 50: variable - Name of the attachment
- ??: NUL byte to terminate the attachment name
This information is copied from the original patch and describes the content format of field BinaryBucket.
The Script (Replace ROBUSTDB with your ROBUST database and FLOTSAMDB with your database, containing your jOpenSim or your Flotsam tables!):
/* SQL script to convert group tables from Flotsam Groups (Group database) or jOpenSim (tables in Joomla Database) to new V2 groups, which are part of OpenSimulator core up from 0.7.6 branch*/ /* FlotSam Tables latest version from https://github.com/mcortez/flotsam/tree/master/flotsam/Servers/XmlRpcGroupsServer/ Commit-No.: 18275462c9*/ /* jOpenSim Version: 0.2.6.4*/ /*fill os_groups_groups in ROBUST database with values from jos_opensim_groups or FlotSam osgroup*/ INSERT INTO `ROBUSTDB`.`os_groups_groups` (GroupID, Name, Charter, InsigniaID, FounderID, MembershipFee, OpenEnrollment, ShowInList, AllowPublish, MaturePublish, OwnerRoleID) SELECT GroupID, Name, Charter, InsigniaID, FounderID, MemberShipFee, OpenEnrollment, ShowInList, AllowPublish, MaturePublish, OwnerRoleID FROM `FLOTSAMDB`.jos_opensim_group; /*fill os_groups_invites in ROBUST database with values from jos_opensim_groupinvite or FlotSam osgroupinvite*/ INSERT INTO `ROBUSTDB`.`os_groups_invites` (InviteID, GroupID, RoleID, PrincipalID, TMStamp) SELECT InviteID, GroupID, RoleID, AgentID, TMStamp FROM `FLOTSAMDB`.jos_opensim_groupinvite; /*fill os_groups_membership in ROBUST database with values from jos_opensim_groupmembership or FlotSam osgroupmembership*/ INSERT INTO `ROBUSTDB`.`os_groups_membership` (GroupID, PrincipalID, SelectedRoleID, Contribution, ListInProfile, AcceptNotices) SELECT GroupID, AgentID, SelectedRoleID, Contribution, ListInProfile, AcceptNotices FROM `FLOTSAMDB`.jos_opensim_groupmembership; /*fill os_groups_notices in ROBUST database with values from jos_opensim_groupnotice or FlotSam osgroupnotice*/ INSERT INTO `ROBUSTDB`.`os_groups_notices` (GroupID, NoticeID, TMStamp, FromName, Subject, Message) SELECT GroupID, NoticeID, Timestamp, FromName, Subject, Message FROM `FLOTSAMDB`.jos_opensim_groupnotice; /*fill os_groups_principals in ROBUST database with values from jos_opensim_groupactive or FlotSam osagent*/ INSERT INTO `ROBUSTDB`.`os_groups_principals` (PrincipalID, ActiveGroupID) SELECT AgentID, ActiveGroupID FROM `FLOTSAMDB`.jos_opensim_groupactive; /*fill os_groups_rolemembership in ROBUST database with values from jos_opensim_grouprolemembership or FlotSam osgrouprolemembership*/ INSERT INTO `ROBUSTDB`.os_groups_rolemembership (GroupID, RoleID, PrincipalID) SELECT GroupID, RoleID, AgentID FROM `FLOTSAMDB`.jos_opensim_grouprolemembership; /*fill os_groups_roles in ROBUST database with values from jos_opensim_grouproles or FlotSam osrole*/ INSERT INTO `ROBUSTDB`.os_groups_roles (GroupID, RoleID, Name, Description, Title, Powers) SELECT GroupID, RoleID, Name, Description, Title, Powers FROM `FLOTSAMDB`.jos_opensim_grouprole; /*fill os_groups_roles in ROBUST database with values from jos_opensim_offlinemessages --> no corresponding table in FlotSam -- only applies to jOpenSim*/ INSERT INTO `ROBUSTDB`.im_offline (PrincipalID, Message, TMStamp) SELECT fromAgentID, Message, sent FROM `FLOTSAMDB`.jos_opensim_offlinemessages;
