Soccnx III - Connections Administration: Understand the challenge ... and find your way how to do it

Connections Administration: Understand the Challenge

... And Find Your Way How To Do It

Otto Foerg Collaboration Solutions Architect

edcom GmbH [email protected]

Felix Binsack General Manager TIMETOACT GmbH [email protected]

Im Mediapark 2 D-50670 Cologne

WWW.TIMETOACT.DE/CAT

TIMETOACT GROUP [email protected] Phone +49 221 97343 0

Social Connections III, 06.22.2012, Dublin: Connections Administration Session

Overview IBM Connections Administration

! General Configuration ! Services ! Notifications ! Language Selector ! Connectivity & SSL

! Feature Configuration ! Scheduled Jobs ! Size limits ! Feature Parameters ! Moderation ! Profile Types ! Object- and Filetypes ! …

! General Administration ! User Management ! Customizing ! Extending & Integration ! Troubleshooting

! Feature Administration ! Members ! Cache & Trash ! Application & Widgets ! Libraries & Policies ! Search Index ! Scheduled Jobs ! …


How Connections Administration Works

! Configuration: ! XML file repository ! 30+ files ! 6,000+ lines of XML ! 425+ parameters

! Changing configurations: ! wsadmin ! Check-out / check-in

procedure ! Manually edit XML files

! wsadmin: ! Case-sensitive command line

administering ! Manually enter commands ! Complex command syntax ! 300+ commands ! Several commands for 1 task ! Variables to transfer values

between commands ! Type conversion for variables ! Copy & paste values from

Connections databases


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)


Connections Administration Summary

! ... Connections has to be administered ! ... Connections administration is not easy ! ... The administrator has to deal with several server systems,

each of them can cause problems ! ... Successful administering & troubleshooting requires

knowledge, experience, good skills – and the right tools ! ... The standard WAS administration tool is ... wsadmin ! ... It often takes a lot of time to find out which

(combination of) command(s) can solve a certain problem


How To Administer Your Connections ?

! Using wsadmin – Your administrator has to be familiar with ! Connections commands ! XML configuration files ! Connections administration procedures ! WebSphere administration techniques

! Using Connections Administration Toolkit (CAT) ! Graphical UI for administration and configuration of Connections ! No wsadmin and XML files handling ! No indepth WebSphere knowledge required ! Eliminates the complexity of Connections administration ! Speeds up handling of administrative tasks ! Unveils the hidden treasures of Connections administration ! Reduces costs of operating Connections and TCO ! Administer Connections from everywhere – even with your iPad ...

Connections Administration Toolkit

Demo ...

KURZER RÜCKBLICK AUF CONNECTIONS 3.0.1

Questions ?

Seite 8


More Informations

! Please visit the CAT web site: ! http://www.timetoact.de/cat

! Contact us via mail: ! [email protected]

! A demoversion of CAT is available on request


Thank You !!

Seite 10

[email protected] [email protected]

www.timetoact.de


Additional Slides

Seite 11


Overview Additional Slides

! Activities ! User Management ! Communities ! Schedulers ! Search Management ! Service Configuration ! Language Selector

! Notification Configuration ! Policies Administration ! Libraries Administration ! Profile Types ! CAT Technical Background ! CAT Team

The CAT User Interface

Add a New Member to an Activity with CAT Step 1: Select Activities ...

! By name

! By type

! By user & role ! Author ! Creator ! Owner ! Reader

! Typeahead implemented for all selection lists in CAT

Several selection

criteria Typeahead

list

Result list according to

selection criteria

Add a New Member to an Activity with CAT Step 2: See the Result List

Metadata of highlighted

activity

Add a New Member to an Activity with CAT Step 3: See Metadata of an highlighted Activity

Members & roles of

highlighted activity

Add a New Member to an Activity with CAT Step 4: Retrieve Current Members & Roles of the Activity

Activities

Specify role(s) for new

member(s)

Add a New Member to an Activity with CAT Step 5: Add New Member(s)

Typeahead makes it easy to identify the right

member(s)

Specify role(s) for new

member(s)

Remove a Member from an Activity with CAT

Select member(s)

to be removed

Click “Remove Member”

Manage Deleted Activities with CAT

Delete an Activity, restore

or purge a deleted Activity

Benefits Activities Management with CAT

! Retrieve all activities without being a member ! Several criteria to select activities ! See all activities created / owned by an particular user ! Typeahead lists make it easy to select activities ! See all metadata of an activity at a glance ! Add or remove members to/from an activity ! Delete an activity ! Restore or purge deleted activities ! Manage all Activities scheduled tasks


Connections User Management with CAT

Seite 22

Overview User Management with CAT

! Inactivate or activate an user in PROFILES or any of the Connections features

! Edit user data including UID in PROFILES if synchronization problems happen

! Associate a returning user with his former content ! Publish user data from PROFILES to feature databases ! Synchronize user data in feature databases

directly with LDAP ! Drop a user from PROFILES to reinstate synchronization for

this user again

User Management with CAT How To Select a User

Several criteria for selection of

users ! Select user by ! E-Mail ! UID ! Display Name ! GUID ! Login ID


Typeahead list

User Management with CAT Perform Several Administrative Tasks in PROFILES

See PROFILES data for the

selected user

Inactivate or activate user

Delete user from PROFILES

Change UID in PROFILES to

the same value as in LDAP

Propagate user data from

PROFILES to feature dbs

User Management with CAT Perform Several Administrative Tasks with Features

Activate or Inactivate an user

in selected feature(s)

See all login values used by the user in the

features

See current state of the user

in features

See the user’s GUID in

features and compare to PROFILES

Synchronize an user’s data in

features directly with LDAP

User Management with CAT Synchronize Complete Feature Databases with LDAP

Benefits User Management with CAT

! See all user related data in all db‘s at a glance ! Solve synchronization problems by simply inactivating and

reactivating a user in PROFILES – this helps in many cases! ! Find out if a user has different GUID‘s in the Connections

dbs and solve any problems by directly synchronizing the user between LDAP and feature db‘s

! After a UID change in LDAP: Give the user the same UID in PROFILES – and he will be synced again

! Delete a user‘s data from PROFILES so that TDI can reimport them from scratch

! Detect whether a user‘s login items are associated with a different user / GUID, preventing the user from accessing the feature - and delete the respective values


Management of Communities with CAT

Seite 29

Overview Communities Management

! Retrieve a Community by several criteria ! Create or delete a Community ! See all metadata of a Community ! Remove an user from all Communities ! Add an alternate owner to Communities owned by an

particular user ! Add or remove members to/from a Community ! Change policy controling a Community‘s file quota

Community Management with CAT How To Select a Community

! Select by type, Community name, tag and UUID

! Select by user & role ! All ! Creator ! Member ! Owner


Several selection

criteria

Typeahead list

Communities Administration Remove a user

from all Communities he

is member of

Add or remove Community

members

Delete a Community

Select all Communities owned by an user and add an alternate

owner

Create a new Community

Associate Community with a different files

quota policy

Benefits Communities Management With CAT

! Retrieve all communities without being a member ! See all restricted communities ! Several criteria to select communities ! See all communities a user is creator / member / owner of ! Typeahead lists make it easy to select communities ! See all metadata of an community at a glance ! Add or remove members / owners to / from a community ! Delete a community ! Remove a user from all communities he is a member of ! Add an alternate owner to communities ! Manage all scheduled tasks in Communities


Management of Connections Schedulers

with CAT

Seite 34

Scheduler Tasks – Managed by wsadmin Getting information about a job

Scheduler Tasks – Managed by CAT Getting Information about a Job

Scheduler Tasks Getting Details about a Job

! Getting details about a task e.g. DatabaseRuntimeStats …

! … using wsadmin

! … using CAT

Scheduler Tasks Changing a Cron scheduler expression - wsadmin

Scheduler Tasks Changing a Cron scheduler expression - CAT

! CAT Cron user interface

! Available in all areas of CAT offering configurable Cron expressions

Benefits Scheduler Management with CAT

! Use the CAT cron job editor to change scheduler settings

! Coming soon: ! Clear schedulers in order to fix scheduler related problems


Search Management with CAT

Seite 41

Overview Search Management with CAT

! Create, edit or delete Search tasks

! Enable / disable Search tasks

! Delete an application‘s index

! Run Search tasks manually

See all Search Tasks and Metadata

List of all Search Tasks

Search Task metadata

Filter Task Type

Edit Search Task Properties

Edit a Search Task

Purge Search Indexes Purge index of

selected features

Delete Search Tasks

Delete a Search Task

Create Search Tasks

Create a new Search Task

Run Search Tasks

Manually run a Search Task

Benefits Search Management with CAT

! See all search tasks and their current status

! Delete search indexes from CAT ! No deleting of search directories on search nodes ! No restarting of search cluster

! Immediately refresh or rebuild search index for all or selected features

! Delete „misbehaving“ search tasks and rebuild them


Some Additional CAT Features

Configure Connections Services

Use “Defaults” line to preconfigure values and copy them to selected

services

Configure Language Selector

Notification Configuration Enable channels, specify sender address

Policies Administration

List of all existing policies

Details of selected policy

Click to edit quota

Create a new policy

Delete selected policies

Administration of File Libraries

! Several selection criteria ! Type of Library

! User ! Community

! Library Name Change library

policy

Specify user or Communities

libraries

Delete a library

Administration of Profile Types

! Set configuration properties for Profile Types

! Activate / deactivate features for different Profile Types

! Set different scopes


CAT Technical Background

CAT – Technical Background (1)

! CAT is a Java™ Enterprise Edition (JEE) Application and uses its own database

! CAT is running on any WebSphere Application Server of the Websphere domain used by Connections

! The CAT database can be configured as ! Derby database on the WebSphere Application Server ! DB2, Oracle or SQL Server database

! The CAT operations rely on: ! Standard IBM Connections configuration files ! Mbeans delivered as part of IBM Connections ! Standard IBM Connections REST API ! IBM Connections databases

CAT – Technical Background (2)

! Access to CAT is protected by standard WebSphere application roles

! CAT works with “RunAs” users to access Mbeans and the REST API ! RunAs credentials configured in preferences and stored encrypted ! No administrative privileges for the Connections administrator on

WebSphere level required if he is using CAT !!

! CAT is developed using IBM Rational Application Developer, Plugins for GWT, Maven and Teamconcert, and the Google™ Web Toolkit

! CAT installation needs less than 1 hour

CAT Preferences

Connections Administration Toolkit Team

! General Manager ! Felix Binsack

! Leader IBM Connections Services ! Otto Förg

! Developers, Quality Assurance ! Olga Belousova ! Florian Mehl ! Georg Kaiser ! Jürgen Weisel-Schmidt ! Susanne Brunner

More Informations

! Please visit the CAT web site: ! http://www.timetoact.de/cat

! Contact us via mail: ! [email protected]

! A demoversion of CAT is available on request

Soccnx III - Connections Administration: Understand the challenge ... and find your way how to do it

Technology

Transcript of Soccnx III - Connections Administration: Understand the challenge ... and find your way how to do it