Enabling access to the i2 Notebook web client

The default set of command access control permissions do not provide access to the i2 Notebook web client. If you have a deployment of i2 Analyze that includes the Chart Store, and you want users to be able to use the i2 Notebook web client, you must specify it in a command access control file.

Before you begin

As well as command access control permissions, the i2 Notebook web client 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 Investigate web client. To change that behavior, you must give specific access to the i2 Notebook web client 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 the i2 Notebook web client to users in some or all 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 the i2 Notebook web client 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