WebSphere Everyplace Access Intelligent Notification Server
 

This web page describes an end to end process for configuring INS to perform RSS subscriptions, Sametime, and Stock Notifications. Some parts of these instructions are not necessary for these individual functions, but all information is included to be comprehensive.

Note that some web browsers are hard headed, and you might need to log off and back on, or in some cases maybe even kill the browser and restart it and re-login.

The Information Center for this and other WEA components are available after your installation by using the URL "http://(yourmachinename)/WEAInfo/en/InfoCenter/index.html".

Installation of INS creates three log files in the "<install directory>/install" directory, "log.txt", "createdb.log", and "ldapmodify.log".

When you install the Intelligent Notification Server (INS), when logging into WEA as administrator, there will be an additional page group in the WEA Home set of portlet groups.

In the WebSphere Administration Console there will be the web application server "Everyplace Recent Alert Server", as well as 2 enterprise application "INSPortlet_WPS_PA" and "RecentAlertWebService". There will also be 2 Resources "JDBC Providers" created, "RA DB Driver" and "INS DB Driver".
 

Starting INS Servers on AIX

1) After your installation,  in the WAS Admin Console, the "Everyplace Recent Alert Server" should reflect that it is running.

2) You will need to log off your current AIX session and log in again to cause the INS environment variables to be properly set for the following operations.

3) From the AIX command prompt, assure the "db2jd  6789" process is running (i.e. "ps -ef | grep 6789"). If it is not running switch users to the appropriate
database instance (i.e. "su - wasinst")  and execute the DB2 Java start command with the appropriate parameter (i.e. "db2jstrt  6789").

4)  You will need to run some additional utilities from an AIX command prompt. In the directory "/usr/WebSphere/INS/bin", run the script "startADM" including as the only parameter your machine name ("./startADM wea2aix1", or "./startADM wea2aix1  2>&1 | tee /Steves.startADM.log" to also log to a logging file "/Steves.startADM.log"), and in another AIX window, run the script "startHA" or "./startHA 2>&1 | tee /Steves.startHA.log" to also log to a logging file "/Steves.startHA.log"). Both of these windows will be tied up by the invoking of these scripts (which start the corresponding server).
 
 

Starting INS Servers on Windows

1)  After your installation,  in the WAS Admin Console, the "Everyplace Recent Alert Server" should reflect that it is running.

2)  You will need to run some additional utilities. From the Windows Start menu select "Programs", "IBM Intelligent Notification Services", and "Start Administration Component".

3)  Also from the Windows Start menu select "Programs", "IBM Intelligent Notification Services", and "StartHA".
 
 
 

Starting Remaining Servers

1)  Once you have completed the starting of the above servers, you can go to a browser, connect to your portal  (i.e. "http://localhost/wps/portal"), and login as the admininstrator (i.e. "wpsadmin" with password "wpsadmin")

2)  Select the "Intelligent Notification" page group, and in the "Administration", "Manage Servers" link, click the "Run all servers" link. This will start additional servers, which will be reflected by their status changing to "Running".

Note: You can start these servers manually via the command line, but each will tie up the corresponding window you started them in.

The following are the various servers which INS might need to communicate with, dependant upon what servers
you wish to administer.
 

Administration server (ADM)                     ./startADM <hostname>
Host administration component (HA):         ./startHA
    (on each component host machine)
Directory Services Engine (DSE)                ./startDSE <hostname>
User Privacy Manager (UPM)                    ./startUPM <hostname>
Secure Context Server (SCS)                     ./startSCS <hostname>
Universal Notification Dispatcher (UND)    ./startUND <hostname>
Services Preference Manager (SPM)          ./startSPM <hostname>
Trigger Manager (TM)                                ./startTM <hostname>
Sametime Server (SAM)                             ./startSAM <hostname>
 
 

Generic Configuration for Microsoft Exchange

1) Log on to WebSphere Portal as an administrative user (i.e "wpsadmin").

2) Select "Portal Administration" tab.

3) In the left frame, under the "Security" section, click "Credential Vault".

4) In the "Credential Vault" portlet, click "Add a vault slot".

5) In the "Credential Vault" portlet, in the "Create a vault slot" "Name" field, enter the name of your vault slot (i.e. "ThatVault"), then click "OK".

6) Select "WEA Home" tab, and then click the "Exchange" tab.

7) In the "Microsoft Exchange Mail" portlet, click on the wrench icon to add a vault slot to it's configuration.

8) In the "Microsoft Exchange Mail" portlet, select the appropriate vault slot (i.e. "ThatVault"), then click "OK".

9) In the "Microsoft Exchange Mail" portlet, click on the pencil icon to edit it's configuration.

In the following fields enter the associated value:

   Field                                           Value
Select version:                    (select "Use Exchange 2000")
Server name:                      abe.raleigh.ibm.com (or whatever your server is)
User name:                         (enter your user name, i.e. "shayden")
Password:                          (enter your password, i.e. "shayden")
Mailbox alias:                     (enter your user name, i.e. "shayden")
Domain:                              abe.raleigh.ibm.com
Exchange Email address:     shayden@abe.raleigh.ibm.com
 
 

Then click "OK". If there are any emails in your inbox on abe.raleigh.ibm.com, they should now be displayed and available for viewing from this panel. If you want you can go ahead and perform steps 7-9 for Microsoft Exchange Contacts, Microsoft Exchange Notes, Microsoft Exchange Calendar, and Microsoft Exchange Tasks.
 
 
 
 

Configuring INS For General Usage

For all scenarios, create user(s) and add them to group "INSUsersGroup", and assure all INS servers are running (for starting servers see "Starting INS Servers on AIX" or "Starting INS Servers on Windows" and "Starting Remaining Servers".
 

Create the Intelligent Notification User Group INSUsersGroup

For a normal installation, this will already be done, proceed to Configuring INS User Group Users must be members of INSUsersGroup in order to use Intelligent Notification Services. INSUsersGroup is used to set portlet permissions for all Intelligent Notification users. Create the group, INSUsersGroup with the following steps.

1) Log on to WebSphere Portal as an administrative user (i.e "wpsadmin").

2) Select "Portal Administration" tab.

3) In the left frame, under the "Users and Groups" item, click on "Manage Groups".

5) Type "INSUsersGroup" into the Group name field, then click "Create group".
 
 

Configuring INS User Group

1) Logon to the wps/portal as "wpsadmin" with password "wpsadmin".

2) Select the "Portal Administration" portlet group.

3) In the left frame, under the "Security" item, select "Access Control List".

4) In the "Access Control List" portlet, to the right of the "Selected users and groups" option, click on "Get groups and users".

5) Select the "Search for users" radio button, type an "*" in the "Name is" field and click "Go".

6) In the "Search results" section, select "wps admin (wpsadmin) -- user" and click "Add to list", then click "OK".

7) In the "Select the object for their permissions" field, select "user groups", then click "Go".

8) In the right portion of the panel, for "InsUsersGroup", select "Manage" and "Delegate" permissions then click "Save".
 
 

Configuring Gateway For Mail

1) Select the "Intelligent Notification" portlet group.

2) Select "Administration" tab, and in the left frame, select "Configure Gateways".

3) In "Configure Gateway" panel, select "Mail" and click "Edit".

4) In the "Hostname" field, enter the fully qualified name of your mail server (i.e. "yucca.raleigh.ibm.com").

5) For the remaining fields accept the default and click "OK".

Note: in WEA 4.21 you had to - Select "Administration" tab, and select "Manage Servers".  Click "Force stop all servers", let them stop, then click "Run All Servers".
 
 

Configuring Gateway For Sametime

1) Select the "Intelligent Notification" portlet group.

2) Select "Administration" tab, and in the left frame, select "Configure Gateways".

3) In "Configure Gateway" panel, select "Sametime" and click "Edit".

4) In the "Hostname" field, enter the fully qualified name of your Sametime server (i.e. "rushtest52.raleigh.ibm.com").

Need to create 2 users on your Sametime Server!

5) For the "User ID" and "Password" field, enter "shaydenfeeder", and click "OK". (Max retries = 1 and Retry interval = 30 seconds)

Note: in WEA 4.21 you had to - Select "Administration" tab, and select "Manage Servers".  Click "Force stop all servers", let them stop, then click "Run All Servers".
 
 

Configure Delivery Channel for SNMP (mail)

1) Select the "Intelligent Notification" portlet group.

2) Select "My Delivery Channels" tab.

3) In the right frame "SMTP mail delivery channels", click "Add delivery channel".

4) In the "Delivery channel name" field, enter the name of your channel (i.e. "StevzMale"), in the "E-mail address" field, enter your email address on your mail server (i.e "shayden@abe.raleigh.ibm.com"), then click "OK".
 
 

Configure Delivery Channel for Message Center

1) Select the "Intelligent Notification" portlet group.

2) Select "My Delivery Channels" tab.

3) In the right frame "Message delivery channels", click "Add delivery channel".

4) In the "Delivery channel name" field, enter the name of your channel (i.e. "StevzMS"), then click "OK".
 
 

Create the Intelligent Notification Users In INSUsersGroup

Create and add users to INSUsersGroup using the following steps.

1) You should be logged on to WebSphere Portal as an administrative user (i.e "wpsadmin").

2) Select "Portal Administration" tab.

3) In the left frame, under the "Users and Groups" item, click "Manage Users".

4) In the "Manage Users" portlet, on the right side, click "Create new user".

5) In the following fields, enter the following values:

  Field                         Value

User ID:                    insuser1
Password:                 insuser1
Confirm Password:    insuser1
First Name:               INS
Last Name:               User1
Email:                        insuser1@us.ibm.com

Then click "OK". If you wish to add other users, create them now using the same process (i.e. "insuser2", etc.)

6) In the left frame, click "Manage Groups".

7) Type an asterisk in the "Search for groups" field, then click "Get groups".

8) In the list of User Groups displayed, select "INSUsersGroup" from the list and click "Membership".

9) On the "Manage User Groups" portlet, in the "Add users to group:" field, enter an "*", then click "Go".

10) In the "Search Results" list, select the "wpsadmin" and click "Add to group" then click "OK" (perform this same operation for all users you created "insuser1", "insuser2", etc.).

Note: Once a user is a member of INSUsersGroup, they are considered and Intelligent Notification user. They have access to the Intelligent Notification portlets for which INSUsersGroup has permissions set. Performe the next step to associate each user to INS.

11) Log off as the administratation user "wpsadmin", and then log back on as one of the users you just created. Once you have logged on, you should see the "Intelligent Notification" tab, click it, wait until the web page is painted, then logoff. Repeat for all INS users you have added. The act of logging on and clicking the Intelligent Notification tab associates you for the next steps.
 
 

Create User Group

1) Logon to the wps/portal as "wpsadmin" with password "wpsadmin".

2) Select the "Intelligent Notification" portlet group.

3) Select "My User Groups" tab.

4) Under the "Current user groups", click "Add user group".

5) In the "Add user group" section , in the "Name of user group" field, enter the name of your user group (i.e. "StevesINSusers"), and click "Add member".

6) In the "My user groups" portlet, under the "Add members to user group" heading, in the "User name is" field, enter an "*", then click "Go".

7) In the "Search Results" set, select your user "insuser1" and click "Add to list". Repeat this step for all INS users, then click "OK".

8) Back in the "Add user group" section , click "OK".
 
 

Create Message Rules

1) Back in the"Intelligent Notification" portlet group, select the "My Message Rules" tab.

2) Click "Add rule" under the "Urgent message rules" type.

3) In the "My message rules" portlet, under the "Add a message rule", in the "Who" selection choice, select "your user group (i.e."StevesINSusers"), in the "How" section, select at a minimum your channel (i.e. "StevzMale") (Steve included StevzMS for Messaging Center), and in the "Also apply this rule to" section, select "Normal message rules" and "FYI message rules", then click "OK".
 
 
 

RSS Configuration

Starting RSS On AIX

1) On the machine INS is installed on, in the directory "/usr/WebSphere/INS/apps" modify the file "RSSStartup.properties" by adding news feeds. At the end of the file, for the parameter "rssFeeds", include the RSS news feeds you wish to monitor (no quotes) (i.e. "rssFeeds=http://www.worldpress.org/feeds/topstories.xml,http://www.daypop.com/news/rss.xml"). (also, you might wish to change the "pollingInterval" to be faster (i.e. 1 minute).

2) At the command prompt, in the same directory, execute the script "startRSS" with the parameter "RSSStartup" (i.e. "startRSS RSSStartup"), which will start the process which will connect to these news servers.
 
 

Configuring RSS On WEA

1) In the "Portal Administration" portlet group, in the left frame, under the "Portlets" item, click on "Manage Portlets".

2) In the "Manage Portlets" section of this view, select the "Intelligent Notification RSS Subscription" portlet and click on "Modify Parameters".

3) In the "Manage Portlets" section of this view, in the "Edit Parameters" section, for the "Parameter" field, enter a value for the parameter (i.e "rssFeeds0")

4) Go to one of the web sites listed above and view the XML file for the site (i.e. "http://www.worldpress.org/feeds/topstories.xml"), and in the text of the xml file, look for the "channel", and the associated "title" (i.e. "Top Headlines from World Press Review"). Enter this value in the "value" field of the "Edit Parameters" section, then click "Add".

5) Again, in the "Edit Parameters" section, for the "Parameter" field, enter a value for the parameter (i.e "rssFeedsDisplay0"), with a similar value for the "Value" field (i.e. "SH Top Headlines from World Press Review")(STEVE PUT "Iraq"), then click "Add".

6) Click "Save" to save these configuration values.

(note, you can add additional parameters and values for additional pairs of titles, simply increment the digit in the parameter field. The "Value", from the second parameter you added will be a choice in subsequent pull-down selections required for later configuration).

(Steve, assure the following step is required!)

7) Start and stop INS Servers, then log out and back on as "wpsadmin" password "wpsadmin" (maybe even need to kill the browser and restart it).

8) In the "Intelligent Notification" portlet group, select the "My Subscriptions" tab, and in the "My RSS news subscriptions" portlet, click "Add Subscription".

9) In the "News Source" field, select the News Source you wish to get information from.

10) In the "Subject contains" field, enter the value of one of the "item" "titles" in the XML file from the site above (i.e. "Iraq").

11) In the "Notification" option, select "Always". Beneath that, select the "All of the selected delivery channels", and then select all the channels that you wish to receive notifications at, then click "OK".

STEVE START FIXING HERE!

16) To verify, from the supported web browser of your choice, (re)logon as "wpsadmin" password "wpsadmin". If you had selected a delivery channel you had created for your SNMP Mail Delivery, you could select the "WEA Home" portlet group, select the "Exchange" tab, and you should see new message(s) reflecting the news you have chosen. Alternatively/additionally, if you had added a delivery channel created for your Message Center, you could select the "Intelligent Notification" portlet group, select the "Message Center" tab, and see that you have received Message Center messages in this portlet.
 
 
 
 
 

Sametime Configuration
 
 

Configuring and Starting Sametime
 

To use Sametime, first assure you have the appropriate users configured on your Sametime server (i.e. "shaydensam", "shaydenfeeder", and "shaydenuser",  on Sametime server "wildwes.raleigh.ibm.com") and then perform the following steps.
 
 

Configuring LDAP for INS Sametime

1)  Start the Directory Management Tool (DMT) from the "/usr/ldap/bin" directory by typing "dmt&".

2)  In the "Server" in DMT, click "Rebind".

3)  In the Rebind panel, select "Authenticated", and in the "User DN" enter your id (i.e. "cn=wpsadmin") and "User password" (i.e."wpsadmin"), then click "OK".

4)  Scope down to "dc-ins,dc-ibm,dc=com", "sys=SDP", "sys=sam1_wea2aix5" (where "wea2aix5" should be the host name of your INS server machine"), "cid=common", and select "settingID=ibm-sametimeSametimeServer" and click "Edit" button.

5)  In the Edit an LDAP Entry dialog box, in the "cisProperty" field, enter the name of your Sametime Server machine (i.e. "wildwes.raleigh.ibm.com"), then click "OK".

6)  Select the "settingID=ibm-sametimeSametimeUser", and click the "Edit" button.

7)  In the "cisproperty" field enter the value "shaydensam", then click "OK".

8)  Select the "settingID=ibm-sametimeSametimePassword", and click the "Edit" button.

9)  In the "cesProperty" field, enter "shaydensam", then click "OK".

1)  Select "settingID=ibm-sametimeRealm", and click "Edit".

11) Verify the "cesProperty" value is "ins.realm", then click "OK". (you can now close "Exit" the DMT GUI).

12) On the machine you have installed INS on, from the "/usr/WebSphere/INS/bin" directory, execute the SAM script file by typing "./startSAM" with your machine name as the only parameter (i.e ./startSAM wea2aix5").
 
 
 
 
 

Using Example Stock Notification

1) In the WEA portlets, in the "Portal Administration" page group, under the "Users and Groups" tab, you need to create a user "slayden", and then add "slayden" to the "INSUsersGroup" group (dont forget to click "OK"!).

2) Logoff as wpsadmin and logon to the wps/portal as "slayden" with password "slayden".

15) Go to the "Intelligent Notification" page group.

16) In the "My Delivery Channels" tab, "Sametime Deliver channels" section select "Add Delivery Channel".

17)  In the "Delivery Channel Name", enter a value (i.e. "SLAYdenDC"), and the Sametime ID enter "shaydenuser", then click "OK".

18) Select the "My Subscription" tab, and in the "My Stock Subscriptions" field click "Add subscription".

19)  In the My Stock Subscriptions" "Stock Symbol" field enter "IBM", in the "Condition" select "Less than", and in the "Stock price" enter "150", and in the "Notification", select "Always", in the "Send to these delivery channels", select "SLAYdenDC" then click "OK".

20) From your personal PC machine, execute the Sametime Client.

21) In the Sametime Connect window, select "Options", and click on "Preferences".

22) In the Preferences dialog box, select the "Sametime Connectivity" tab.

23) In the Sametime Connectivity panel, for the "Host" field, enter "wildwes.raleigh.ibm.com" and click "OK" (Port = 1533 and Proxy Type = "No proxy").

16) In the Sametime Connect window, select "People", and click on "Log of of Sametime".

17) In the Sametime Connect window, select "People", and click on "Log on to Sametime".

18) In the Log on to Sametime dialog box, enter your username/password (i.e. "shaydenuser" and "shaydenuser"), then click "Log On".

19) From the machine you have installed INS on, go to the directory "/usr/WebSphere/INS/samples", and execute the command "contentfeed.sh stocks stock", within a few seconds a new Sametime window should appear reflecting IBM's stock price.
 
 
 
 

Generic Test For Sametime Server

Instant Messaging

1) From a Sametime client, make sure you are logged off any sessions, then from the "Sametime Connect" window menu bar select "Options" and click on "Preferences".

2) In the "Preferences" dialog box, select the "Sametime Connectivity" tab.

3) In the "Sametime community server" field, enter the value "wildwes.raleigh.ibm.com', then click "OK" (original value was "messaging.ibm.com")

4) From the "Sametime Connect" window menu bar click on "People", and select "Log on to Sametime" (you might need to Log Off first!), and enter the User Name "insuser2" with the same value for Password, and click "Log On".

5) Invoke Sametime again, and log on as another user (i.e. "insuser1").

6) From this second Sametime window, add the user "insuser2" by selecting the "Work" field, right mouse click and select "Add".

7) In the "Add Person or Group" dialog box, enter "insuser2" for the User name and Nickname, then click "Add", then "Close".

8) From the Sametime insuser2 window, click "insuser1", right mouse click and select "Message".

9) Enter a message, click "Send", and the message should appear on the "insuser1" dialog box.

10) If you can talk back and forth between these two Sametime users, the Sametime installation/configuration might be healthy
 
 
 
 
 
 
 

INS Installation Anomally

Take with a grain of salt!  Notes: with Hua, tried to manually create database using "/usr/WebSphere/INS/install/setupdb.sh", which has 2 parameters, the userid and password for the INS DB instance (i.e. "wasinst" and "wasisnt"). Also ran "/usr/WebSphere/INS/install/RecentAlert/initWEA.sh" with parameters for database name, userid, and password (i.e. "initWEA.sh wasinst wasinst wasinst").

Logs for installation are in file is "/usr/WebSphere/INS/log.txt"