Determine Activity Count In Buddy List Administrator for IBM Sametime

Instant's Buddy List Administrator enables the centralized management and server based control of IBM Sametime contact lists.  Buddy List Administrator has the ability to add public groups, add private groups, rename contacts, remap IDs, completely delete contacts lists, as well as various other features. 

One common use of Buddy List Administrator is in the self provisioning of users.  In this scenario, Buddy List Administrator is included in an automated work flow process to pre-populate the contact lists of newly registered users (Sametime accounts).

The following steps enable administrators to determine how many Buddy List Administrator activities have been executed within a BLA database.

Navigate to the Activity Log Summary view:

The total number of records in this view will provide one snapshot of the number of activities processed by the engine.  So, if there are 600 records in this view, then the system has processed at least 600 activities.

In addition to inspecting the Activity Log Summary view, the system keeps a running count of total number of activities processed.  This internally managed value is visible by using the following steps:

Navigate to the Activity Log Summary view (you may want to use the Activity Log by Date view):

Or you can open the Activity Log By Date view

Open an Activity Log Summary document

Open  the most recently executed summary document:

Click on Advanced Log Output

Within the output, you will see some text that includes a count of the total activities executed.  The text will have the following syntax:

ITDominoSession.incrementActivityCount - total activites is now :

This will provide a count of the total number of activities processed by the system.

Setting up Instant Measurements and Reporting Suite for Instant IMtegrity and IBM Lotus Sametime logs

1. Setting up the Measurements and Reporting Database

a. Sign the Template

Login to Lotus Domino Administrator with the Administrator’s ID or an ID that has proper rights on the server on which the template has been installed.

Select the server on which the template has been copied by clicking on ‘File --> Open Server’ from the menu

After the selected server has been loaded click on tabs and select ‘Templates Only’ from the list ‘Show me’ as shown in the below figure

Right-click on the Measurement Suite template after finding it from the list and click ‘Sign’

Click Ok on the dialog shown below to sign the template.

b. Create the Database

Create a new Database ‘ITQMeasure.NSF’ on the server using the signed Measurement Suite Template.

Login to Lotus Notes client with the Administrator’s ID or an ID that has rights to create database on the server.

Click on File --> Database --> New to get the dialog for creating new database

Select the Server on which the database needs to be created.

Specify a title for the database.

The title is not important – although we recommend:

Instant Measurements and Reporting

The file name should be:

ITQMeasure.nsf

Select the Server on which the Measurements Reporting Suite template is installed

Select the Measurements Reporting Suite template from the templates list and click ok

c. Set up the ACL

Right-Click on database in the Lotus Notes workspace ‘Database --> Access Control’ to get the dialog for specifying the access

Click on ‘ADD’ to enter the new entries to the list

The server entry must have an access level of ‘Manager’

The default entry must have an access level of ‘No Access’ and of user type ‘unspecified’

A entry called ‘Anonymous’ must be added which will have an access level of ‘No Access’ and of user type ‘unspecified

There must be an entry of a user or a group with access level of ‘Manager’ and of user type ‘’Person’ or ‘Person group’ with role ‘Chart Admin’ who will responsible for administrating the database.

There must be an entry of a user or a group with access level of ‘Author’, ‘Create Documents’ rights and of user type ‘’Person’ or ‘Person group’ who are basically users of this database.

d. Set up the config documents

Open the newly created ITQMeasure.nsf database from the lotus notes client. The main purpose of this step is to link the Measurements database with the IMtegrity and ST Logs databases and configure the live feed.

IMtegrity

Click on ‘Click here’ to open the setup document in the screen as shown above.

Select ‘Instant IMtegrity’ tab, click on ‘Browse’ to open up the database dialog and select the ‘Instant IMtegrity Chat Logs’ (imtchatlog4.nsf) created in the previous step.

ST Logs

Select ‘Lotus Sametime Log’ tab, click on ‘Browse’ to open up the database dialog and select the ‘Sametime Log’ (stlog.nsf) created in the previous step.

Live Feed

Click on ‘Live Feed’ and enter the following details.

Livefeed Servlet URL: The URL should be the FQDN of the Lotus Domino Sametime server followed by ‘/servlet/statistics’

http://<sametime server fqdn or ip address>/servlet/statistics

User Name & Password: Enter the username and password of a user who has access to the sametime server

click on ‘Browse’ to open up the database dialog and select the ‘Instant Measurements and Reporting’ (ITQMeasure.nsf) i.e the current database.

Click on ‘Save and Close’ to save the configuration.

Note: The following step is important for Imtegrity charts to work

Open the newly created ‘Instant Measurements and Reporting’ (ITQMeasure.nsf) using Lotus Domino designer.

Copy all the views with the names starting with ‘(Imtegrity Datasets\...)’ and copy it to

Instant IMtegrity Chat Logs’ (imtchatlog4.nsf)

e. Access the Reporting database

Once the config documents has been setup, the database can be accessed using the link

http://stserverFQHN/itqmeasure.nsf/landingmain

Imtegrity charts will be displayed by default. Charts of STLogs and Live Feed can be accessed with the tabs as shown in the screen shot.

All charts can be printed and exported to excel using the actions provided at the top right as shown in the screen shot.

Charts with ‘*’ indicates that it can be drilled down by clicking on the column you like to view.

Charts are cached hourly or daily depending of the setting in their config document.

If a displayed chart is cached or live is displayed in the top right of the chart window.

By default charts will be displayed from cache and live chart can be viewed using the link as shown in the screen shot.

Access Level for creating Date Range charts in Instant Measurements Suite

For a user accessing Instant Measurements and Reporting Suite wants to create a Date range charts, then there must exist an entry in the ACL of Instant Measurements and Reporting database (ITQMeasure.nsf) with his name  or a group (which he is member of) with minimum access level of 'Author' with ‘Create Documents’ rights and of user type ’Person’ or ‘Person group’.

Enable Mailing of Chat Transcripts in Queue Logs database

The following are the steps to enable the mailing of every log created in the Queue Logs database to predefined recipient(s).


Through Lotus Notes client workspace, locate and open Queue Logs database.


From the left navigator, click on 'Dashboard Config' and then 'Edit Profile'

Under 'E-mail Logging Options' locate the field 'Recipients to receive Email on Every log Created' and enter the recipients who should receive mail with chat details including transcript when log is created.

Click on 'Enable:E-mail Every Log' to enable the agent which sends out the mail to the intended recipients when a log is created in the Queue Logs database. 


Click on 'Save' on the top left of the profile form to save the changes.

Fix to Sametime Directory Applet 'Loading Directory...' Error

The following steps needs to performed to fix the Sametime Directory Applet error 'Loading Directory...' 

Open the Sametime.ini file located in the Sametime server installation directory (the default directory is C:\program files\lotus\domino)


Locate the key 'STAuthenticationMethod=' under '[AuthToken]' and this value needs to set to '1'



1 is the default value and means the server will allow both Sametime and LTPATokens
0 is the value that will force the Sametime server to use LTPATokens.


Save and close the  Sametime.ini and restart the server

Setting up Automatic Message Purging in OCS 2007 R2 and Lync 2010

Your organization may have a requirement that only X days of IM chat conversations are to be retained in your archive.  Fortunately, both OCS and Lync provide this functionality out-of-the-box.

OCS 2007R2:

1. Open the Office Communications Server Control Panel
2. Expand the Archiving Servers section in the left panel and select your archiving server.
3. Right-click and select Properties.
4. Check the checkbox "Archiving Days Logged" and enter the number of days you want retained.
5. Select OK to commit the changes. 

IQM V4 Database and Queues Security

Database Level Security

Access Control List (ACL) of Instant Queue Connections database should have the following entries

The user or server with which the database is signed should have entry with access level of ‘Manager’, user type ‘Person’ or ‘Server’ respectively and with ‘[Admin]’ role enabled

A entry called ‘Anonymous’ should exist with an access level of ‘No Access’, user type ‘unspecified’ and with no role enabled

A entry called ‘-Default-‘ should exist with an access level of ‘No Access’, user type ‘unspecified’ and with no role enabled

Domino Server on which the database is hosted should have an entry with access level of ‘Manager’, user type ‘Server’ and with ‘[Admin]’ role enabled

There must exist a entry of a user or a group with access level of ‘Manager’ and of user type ’Person’ or ‘Person group’ who will responsible for administrating the database. This entry should also have ‘[Admin]’ role enabled

There must exist a entry of a user or a group with access level of ‘Author’ with ‘Create Documents’ and of user type ’Person’ or ‘Person group’ who will be users of the application.


If Users require to act as Managers for specific Queue(s) who should be able to add/remove experts to Queue(s), then there must exist a entry of a user or a group with access level of ‘Editor’ with ‘Create Documents’ and of user type ’Person’ or ‘Person group’ (please refer to Queue Level Security section for more info on Managers of a Queue)

If Users needs to be restricted to view only the ‘Measurements and Reporting’ section of the ‘Dash Board’ then there must exist a entry of a user or a group with access level of ‘Author’ with ‘Create Documents’ and of user type ’Person’ or ‘Person group’ and with ‘[Charting]’ role enabled

If Users needs to be restricted to view only the ‘Monitoring Panel’ section of the ‘Dash Board’ i.e the experts section then there must exist a entry of a user or a group with access level of ‘Author’ with ‘Create Documents’ and of user type ’Person’ or ‘Person group’ and with ‘[Expert]’ role enabled

Queue Level Security

Users listed under Admin --> Settings --> Security can control the access to the Queue i.e these users have ability to add or remove managers to a Queue who inturn can add or remove experts to that Queue. These users can also edit/update other properties of the Queue

Before a user can be added to a queue as a manager, they first need to be added to the application directory as ‘Manager’ under ADMIN --> Directory page

Users who will be added as Managers to the queues should exist in the database ACL either as user or in a group with with minimum access level of ‘Author’

If no user listed as ‘Manager’ to a Queue then all the users who have access to the database can view all the Queues and users have access level ‘Editor’ or above can edit all the Queues.

If Managers are defined for a Queue then the following users can read and edit that Queue

Users defined as Managers for that Queue

Users specified in the config settings security field

For rest of the users who have access to the database cannot view this Queue in any of the views and not even read their XML using URLs.

Suppose if a group or user needs to be given access and should be able to view all Queues irrespective of their names being specified or not in config settings or as managers of Queue then they should be added to the ACL of the database with minimum access of ‘Editor’ with ‘Create documents’ and ‘Admin’ role enabled.

The following is the summary of Queue level access with respect to different roles in the database

Role	Create Queues	Edit Queues
[Charting]	No	No
[Expert]	No	Yes (Can edit a Queue if he is in Managers list and have minimum of Editor Access to the database)
No role defined	No	Yes (Can edit a Queue if he is in Managers list and have minimum of Editor Access to the database)
[Admin]	Yes	Yes (User should have minimum of Editor Access to the database)

Manager Panel

Users should be listed under Admin --> Settings --> Security to view and manage Queues using ‘Manager Panel’ of ‘DashBoard’ section.

Upgrade Instructions for Instant Measurements and Reporting Suite

Upgrading of Instant Measurements and Reporting Suite for Queue Manager involves updating the design of 2 Lotus Notes databases

Instant Measurements and Reporting (ITQMeasure.nsf)

Instant Queue Logs (ITQLogs.nsf)

Instant Measurements and Reporting

Log on to Lotus Domino Administrator with the Administrator’s ID or an ID that has rights to refresh the productive database.

Browse to the server which hosts the templates for Instant Measurements and Reporting Suite.

‘File à Open Server’ from the menu

Delete any existing older templates (ITQMeasure_Vx.xx.ntf) and download the latest template from the link provided to Lotus\domino\Data directory.

The next step is to sign the downloaded template.

Right-click on the Measurements and Reporting Suite template after finding it from the list and click ‘Sign’

The next step is to refresh the production Instant Measurements and Reporting database.

Locate the Instant Measurements and Reporting database in the workspace of the Lotus Notes client, Right-click on it, select ‘Database à Refresh Design…’

Click on ‘Yes’ on the next prompt tp proceed with the refresh of the design.

After the design refresh is complete, double click the on database icon to verify the version. It should be same as the version specified in the downloaded template file name. Alternatively you can also find out by looking at the About Database document.

After verifying the version we will proceed with the replace of config documents from the template.

Select Instant Measurements and Reporting database in the workspace of Lotus Notes client, click ‘view à Go To…’

Select ‘Chart Control Docs’ and click ‘OK’ to open the ‘Chart Control Docs’ view

 Select all documents in the view by clicking on ‘Edit à Select All’

After all the documents has been selected then click on ‘Edit à Delete’ and then press ‘F9’ to delete the documents in the view

Locate and select the latest Instant Measurements and Reporting Suite template that has been downloaded in the workspace of Lotus Notes client.


click ‘view à Go To…’

Select ‘Chart Control Docs’ and click ‘OK’ to open the ‘Chart Control Docs’ view

Select all documents in the view by clicking on ‘Edit à Select All’

Click on ‘Edit à Copy’ to copy the selected documents

Browse to opened Instant Measurements and Reporting production database and click on ‘Edit à Paste’ to paste the copied config documents from the template.

Once the documents has finished copying, click on ‘Edit Setup Profile’

Make sure the file path and the server details are pointing to the correct Instant Queue Logs database.

Click on ‘Save and Close’ to update the config documents.

This finishes updating the design of Instant Measurements and Reporting database.

Instant Queue Logs

Delete any existing older templates (ITQLogs_vx.xx.ntf) and download the latest template from the link provided to Lotus\domino\Data directory.

The next step is to sign the downloaded template.

Right-click on the Queue Logs template after finding it from the list and click ‘Sign’

The next step is to refresh the production Instant Queue Logs database.

Locate the Instant Queue Logs database in the workspace of the Lotus Notes client, Right-click on it, select ‘Database à Refresh Design…’

Click on ‘Yes’ on the next prompt tp proceed with the refresh of the design.

After the design refresh is complete, double click the on database icon to verify the version. It should be same as the version specified in the downloaded template file name. Alternatively you can also find out by looking at the About Database document.

After the design update of both the databases, browse to ‘ITQConnect.nsf’ from the browser and browse to ‘Measurements and Reporting’ section to view the latest charts.