Rhino uses a prefix per mini-bundle to generate full event IDs included in the exported final SAS resource bundle. Generated event IDs are 24 bits, composed of the assigned bundle mapping prefix in the upper 16 bits and the mini-bundle event index in the lower 8 bits.
By default, these mappings need to be manually assigned.
To have Rhino automatically assign prefixes to unmapped bundles, set assignbundlemappings
to true
when installing a deployable unit.
Reporting of events from mini-bundles that have not been assigned a prefix will be ignored and will not be sent to SAS.
To check for any mini-bundles with missing prefix mappings, use the listunmappedsasbundles
console command.
To manage these mappings, Rhino provides the following methods.
Console command: listsasbundlemappings
Command |
listsasbundlemappings [-sortBy <sortBy>] Description Lists all the SAS bundle mappings. Options -sortBy The column to sort the bundle mappings by for display. Either 'name' or 'prefix' |
---|---|
Example |
[Rhino@localhost (#1)] listsasbundlemappings name prefix ---------------------------------------- ------- com.opencloud.slee.services.example.sas 0x0001 1 rows |
Console command: setsasbundlemapping
Command |
setsasbundlemapping <name> <prefix> Description Sets a SAS bundle mapping. Required Arguments name The fully qualified name of the bundle. prefix The prefix for the bundle mapping, as a decimal, hex, or octal string. |
---|---|
Example |
[Rhino@localhost (#1)] setsasbundlemapping com.opencloud.slee.services.example.sas 0x0001 Added a SAS bundle mapping from com.opencloud.slee.services.example.sas to 0x0001. |
Console command: removesasbundlemapping
Command |
removesasbundlemapping <name> Description Removes a SAS bundle mapping. Required Arguments name The fully qualified name of the bundle. |
---|---|
Example |
[Rhino@localhost (#1)] removesasbundlemapping com.opencloud.slee.services.example.sas Prefix for com.opencloud.slee.services.example.sas removed. |
Console command: listunmappedsasbundles
Command |
listunmappedsasbundles Description Display unmapped SAS bundles |
---|---|
Example |
[Rhino@localhost (#1)] listunmappedsasbundles Unmapped SAS bundles found: com.opencloud.slee.resources.http |