Teamstudio Adviser consists of two components, an IBM Domino application hosted on a Domino server, and an executable program that runs on a workstation with an IBM Notes client installed.
The Adviser server application provides Adviser's browser-based user interface, generates reports on databases and users for the Adviser modules, and stores all data collected by Adviser. Adviser server is deployed by creating an NSF based the template TSAdviser.ntf on the desired server, and configuring it via web browser.
Adviser workstation is responsible for collecting the data that forms the basis for the reports generated by the Adviser server. Adviser workstation is deployed by running an installer (contained in the server NSF) on a workstation installation of IBM Notes. The installed program is configured by the installer to connect to the Adviser server, and remains running to process Adviser scans as needed. Scans are resource intensive processes; running scans from a client workstation limits the impact of Adviser on server performance, and allows easier configuration and access to servers in multiple domains.
The web interface for Teamstudio Adviser can be hosted on any Domino server version 8.5.3 or above, with the HTTP task enabled.
The Teamstudio Adviser workstation is supported on Notes version 8.5.3 and higher (32-bit) running on supported versions of Microsoft Windows.
Upgrading an Existing Installation
If you are upgrading an existing installation of Adviser 6.0 or above, you can skip directly to the Upgrading section. Otherwise continue to follow the instructions below.
Prerequisites for Usage Data Collection
The Usage module of Teamstudio Adviser aggregates and reports on data collected by the IBM Domino server’s Activity Logging task.
In order to use Usage Auditor, Activity Logging must be enabled on all servers you wish to include.
Activity Logging can be enabled on the Server Configuration document in the Domino Directory database. Teamstudio Adviser tracks the following activity streams:
By default, Activity is logged to the Log.nsf database on the server, and the retention period for Log.nsf applies to activity as well. By default, Teamstudio Adviser will collect usage data every night and will import any new data. If collection fails, no data will be lost as long as the problem is resolved within the retention period.
Installing and Configuring Teamstudio Adviser Server
To install the server component, sign the TSAdviser.ntf template with an ID appropriate to execute code and access servers to be scanned, and create an NSF from the template on the desired server.
To configure Teamstudio Adviser, connect to the application via web-browser, using an address in the form http(s)://<server>/<path>/index.html, where <server> is the host name or IP address of the Domino server, and <path> is the file path of the NSF. For convenience, the NSF displays this URL when opened in a Notes Client.
If installation is successful, you should see the application home screen.
By default, Teamstudio Adviser server requires that the ACL entry "anonymous" be defined as "No Access" and given the privilege "Read Public Documents" – this setting allows the Adviser workstation to trigger server-side job processing when client-side jobs have completed. Anonymous access cannot be used to create jobs or access data. Anonymous should not be set to a higher level of access, as authentication is required by the Adviser services that support the web browser application. Allowing anonymous higher levels of access will prevent the server from requiring authentication.
If the environment does not allow Anonymous access (for example, it is prohibited at the server level via the Directory's Server document), it is possible to configure Adviser to store and use an HTTP Username/Password combination for this access. For more information, contact Teamstudio support at firstname.lastname@example.org.
In general, other ACL settings in Adviser are applied to the browser application in the same manor they are applied in traditional Notes applications.
The "-Default-" access setting can be used to assign any level of access desired in place of anonymous access.
The final step in configuring the Teamstudio Adviser server is to select the servers to scan. You can do this from the Settings page in the web application, accessed via the gear icon on the right of the Adviser navigation bar. See Servers for more details.
Installing the Adviser data collection application on workstations
The Adviser Workstation application is a executable application that run scans from a client workstation. Scanning for and reporting on activity is a resource intensive activity that may access multiple servers and which works with file system files as part of the process.
The data collected during the Workstation scans is written to the server application, and available via the web browser interface.
Adviser Workstation is intended to run continuously, as it monitors the Adviser Server component, waiting for scans to be scheduled.
The application must be run by ID that has a least Reader access to the Log.nsf files on the servers to be scanned, as well as any applications for which Complexity data is desired. If the servers exist in multiple domains, the ID and local workstation must be properly cross-certified to all servers.
The ID must also have Editor level ACL access (with delete rights) to the Adviser Server application.
Installing the Adviser Workstation application
When the installation is complete, the installer will offer to launch the Workstation application.
For information on upgrading an existing Adviser install, see the Upgrading section below.
Once installed, the Adviser workstation can be launched by clicking the same link used to install it, found in the Configuration page of the Adviser server NSF when opened in the Notes client, in the section titled Adviser Workstation:
The workstation can also be launched by running the executable Workstation.exe, which is installed by default at <Program Files (x86)>\Teamstudio\Adviser Workstation\Workstation.exe
Once launched, the Workstation application window should open, and begin monitoring for pending scans:
Workstation - Server Connectivity
Adviser workstation requires connectivity to the Adviser server via HTTP.
Most workstation processing, including scanning servers and databases, and writing data to the Adviser server, is handled through the Notes client and NRPC.
In order to trigger server processing once client side jobs have completed, Adviser invokes a REST service endpoint via HTTP to ensure that the server application is running to process the updated data.
The default workstation configuration attempts to connect to the server based on the fully-qualified host name specified first in the server document in the server's address book. The connection is attempted without SSL on port 80.
For servers requiring SSL connections, or connectivity on an alternate port, the configuration can be modified by editing the HTTP Host Name field in the Workstation Configuration document in the workstation database. By default this field contains only the host name; a protocol and optional port name can be specified (for example,specifies SSL on port 499). The Notes client acting as the Adviser workstation must be exited completely and restarted for this setting to take effect. For help configuring these settings, contact Teamstudio support.
Due to limitations with the Java 6 JVM currently embedded in Notes, SSL that uses large key sizes may not work correctly.