WebSphere Application Server configuration data

If you use WebSphere® Application Server, you must specify information about how WebSphere Application Server is installed in your environment when you run the installation program.

A web application server is required for the administration console, enterprise search application, and content analytics miner. When you install Watson Content Analytics, you can choose to use WebSphere Application Server instead of the embedded web application server. You cannot use WebSphere Application Server and the embedded web application server in the same system.

With WebSphere Application Server, default port and user authentication requirements differ from installations that use the embedded web application server:

The default ports for the administration console, applications, and REST APIs are different.
The search server does not authenticate application users through the LDAP repository. The default Watson Content Analytics administrator ID must have authority to use the SIAPI APIs for enterprise search. This authority is not required for the REST APIs because the application server where the enterprise search application is deployed authenticates users and propagates that information to the search server.
The default Watson Content Analytics administrator ID, which is also the default master administrator for the administration console, must be registered in the user registry for the WebSphere Application Server LDAP server. Register this user before you enable global security in WebSphere Application Server. If you enable global security after you install Watson Content Analytics, you must you use the eschangewaspw command to provide the credentials for a registered WebSphere Application Server administrative user to Watson Content Analytics.
Administrative user authentication requires WebSphere Application Server global security. To add administrative users to Watson Content Analytics, log in to the administration console as the master administrator and open the Security page. All administrative users that you add must be registered in the user registry for the WebSphere Application Server LDAP server.
Application user authentication also requires WebSphere Application Server global security. To configure application user privileges, you must map the users or user groups to specific security roles. For example, in the WebSphere Application Server administrative console, you must assign the SAVE_SEARCH role to application users who are authorized to save searches.

To take advantage of performance and other enhancements, you might want to install or upgrade to the latest supported version of WebSphere Application Server before you run the Watson Content Analytics installation program. The product package provides media and electronic images for the base WebSphere Application Server software and the required supplemental software, IBM® HTTP Server and the Web Server Plug-in.

When you install WebSphere Application Server, log in with the same user ID that you use for installing Watson Content Analytics.

Restriction: Connecting to remote instances of WebSphere Application Server is not supported.

WebSphere Application Server Network Deployment

If you specify WebSphere Application Server Network Deployment as the application server when you run the installation program, the applications are deployed on a cluster server by default. Both vertical and horizontal clustering are supported.

If you do not want to install the applications on a cluster server, use the following command to run the installation program:

AIX® or Linux: ./install.bin -D\$WAS_CLUSTERING_ENABLED\$=false
Windows: install.exe -D$WAS_CLUSTERING_ENABLED$=false

Limitations:

The back-end processes of Watson Content Analytics do not run on WebSphere Application Server Network Deployment.
The processes do not use the clustering features of Network Deployment, such as balancing workloads, high availability, or deployment managers.

Required WebSphere Application Server configuration data

You must have the following information about WebSphere Application Server available before you start the installation program.

Table 1. WebSphere Application Server configuration data
Installation option	Notes®
WebSphere Application Server installation directory	The absolute path for the installation directory, such as C:\Program Files\IBM\WebSphere\Appserver.
IBM HTTP Server installation directory	The absolute path for the installation directory, such as C:\Program Files\IBM\HTTPServer.
WebSphere Application Server fully qualified server name	The fully qualified domain name of the server where WebSphere Application Server is installed, such as `example.server.com`.
WebSphere Application Server profile directory	The absolute path for the profile directory that is configured for this installation of WebSphere Application Server, such as C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01.
WebSphere Application Server cell name	The cell name that is configured for this installation of WebSphere Application Server, such as `wasNode01cell`.
WebSphere Application Server node name	The node name that is configured for this installation of WebSphere Application Server, such as `wasNode01`.
WebSphere Application Server Network Deployment profile directory	If you use WebSphere Application Server Network Deployment, the absolute path for the WebSphere Application Server Network Deployment profile directory is required.
Web server name	The name of the web server that is configured for this installation of WebSphere Application Server, such as `webserver1`.
WebSphere Application Server administrative user name and password	The administrative user ID and password are required if global security is enabled in WebSphere Application Server.