analytics/sdk/java/AuthenticationProvider/MultiTenancyTenantProviderSample

/**
* Licensed Materials - Property of IBM
*
* IBM Cognos Products: CAMAAA
*
* (C) Copyright IBM Corp. 2011, 2012
*
* US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with
* IBM Corp.
*/

Running the IBM Cognos SDK custom tenant provider sample
--------------------------------------------------------------------

To configure and run the sample provided, please follow these steps:

1) Add the Java SDK to your path.
2) Build the sample using the command build.bat on Windows or
build.sh on Unix.
3) Add the path to the jar file to your IBM Cognos 10 classpath
or copy the jar to /webapps/p2pd/WEB-INF/lib.
4) Add the path to the database driver jar file to your classpath
or copy the files to /webapps/p2pd/WEB-INF/lib.
5) Add the usersToTenants.properties file to your classpath or
copy the files to /webapps/p2pd/WEB-INF/lib.
6) Add the following entries to the Advanced properties of your
authentication namespace, or to the Authentication node's
Advanced properties to apply them to all namespaces:
multitenancy.ITenantProvider SampleTenantProvider
usersToTenantsFile usersToTenants.properties
7) Currently the userToTenant.properties file map users in the
starter namespace sample. If desired, modify the entries to
users in your namespace.
8) Apply changes and restart IBM Cognos 10.

When users in the usersToTenants.properties logon to the
authentication namespace, the tenant ID field in the audit database
should now be populated.

NOTE: If IBM Cognos 10 fails to start up once the new namespace
is configured, please verify your configuration. IBM Cognos 10 will
not start up if it cannot successfully communicate to the
authentication source.