Profiles administrative commands 

ProfilesConfigService commands

Checks Profiles configuration files out to a temporary directory.

This command takes the following parameters:

• <working_directory> . Temporary working directory to which the configuration files are copied. The files are kept in this working directory while you make changes to them.
• <cell_name> . Name of the IBM® WebSphere® Application Server cell hosting the IBM Connections application. If you do not know the cell name, type the following command while in the wsadmin command processor:

print AdminControl.getCell()



• For example:
• AIX/Linux:

ProfilesConfigService.checkOutConfig("/opt/my_temp_dir", "ServerNode01Cell")



• Microsoft® Windows®:

ProfilesConfigService.checkOutConfig("c:/temp","foo01Cell01")

Displays the current configuration settings. You must check out the configuration files with ProfilesConfigService.checkOutConfig before running ProfilesConfigService.showConfig.

Updates configuration properties.

This command takes the following parameters:

• <property> . One of the configuration properties that can be edited for Profiles. See Profiles configuration properties for a full list of Profiles configuration properties and their descriptions.
• <value> . The new value with which you want to set the specified property. Acceptable values for properties can be restricted, for example, to either true or false. See Profiles configuration properties for configuration properties and descriptions.
  
  

Checks in Profiles configuration files. Run from the wsadmin command processor.

Checks the profiles-policy.xml and profiles-policy.xsd files out to a temporary directory.

This command takes the following parameters:

• <working_directory> . Temporary working directory to which the configuration files are copied. The files are kept in this working directory while you make changes to them.
• <cell_name> . Name of the WebSphere Application Server cell hosting the IBM Connections application. If you do not know the cell name, type the following command while in the wsadmin command processor:

print AdminControl.getCell()



• For example:
• AIX/Linux:

ProfilesConfigService.checkOutPolicyConfig("/opt/my_temp_dir", "ServerNode01Cell")



• Microsoft Windows:

ProfilesConfigService.checkOutPolicyConfig("c:/temp","foo01Cell01")

Checks in the Profiles policy configuration files. Run from the wsadmin command processor.

ProfilesService commands

Deletes image files associated with a user's email address. This command can be used only if the user has uploaded a photo to their profile. This command removes the photo.

For example:



ProfilesService.deletePhoto("john_doe@company.com")

Disables the full report-to chain cache capability. This command does not take any arguments.

Enables the full report-to chain cache with the specified start delay in minutes, refresh interval in minutes, and scheduled refresh time in HH:MM format.

This cache is used to populate the full report-to chain view available in a user's profile. The cache contains the specified number of top employees in the organizational pyramid; it is not intended to store an entry for each profile. It stores the profiles of those people at the top of the chain who are included in many full report-to chain views.

For example:



ProfilesService.enableFullReportsToCache(5, 15, "23:00")

Deletes all event log entries in the EVENTLOG table. This command does not take any arguments.

Deletes event log entries created between the specified start date and end date.

This command takes the following parameters:

startDate
A string that specifies the start date for the period in MM/DD/YYYY format.
endDate
A string that specifies the end date for the period in MM/DD/YYYY format.

For example:



ProfilesService.purgeEventLogsByDates("06/21/2009", "06/26/2009")



This command deletes all the event log entries that were created on or after June 21st, 2009 and before June 26th, 2009 from the EVENTLOG table.

Deletes event log entries with the specified event name that were created between given start date and end date.

This command takes the following parameters:

eventName
The type of event that you want to remove from the EVENTLOG table. The following names are some examples of valid event names:
• profiles.created
• profiles.removed
• profiles.updated
• profiles.person.photo.updated
• profiles.person.audio.updated
• profiles.colleague.created
• profiles.colleague.added
• profiles.connection.rejected
• profiles.person.tagged
• profiles.person.selftagged
• profiles.tag.removed
• profiles.link.added
• profiles.link.removed
• profiles.status.updated
• profiles.wallpost.created
• profiles.wallpost.removed
• profiles.wall.comment.added
  
For a complete list of valid event names for Profiles event log cleaning administrative tasks, refer to the following web page: http://www-10.lotus.com/ldd/lcwiki.nsf/dx/Events_Reference
startDate
A string that specifies the start date for the period in MM/DD/YYYY format.
endDate
A string that specifies the end date for the period in MM/DD/YYYY format.

For example:



ProfilesService.purgeEventLogsByEventNameAndDates(profiles.colleague.created, "06/21/2009", "06/26/2009")



This command deletes all the profiles.colleague.created event log entries that were created on or after June 21st, 2009 and before June 26th, 2009 from the EVENTLOG table.

Creates a background process that runs through the Profiles database and corrects any issues. The command does not take any parameters.

When you run the command, a message is logged to record that the process has started and, after every block of 5000 users has been processed, a check-up message indicates the number of users that have been successfully updated or flags errors in that block of users.

At the end of the process, a message containing information about the total number of users updated, the number of users successfully updated, and the number of users with errors, is logged. The logs contain the UIDs of the users who could not be successfully updated as well as any error messages.

The logs are output to the SystemOut.log file of the IBM WebSphere Application Server node that the MBean connected to. Typically this is the first node defined in the Profiles cluster.

Forces a reload of the full report-to chain cache from the Profiles database. This command does not take any arguments.

Note: If the full report-to cache is disabled, it cannot be reloaded. This command fails when the cache is disabled.

Replaces the existing description text associated with a user's email address with alternate description text enclosed by double quotes.

Description text is information contained on the About Me tab of a user's profile.

For example:



ProfilesService.updateDescription("ann_jones@company.com","This is new text that will be entered into the About Me tab for Ann.")



Note: Rich text cannot be entered with this command.

Replaces the existing experience text associated with a user's email address with alternate text enclosed by double quotes.

Experience is the information contained in the Background area of a user's profile.

For example:



ProfilesService.updateExperience("ann_jones@company.com","This is new text that will be entered into the Background field for Ann.")



Note: Rich text cannot be entered with this command.

Writes the most recent Profiles statistics to a file.

The myStatsFile argument can include the full path and name of the statistics file. Note that the path must be relative to the server hosting the MBean used by this command.

For example:



ProfilesService.writeStatisticsToFile("d:/temp/profilesStats.txt")



Note: Statistics information can also be viewed in a browser using the following URL:

http://<server.company.com>/profiles/html/servermetrics.do

ProfilesService.activateUserByUserId(String user_external_id, <updated_properties_list> )
See Managing user data using Profiles administrative commands for details.

ProfilesService.inactivateUser(String user_email_addr)
See Managing user data using Profiles administrative commands for details.

ProfilesService.inactivateUserByUserId(String userID)
See Managing user data using Profiles administrative commands for details.

ProfilesService.publishUserData(String user_email_addr)
See Managing user data using Profiles administrative commands for details.

ProfilesService.publishUserDataByUserId(String userID)
See Managing user data using Profiles administrative commands for details.

ProfilesService.swapUserAccessByUserId("user_to_activate","user_to_inactivate")
See Managing user data using Profiles administrative commands for details.

ProfilesService.updateUser(String user_email_addr, <updated_properties_list> )
See Managing user data using Profiles administrative commands for details.

ProfilesService.updateUserByUserId(String userID, <updated_properties_list> )
See Managing user data using Profiles administrative commands for details.