Simplify the administration of IBM Connections with this easy to install and easy to use web interface tool. Complex multilevel administration commands can be done with just a single click, even by administrators without WebSphere background.
Easily accelerate and automate administrative tasks and enhance the maintenance tasks for IBM Connections. Benefit from extremely lowered effort for training and maintenance.
4. Technical Workshop: Connections Administration Toolkit
IBM Connections Administration Overview
General Configuration General Administration
Services User Management
Notifications Customizing
Language Selector Extending & Integration
Connectivity & SSL Troubleshooting
Feature Configuration Feature Administration
Scheduled Jobs Members
Size limits Cache & Trash
Feature Parameters Application & Widgets
Moderation Libraries & Policies
Profile Types Search Index
Object- and Filetypes Scheduled Jobs
… …
Page 4
5. Technical Workshop: Connections Administration Toolkit
How Connections Administration Works
Configuration wsadmin
XML file repository Case-sensitive command line
30+ files administering
6,000+ lines of XML Manually enter commands
425+ parameters Complex command syntax
300+ commands
Changing configurations
Many commands for 1 task
wsadmin
Variables to transfer values
Check-out / check-in procedure
between commands
Manually edit XML files
Type conversion for variables
Administration Copy & paste values from
MBeans Connections databases
Python
wsadmin commands
Page 5
6. Technical Workshop: Connections Administration Toolkit
wsadmin Example:
Add a New Member to an Activity
1. Start wsadmin command line environment:
wsadmin –lang jython –user <wasadmin> -password <password>
2. Load Activities Python Script:
execfile("activitiesAdmin.py")
3. Store the new member into a temporary variable:
newMember=ActivitiesMemberService.fetchMemberByName(“John Doe”)
4. Store the activity into a tempory variable:
act=ActivityService.fetchActivityById
*)
("FFFGc66a55370a2c423eafa5bd0a4b443a70”)
*) Additional operations required to get the UUID of the activity
5. Convert the variables from “hash” to “vector”:
from java.util import Vector
newMemberVec = Vector()
newMemberVec.add(newMember)
actVec = Vector()
ActVec.add(act)
6. Add the new member to the activity:
AccessControlService.setMembersAccess(actVec,newMemberVec)
Page 6
7. Technical Workshop: Connections Administration Toolkit
Administrative Skills Required
Using wsadmin – Your administrator has to be familiar with
Connections commands
XML configuration files
Connections administration procedures
WebSphere administration techniques
Additional skills required for
Database system
Tivoli Directory Integrator
IBM HTTP Server
Certificate management
Proxy
LDAP directory
Page 7
8. Technical Workshop: Connections Administration Toolkit
Connections Administration Toolkit CAT
Intuitive Interface for the Connections Administrator
Page 8
11. Technical Workshop: Connections Administration Toolkit
CAT Architecture
Connections XML
Files Connections
MBeans Change Configuration
Databases
Execute Commands
Get Data
REST API CAT Database
Logging, Menus,
Get and Put Data
Preferences
Page 11
12. Technical Workshop: Connections Administration Toolkit
CAT Installation Review
Create CAT database
DB2, Oracle, SQL-Server
Create CAT data source
Scope should be Cell or the WAS server CAT is installed to
Install CAT .ear
Into any WebSphere application server of your Connections cell
Map users or groups to CAT roles
Enter license key and configuration preferences
Page 12
13. Technical Workshop: Connections Administration Toolkit
CAT Preferences
REST RunAs User
MBean RunAs User
Deployment Manager
IP or Name
SOAP Port
Bootstrap Port
SMTP Configuration
Page 13
15. Technical Workshop: Connections Administration Toolkit
CAT Logging
Each action is logged
CAT is prompting for
comments
Log is stored in CAT
database
Different views
Most recent
Last day
Last week
Last month
Page 15
18. Technical Workshop: Connections Administration Toolkit
General Configuration
Connections Services
Notifications
Language Selector
Page 18
19. Technical Workshop: Connections Administration Toolkit
Connections Services
Set for each Connections
Application
Enable / Disable
SSL enable
Standard URL
SSL URL
Interservice URL
Additional CAT Features
Copy values from Defaults line
to selected features
Select / unselect all features
with 1 click
Save and restore a working
configuration
Page 19
20. Technical Workshop: Connections Administration Toolkit
Notification Configuration
Configure for each
Notification Event
Enabled
Sender address to be used
Additional CAT Features
Copy values from Defaults line
to selected events
Select / unselect all events
with 1 click
Select / unselect all events of
a Connections application
Save and restore a working
configuration
Page 20
21. Technical Workshop: Connections Administration Toolkit
Language Selector
Base Configuration
Enable
Select languages
Specify default language
Enable cookie
Specify cookie name and
domain
Additional CAT Features
Sort languages using up and
down arrows
Move a language with one
click to the top or bottom of the
list
Enable all languages with one
click
Page 21
22. Technical Workshop: Connections Administration Toolkit
Post Configuration Tasks from ISC
Synchronize all
Connections nodes
Should happen
automatically
Restart all
Connections clusters
Page 22
23. Technical Workshop: Connections Administration Toolkit
General Administration - Schedulers
Schedulers
List All Schedulers
Clear All Schedulers
Background
Solve scheduler related
problems by restarting all
schedulers
Solves many but not all
scheduler problems
Do so if Connections
documentation or IBM
instructs you to
Restart of all Connections
clusters required
Page 23
25. Technical Workshop: Connections Administration Toolkit
Activities – Configure - Schedulers
One tab for each Scheduler
of an Connections
application
Current configuration
Get current status with
Get Details
Pause or Resume a
scheduler
Change Cron configuration
Do NOT change the Scope
Page 25
26. Technical Workshop: Connections Administration Toolkit
Activities – Manage: Overview
Filter activities
Manage a list of selected activities
Manage a single activity
Page 26
27. Technical Workshop: Connections Administration Toolkit
Filter Activities By ...
Type Name
Completed Start / end date
Deleted
Orphaned
Tags
Template UUID
Open
User Result list sortable by
Author several criteria
Creator
Owner
Reader Clear filter to initiate a new
All roles search
Page 27
29. Technical Workshop: Connections Administration Toolkit
Manage a List of Activities
Export
Delete
Restore
Purge
Add Member
Remove Member
Note pagination
controls
Page 29
30. Technical Workshop: Connections Administration Toolkit
Manage a Single Activity
Info – Tab
All meta data
Member Management
Search for a member
Add member(s)
Remove member(s)
Change role assignment
Page 30
31. Technical Workshop: Connections Administration Toolkit
Members of a Community Activity
Membership and Do not change
role assignment membership or
are controlled by role assignment
the community with CAT
Page 31
33. Technical Workshop: Connections Administration Toolkit
Blogs – Configure
General
Rendering
Comment and Trackback
Upload Capability
Theme
Page 33
34. Technical Workshop: Connections Administration Toolkit
Blogs – Manage: Overview
Filter blogs
Manage a list of selected blogs
Manage a single blog
Page 34
35. Technical Workshop: Connections Administration Toolkit
Filter Blogs By ...
Name Tags
User UUID
Author Result list sortable by
Draft several criteria
Owner
All roles
Page 35
37. Technical Workshop: Connections Administration Toolkit
Manage a Single Blog
Info – Tab
Member Management
List all members
Search for a member
in the list
Add or remove of
members not yet
implemented
Page 37
39. Technical Workshop: Connections Administration Toolkit
Communities – Configure
Description summary size
Hide Start a Community
button from unauthenticated
users
Rendering parameters
Page 39
40. Technical Workshop: Connections Administration Toolkit
Communities – Manage: Overview
Filter communities
General manage communities
Manage a list of selected communities
Manage a single community
Page 40
41. Technical Workshop: Connections Administration Toolkit
Filter Communities By ...
Type User
All All Roles
Subcommunities Creator
Public Communities Member
Moderated Communities Owner
Restricted Communities Tags
Orphaned Communities
UUID
Name
Sort result list by several
criteria
Page 41
42. Technical Workshop: Connections Administration Toolkit
General Manage Communities
Create a Community
Add alternate Owner
Remove a User from all Communities
Page 42
43. Technical Workshop: Connections Administration Toolkit
Manage a List of Communities
Change Name Delete Community
Change Description
Page 43
44. Technical Workshop: Connections Administration Toolkit
Manage a Single Community (1)
Info – Tab Member Management
All meta data Search for a member in the list
Add / Remove member(s)
Refresh member(s)
Page 44
45. Technical Workshop: Connections Administration Toolkit
Manage a Single Community (2)
Tags
Add / Delete tags
Policy
See current usage
Assign different policy
Page 45
51. Technical Workshop: Connections Administration Toolkit
Filter Files Libraries
Filter libraries by Specify Sort By Parameter
Type Title
Personal Last Update
Community Size
Orphaned Created Date
Title
Library ID
Owner ID
Policy
Page 51
53. Technical Workshop: Connections Administration Toolkit
Library Meta Data
Click on magnifier icon for
library
Info Tab contains all meta
data
Page 53
54. Technical Workshop: Connections Administration Toolkit
Assign Different Policy To A Library
Select Policy Tab
Select Policy from dropbox
Page 54
55. Technical Workshop: Connections Administration Toolkit
Files – Manage – Policies
Filter policies by
Name
Policy ID
Specify Sort By parameter
Create a new policy
Delete policies from result
list
Edit a policies Maximum
Size in result list
Page 55
58. Technical Workshop: Connections Administration Toolkit
Forums – Manage: Overview
Filter Forums by Result display:
Name Sortable result list
Creator or Modifier Hierarchical tree
State
NodeUUID
Type
Page 58
59. Technical Workshop: Connections Administration Toolkit
Forums – Filter - Results
Flat View Hierarchical View
Export displayed result list as CSV file.
Delete selected forums, topics, replies
Page 59
60. Technical Workshop: Connections Administration Toolkit
Manage a Single Forum
Info – Tab : Forums Details Members overview
Type (searchable list)
State
Description
Level
…
Page 60
62. Technical Workshop: Connections Administration Toolkit
Recap: User Data Architecture
UID: - Ex LDAP
- Key between LDAP & Profiles
LDAP
- Has to be unique
E-Mail
GUID
Login
UID
- Don‘t change
DN
CN
ID
...
- Mapping configurable
GUID: - Ex LDAP
- Key between Profiles & Features
- Has to be unique
TDI
- Changes are synchronized
- Mapping configurable FEATURE
UUID: - Unique Object ID in Feature DBs
E-Mail
Name
GUID
Login
Items
UUID
State
- Different in feature databases
Login - Ex LDAP
PROFILES
Items: - Associated with the users UUID
E-Mail
Name
GUID
Login
Login
Items
UUID
- Cannot be incorporated by other
State
UID
ID
users
FEATURE
Login ID, E-Mail und UID:
E-Mail
Name
GUID
Login
Items
UUID
State
Configurable for Connections authentication
Page 62
63. Technical Workshop: Connections Administration Toolkit
User Management – By User: Overview
Filter users by
E-Mail
UID
Display Name
GUID
Login ID
Tags
Type
Manage multiple users
Manage tags
Delete users from Profiles
Manage a single user:
Open details with magnifier
Tabs for Profiles and Features
Page 63
65. Technical Workshop: Connections Administration Toolkit
User Management – By User
„Profiles“ Tab Edit User
All user meta data from Swap GUID
PROFILES db Print
Toggle Inactivate / Activate Delete User
Publish Data Change UID
Page 65
66. Technical Workshop: Connections Administration Toolkit
User Management – By User
„Features“ Tab Inactivate User
User meta data from feature Sync with Directory
db‘s Swap GUID
Activate User Check for Duplicates
Page 66
67. Technical Workshop: Connections Administration Toolkit
User Management – By User
„Tags“ Tab
Add Tags
Remove Tags
Replace Tags
Page 67
68. Technical Workshop: Connections Administration Toolkit
User Management – By Feature
Sync member data of all users in selected
feature database(s) with LDAP
Select feature(s)
Confirm update on email / login id match
Click Sync Selected with Directory
Please note: This can take a while
Page 68
72. Technical Workshop: Connections Administration Toolkit
Profiles Configuration
Statistics Object Cache
User Interface Full Reports-To Cache
Page 72
73. Technical Workshop: Connections Administration Toolkit
Profile Types Configuration
Select property Select scope
Enable / disable property for Self: Profile owner only
profile types Colleagues: Members of
profile owners network
Person: People with the
person role in the Profiles app
None
Page 73
76. Technical Workshop: Connections Administration Toolkit
Recap Moderation Roles
Global Moderation
Moderators for all Blogs, Forums, Community-Files
JEE Role global-moderator in Blogs / Foren / Communities
Plus: JEE Rolle global-moderator in Moderation
Centralized Moderation Interface
(=> On top of Connections UI)
Owner Moderation
Moderators of their Blogs, Community-Files and Forums
Must be owner
Configured in contentreview-config.xml
Owner can publish without approval
Community Actions > Moderate Community
Page 76
77. Technical Workshop: Connections Administration Toolkit
Moderation Overview
Configure Moderation Flag Categories
for
Blogs
Files
Forums
Page 77
78. Technical Workshop: Connections Administration Toolkit
Flag Categories
Categories Labels
Create Enter description in different
Edit languages
Delete Select language and click
Apply Filter
Page 78
88. Technical Workshop: Connections Administration Toolkit
Wikis – Manage - Policies
Filter policies by
Name
Policy ID
Specify Sort By parameter
Create a new policy
Delete policies from result list
Edit a policies Maximum Size from result list
Page 88
89. Technical Workshop: Connections Administration Toolkit
Assign Different Policy To A Wiki
Select Policy Tab
Select Policy from dropbox
Page 89