Connections Administrat ion Toolkit v3 TIMETOACT GROUP Im Mediapark 2 D-50670 Cologne WWW.TIMETOACT.DE/CAT edcom Software & Consulting Baierbrunner Str. 39 D-81379 München www.edcom.de - Technical Workshop for Connections Administrators -
May 11, 2015
Connections Administration Toolkit v3
TIMETOACT GROUP
Im Mediapark 2
D-50670 Cologne
WWW.TIMETOACT.DE/CAT
edcom Software & Consulting
Baierbrunner Str. 39
D-81379 München
www.edcom.de
- Technical Workshop for Connections Administrators -
Page 2
Technical Workshop: Connections Administration Toolkit
Agenda
1. IBM Connections Administration & Configuration
2. CAT Overview
3. General Configuration & Administration
4. Activities
5. Blogs
6. Communities
7. Files
8. Forums
9. User Management
10. Profiles
11. Moderation
12. Wikis
13. Search
14. News
Page 3
Technical Workshop: Connections Administration Toolkit
01. IBM ConnectionsConfiguration & Administration
Page 4
Technical Workshop: Connections Administration Toolkit
IBM Connections Administration Overview
General ConfigurationServicesNotificationsLanguage SelectorConnectivity & SSL
Feature ConfigurationScheduled JobsSize limitsFeature ParametersModerationProfile TypesObject- and Filetypes…
General AdministrationUser ManagementCustomizingExtending & IntegrationTroubleshooting
Feature AdministrationMembersCache & TrashApplication & WidgetsLibraries & PoliciesSearch IndexScheduled Jobs…
Page 5
Technical Workshop: Connections Administration Toolkit
How Connections Administration Works
ConfigurationXML file repository30+ files6,000+ lines of XML425+ parameters
Changing configurationswsadminCheck-out / check-in procedureManually edit XML files
AdministrationMBeansPythonwsadmin commands
wsadmin Case-sensitive command line administeringManually enter commandsComplex command syntax300+ commandsMany commands for 1 taskVariables to transfer values between commandsType conversion for variablesCopy & paste values from Connections databases
Page 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 7
Technical Workshop: Connections Administration Toolkit
Administrative Skills Required
Using wsadmin – Your administrator has to be familiar withConnections commandsXML configuration filesConnections administration proceduresWebSphere administration techniques
Additional skills required forDatabase systemTivoli Directory IntegratorIBM HTTP Server
Certificate management
Proxy
LDAP directory
Page 8
Technical Workshop: Connections Administration Toolkit
Connections Administration Toolkit CATIntuitive Interface for the Connections Administrator
Page 9
Technical Workshop: Connections Administration Toolkit
02. CAT Overview
Page 10
Technical Workshop: Connections Administration Toolkit
Overview
Architecture
Installation
Preferences
CAT Roles
Logging
User Interface
Page 11
Technical Workshop: Connections Administration Toolkit
ConnectionsDatabases
Get Data
CAT DatabaseLogging, Menus,
Preferences
MBeansExecute Commands
REST APIGet and Put Data
Connections XML Files
Change Configuration
CAT Architecture
Page 12
Technical Workshop: Connections Administration Toolkit
CAT Installation Review
Create CAT databaseDB2, Oracle, SQL-Server
Create CAT data sourceScope should be Cell or the WAS server CAT is installed to
Install CAT .earInto any WebSphere application server of your Connections cell
Map users or groups to CAT roles
Enter license key and configuration preferences
Page 13
Technical Workshop: Connections Administration Toolkit
CAT Preferences
REST RunAs User
MBean RunAs User
Deployment ManagerIP or NameSOAP PortBootstrap Port
SMTP Configuration
Page 14
Technical Workshop: Connections Administration Toolkit
CAT Roles
Page 15
Technical Workshop: Connections Administration Toolkit
CAT Logging
Each action is logged
CAT is prompting for comments
Log is stored in CAT database
Different viewsMost recentLast dayLast weekLast month
Page 16
Technical Workshop: Connections Administration Toolkit
CAT User Interface
Page 17
Technical Workshop: Connections Administration Toolkit
03. General Configuration & Administration
Page 18
Technical Workshop: Connections Administration Toolkit
General Configuration
Connections Services
Notifications
Language Selector
Page 19
Technical Workshop: Connections Administration Toolkit
Connections Services
Set for each Connections Application
Enable / DisableSSL enableStandard URLSSL URLInterservice URL
Additional CAT FeaturesCopy values from Defaults line to selected featuresSelect / unselect all features with 1 clickSave and restore a working configuration
Page 20
Technical Workshop: Connections Administration Toolkit
Notification Configuration
Configure for each Notification Event
EnabledSender address to be used
Additional CAT FeaturesCopy values from Defaults line to selected eventsSelect / unselect all events with 1 clickSelect / unselect all events of a Connections application Save and restore a working configuration
Page 21
Technical Workshop: Connections Administration Toolkit
Language Selector
Base ConfigurationEnableSelect languagesSpecify default languageEnable cookieSpecify cookie name and domain
Additional CAT FeaturesSort languages using up and down arrowsMove a language with one click to the top or bottom of the listEnable all languages with one click
Page 22
Technical Workshop: Connections Administration Toolkit
Post Configuration Tasks from ISC
Synchronize all Connections nodes
Should happen automatically
Restart all Connections clusters
Page 23
Technical Workshop: Connections Administration Toolkit
General Administration - Schedulers
SchedulersList All SchedulersClear All Schedulers
BackgroundSolve scheduler related problems by restarting all schedulersSolves many but not all scheduler problemsDo so if Connections documentation or IBM instructs you toRestart of all Connections clusters required
Page 24
Technical Workshop: Connections Administration Toolkit
04. Activities
Page 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 26
Technical Workshop: Connections Administration Toolkit
Activities – Manage: Overview
Filter activities
Manage a list of selected activities
Manage a single activity
Page 27
Technical Workshop: Connections Administration Toolkit
Filter Activities By ...
TypeCompletedDeletedOrphanedTemplateOpen
UserAuthorCreatorOwnerReaderAll roles
Name
Start / end date
Tags
UUID
Result list sortable by several criteria
Clear filter to initiate a new search
Page 28
Technical Workshop: Connections Administration Toolkit
Activities Filter
Page 29
Technical Workshop: Connections Administration Toolkit
Manage a List of Activities
Export
Delete
Restore
Purge
Add Member
Remove Member
Note pagination controls
Page 30
Technical Workshop: Connections Administration Toolkit
Manage a Single Activity
Info – TabAll meta data
Member ManagementSearch for a member Add member(s)Remove member(s)Change role assignment
Page 31
Technical Workshop: Connections Administration Toolkit
Members of a Community Activity
Membership androle assignmentare controlled bythe community
Do not change membership or role assignmentwith CAT
Page 32
Technical Workshop: Connections Administration Toolkit
05. Blogs
Page 33
Technical Workshop: Connections Administration Toolkit
Blogs – Configure
General
Rendering
Comment and Trackback
Upload Capability
Theme
Page 34
Technical Workshop: Connections Administration Toolkit
Blogs – Manage: Overview
Filter blogs
Manage a list of selected blogs
Manage a single blog
Page 35
Technical Workshop: Connections Administration Toolkit
Filter Blogs By ...
Name
UserAuthorDraftOwnerAll roles
Tags
UUID
Result list sortable by several criteria
Page 36
Technical Workshop: Connections Administration Toolkit
Manage a List of Blogs
Delete selected blogs
Page 37
Technical Workshop: Connections Administration Toolkit
Manage a Single Blog
Info – Tab
Member ManagementList all membersSearch for a member in the list
Add or remove ofmembers not yetimplemented
Page 38
Technical Workshop: Connections Administration Toolkit
06. Communities
Page 39
Technical Workshop: Connections Administration Toolkit
Communities – Configure
Description summary size
Hide Start a Community button from unauthenticated users
Rendering parameters
Page 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 41
Technical Workshop: Connections Administration Toolkit
Filter Communities By ...
TypeAllSubcommunitiesPublic CommunitiesModerated CommunitiesRestricted CommunitiesOrphaned Communities
Name
UserAll RolesCreatorMemberOwner
Tags
UUID
Sort result list by several criteria
Page 42
Technical Workshop: Connections Administration Toolkit
General Manage Communities
Create a Community
Add alternate Owner
Remove a User from all Communities
Page 43
Technical Workshop: Connections Administration Toolkit
Manage a List of Communities
Change Name
Change Description
Delete Community
Page 44
Technical Workshop: Connections Administration Toolkit
Manage a Single Community (1)
Info – TabAll meta data
Member ManagementSearch for a member in the listAdd / Remove member(s)Refresh member(s)
Page 45
Technical Workshop: Connections Administration Toolkit
Manage a Single Community (2)
TagsAdd / Delete tags
PolicySee current usageAssign different policy
Page 46
Technical Workshop: Connections Administration Toolkit
07. Files
Page 47
Technical Workshop: Connections Administration Toolkit
Files – Configure (1)
ConfigureUser InterfaceCachingUploadsRepository
Mime types
Restricted file types
Object types
Page 48
Technical Workshop: Connections Administration Toolkit
Files – Configure (2)
Page 49
Technical Workshop: Connections Administration Toolkit
Files – Configure (3)
Scheduled Tasks
File Restrictions
Media Object Types
Mime Types
Page 50
Technical Workshop: Connections Administration Toolkit
Files – Manage - Libraries: Overview
Filter libraries
Delete libraries
Manage a library
Page 51
Technical Workshop: Connections Administration Toolkit
Filter Files Libraries
Filter libraries byType
Personal
Community
Orphaned
TitleLibrary IDOwner IDPolicy
Specify Sort By ParameterTitleLast UpdateSizeCreated Date
Page 52
Technical Workshop: Connections Administration Toolkit
Delete Libraries
Select libraries
Click Delete Libraries
Page 53
Technical Workshop: Connections Administration Toolkit
Library Meta Data
Click on magnifier icon for library
Info Tab contains all meta data
Page 54
Technical Workshop: Connections Administration Toolkit
Assign Different Policy To A Library
Select Policy Tab
Select Policy from dropbox
Page 55
Technical Workshop: Connections Administration Toolkit
Files – Manage – Policies
Filter policies byNamePolicy IDSpecify Sort By parameter
Create a new policy
Delete policies from result list
Edit a policies Maximum Size in result list
Page 56
Technical Workshop: Connections Administration Toolkit
08. Forums
Page 57
Technical Workshop: Connections Administration Toolkit
Forums – Configure
Manage forums uploads
Configure schedulers
Page 58
Technical Workshop: Connections Administration Toolkit
Forums – Manage: Overview
Filter Forums byNameCreator or ModifierStateNodeUUIDType
Result display: Sortable result list Hierarchical tree
Page 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 60
Technical Workshop: Connections Administration Toolkit
Manage a Single Forum
Info – Tab : Forums DetailsTypeStateDescriptionLevel…
Members overview (searchable list)
Page 61
Technical Workshop: Connections Administration Toolkit
09. User Management
Page 62
Technical Workshop: Connections Administration Toolkit
TDI
Recap: User Data Architecture
LDAP
DN
CN
UID
E-M
ail
Lo
gin
ID ..
.
GU
ID
UID: - Ex LDAP- Key between LDAP & Profiles
- Has to be unique
- Don‘t change
- Mapping configurable
GUID: - Ex LDAP
- Key between Profiles & Features
- Has to be unique
- Changes are synchronized
- Mapping configurable
UUID: - Unique Object ID in Feature DBs
- Different in feature databases
Login - Ex LDAPItems: - Associated with the users UUID
- Cannot be incorporated by other users
Login ID, E-Mail und UID:
Configurable for Connections authentication
UU
ID
Nam
e
E-M
ail
Lo
gin
ID UID
GU
ID
Sta
te
PROFILES
Lo
gin
It
em
s
UU
ID
Nam
e
E-M
ail
FEATURE
GU
ID
Sta
te
Lo
gin
It
em
s
UU
ID
Nam
e
E-M
ail
FEATURE
GU
ID
Sta
te
Lo
gin
It
em
s
Page 63
Technical Workshop: Connections Administration Toolkit
User Management – By User: Overview
Filter users by E-MailUIDDisplay NameGUIDLogin IDTagsType
Manage multiple usersManage tagsDelete users from Profiles
Manage a single user:Open details with magnifierTabs for Profiles and Features
Page 64
Technical Workshop: Connections Administration Toolkit
Manage Multiple Users
Delete usersSelect usersClick Delete selected Users
TaggingSelect usersAdd or remove tags
Page 65
Technical Workshop: Connections Administration Toolkit
User Management – By User
„Profiles“ TabAll user meta data from PROFILES dbToggle Inactivate / ActivatePublish Data
Edit UserSwap GUIDPrintDelete UserChange UID
Page 66
Technical Workshop: Connections Administration Toolkit
User Management – By User
„Features“ TabUser meta data from feature db‘sActivate User
Inactivate UserSync with DirectorySwap GUIDCheck for Duplicates
Page 67
Technical Workshop: Connections Administration Toolkit
User Management – By User
„Tags“ TabAdd TagsRemove TagsReplace Tags
Page 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 matchClick Sync Selected with DirectoryPlease note: This can take a while
Page 69
Technical Workshop: Connections Administration Toolkit
10. Profiles
Page 70
Technical Workshop: Connections Administration Toolkit
Profiles Configuration
Advanced
Statistics
Object Cache
User Interface
Full Reports-To Cache
Page 71
Technical Workshop: Connections Administration Toolkit
Profiles Advanced Configuration
Page 72
Technical Workshop: Connections Administration Toolkit
Profiles Configuration
Statistics Object Cache
User Interface Full Reports-To Cache
Page 73
Technical Workshop: Connections Administration Toolkit
Profile Types Configuration
Select property
Enable / disable property for profile types
Select scopeSelf: Profile owner onlyColleagues: Members of profile owners networkPerson: People with the person role in the Profiles appNone
Page 74
Technical Workshop: Connections Administration Toolkit
11. Moderation
Page 75
Technical Workshop: Connections Administration Toolkit
Recap Moderation
Moderation TypesPre-Publishing WorkflowPost-Publishing Workflow
Applications with Content ModerationBlogs inside / outside CommunitiesFiles inside / outside CommunitiesForums only inside Communities
Page 76
Technical Workshop: Connections Administration Toolkit
Recap Moderation Roles
Global ModerationModerators for all Blogs, Forums, Community-FilesJEE Role global-moderator in Blogs / Foren / CommunitiesPlus: JEE Rolle global-moderator in ModerationCentralized Moderation Interface (=> On top of Connections UI)
Owner ModerationModerators of their Blogs, Community-Files and ForumsMust be owner Configured in contentreview-config.xmlOwner can publish without approvalCommunity Actions > Moderate Community
Page 77
Technical Workshop: Connections Administration Toolkit
Moderation Overview
Configure Moderation for
BlogsFilesForums
Flag Categories
Page 78
Technical Workshop: Connections Administration Toolkit
Flag Categories
CategoriesCreateEditDelete
LabelsEnter description in different languagesSelect language and click Apply Filter
Page 79
Technical Workshop: Connections Administration Toolkit
Blogs Moderation
Select category
Configure reviewers
Page 80
Technical Workshop: Connections Administration Toolkit
Community-Files Moderation
Page 81
Technical Workshop: Connections Administration Toolkit
Forums Moderation
Select category
Configure reviewers
Page 82
Technical Workshop: Connections Administration Toolkit
12. Wikis
Page 83
Technical Workshop: Connections Administration Toolkit
Wikis – Configure (1)
ConfigureUser InterfaceCachingUploadsRepository
Mime types
Restricted file types
Object types
Page 84
Technical Workshop: Connections Administration Toolkit
Wikis – Configure (2)
Page 85
Technical Workshop: Connections Administration Toolkit
Wikis – Configure (3)
Scheduled Tasks
File RestrictionsMime Types
Page 86
Technical Workshop: Connections Administration Toolkit
Wikis – Manage: Overview
Filter wikis
Set policy
Delete wiki
Export wiki meta data
Page 87
Technical Workshop: Connections Administration Toolkit
Wikis – Manage: Details
Page 88
Technical Workshop: Connections Administration Toolkit
Wikis – Manage - Policies
Filter policies byNamePolicy IDSpecify Sort By parameter
Create a new policy
Delete policies from result list
Edit a policies Maximum Size from result list
Page 89
Technical Workshop: Connections Administration Toolkit
Assign Different Policy To A Wiki
Select Policy Tab
Select Policy from dropbox
Page 90
Technical Workshop: Connections Administration Toolkit
13. Search
Page 91
Technical Workshop: Connections Administration Toolkit
Search - Configuration
Attachment handling
Max. attachment size
Cache file size
Max. cache entries
Cache expiry time
Max. concurrent downloads
Max. temp dir size
Download throttle
Language sensitivity
Max. crawler threads
Backup type
Post backup script
Page 92
Technical Workshop: Connections Administration Toolkit
Search - Manage
GeneralAdd Search TaskRun Search TaskInclude/Exclude User from SaND Recommendations
Filter Search tasks by typeAllBackup TaskFile Content TaskIndexing TaskOptimize TaskSAND Task
Manage selected tasksEdit TaskPurge IndexDelete Task
Page 93
Technical Workshop: Connections Administration Toolkit
Filter Search Tasks
Page 94
Technical Workshop: Connections Administration Toolkit
Search Tasks: Details & Manage
Page 95
Technical Workshop: Connections Administration Toolkit
Execute Search Task Now
Page 96
Technical Workshop: Connections Administration Toolkit
Create New Search Task
Page 97
Technical Workshop: Connections Administration Toolkit
Add / Remove User from Recommendations
Page 98
Technical Workshop: Connections Administration Toolkit
14. News
Page 99
Technical Workshop: Connections Administration Toolkit
Configure News
Page 100
Technical Workshop: Connections Administration Toolkit
Questions ?