Enabling access to Analyst's Notebook Web

Before you begin

The default set of command access control permissions do not provide access to Analyst's Notebook Web. If you want users to be able to use Analyst's Notebook Web, you must specify it in a command access control file.

As well as command access control permissions, Analyst's Notebook Web requires a secure connection between the user's web browser and the i2 Analyze server. For information on setting up a secure connection to the i2 Notebook web client, see Configuring Liberty for TLS.

About this task

By default, when users log in to i2 Analyze through their web browser, they see the i2 Explore web client. To change that behavior, you must give specific access to Analyst's Notebook Web to some or all of your users.

If you follow this procedure in a deployment that provides high availability, you must complete each step on every Liberty server in your environment before you move to the next step.

Procedure

To provide access to Analyst's Notebook Web to users in some or all system user groups, you must add the i2:Notebook command access permission for the groups in question.

1. If you have not already done so, follow the instructions in Configuring command access control to set up a command access control file in your deployment of i2 Analyze.

2. In a text editor, modify the command access control file:

   1. Open the file, which is conventionally named command-access-control.xml and found in the toolkit\configuration\fragments\opal-services\WEB-INF\classes directory.

   2. Add permission to access Analyst's Notebook Web to one of the user groups. For example:

      <CommandAccessPermissions UserGroup="Analyst">
        <Permission Value="i2:RecordsUpload"/>
        <Permission Value="i2:RecordsDelete"/>
        <Permission Value="i2:RecordsExport"/>
        <Permission Value="i2:ChartsUpload"/>
        <Permission Value="i2:ChartsDelete"/>
        <Permission Value="i2:Notebook"/>
      </CommandAccessPermissions>

3. Save and close the command-access-control.xml file.

4. In a command prompt, navigate to the toolkit\scripts directory.

5. Stop Liberty:

   setup -t stopLiberty

6. Update the i2 Analyze application:

   setup -t deployLiberty

7. Start Liberty:

   setup -t startLiberty