FileNet P8 Workplace XT, Version 1.1.5              

Setting the bootstrap properties on first login

Six bootstrap preference groups are available for configuring the first time you sign in to Workplace XT.

To set the bootstrap properties:
  1. Sign in to Workplace XT:
    1. On any computer, open a browser and type:

      http://WorkplaceXTServerName:port#/WorkplaceXT

      Important: WorkplaceXTServerName cannot be localhost or an IP address.
    2. Enter a user name and password, and then click Log in. The Bootstrap Preferences page opens.

      The user who initially logs in and sets the bootstrap preferences is automatically added to the Application Engine Administrators role. For more information, see the IBM® FileNet® P8 help topic User Help > Actions, preferences, and tools > Site preferences > Access Roles preferences.

  2. Enter security info (required for SSL only).
    1. Enter the SSL Host and Port information for the SSL server.
    2. Enter the Java™ Server HTTP port.

      Use the Security info preference to redirect Application Integration log-ins through a Secure Socket Layer (SSL) server and to identify a remote Java server. This encrypts the user IDs and passwords when they travel over the network. See Setting up SSL security for Workplace XT for instructions on setting up SSL security for one or more Workplace XT installations.

      Important: After you have configured SSL, the Site Preferences application also runs under SSL to protect the guest account's user ID and password. This means that when you run Site Preferences on an unsecured server that redirects sign-ins to an SSL server, you will be editing the Bootstrap preferences of the SSL server (stored in the bootstrap.properties file). This does not affect the General, Object Store, and Shortcut preferences, which are retrieved from the preferences file saved in the object store.
  3. Configure user token settings.

    User Tokens are used by IBM FileNet P8 applications to launch into each other without the need for an additional login.

    You can specify a Token timeout interval (1 - 15 minutes) for Workplace XT.

  4. (Required) Specify preference settings.

    Preference settings specify the name of the site preference file, its storage location (object store), and the documentation server URL (if installed). The site preferences file is checked into the object store the first time you log on to Workplace XT. The site preferences are stored as XML data in this file, Site Preferences for Preferences name.xml. Use Enterprise Manager to access this file, and navigate to Object Stores > Object Store location > Root Folder > Preferences.

    The bootstrap preferences are saved in the bootstrap.properties file, and not in the site preferences file. The default location for this file is AE_install_path/FileNet/Config/AE.

    1. Select an object store from the Object store location choice list. The preferences file will be saved in this object store. Workplace users must have access to this object store.
    2. Enter a preference file name in the Preferences name field.
    3. Enter the documentation server URL in the Documentation server field.
      The format of the URL depends on the documentation package you use:
      Table 1. Documentation URLs
      FileNet P8 documentation package URL
      Online information center at www.ibm.com http://pic.dhe.ibm.com/infocenter/p8docs/v5r2m0/topic/com.ibm.p8.xt.user.doc
      Installed P8 information center http://server_name:port#/application_name/topic/com.ibm.p8.xt.user.doc
      where:
      • server_name is the name of the server where the FileNet P8 Platform documentation information center is installed.
      • port# is the port number.
      • application_name is the name of the deployed FileNet P8 Platform application. If you have installed a local information center, the application name is typically p8docs.
  5. Add Application Engine Administrators (ae_admin_user). Add the users and groups that will perform Workplace XT administration tasks to the Application Engine Administrators role.

    The user who initially signs in and sets the bootstrap preferences is automatically added to the Application Engine Administrators role. For more information, see the IBM FileNet P8 help topic User Help > Actions, preferences, and tools > Site preferences > Access Roles preferences.

    To modify the access roles after the initial bootstrap configuration, users with the Application Engine Administrators role can use the access roles section of the Workplace Site Preferences. Launch Workplace XT and navigate to Admin > Site Preferences > Access Roles.

  6. Click Apply to save your bootstrap settings.

After the initial bootstrap configuration, users with the Application Engine Administrators (ae_admin_user) role can change any of these preferences by signing into Workplace XT and navigating to Admin > Site Preferences > Bootstrap.

Bootstrap properties are stored in a separate file from other site preferences. The default location for this file, bootstrap.properties, is install_path/IBM/FileNet/Config/WebClient.

In a web farm or clustered environment, all Workplace XT installations share site preferences by using the same bootstrap.properties file. For more information, see the FileNet P8 high availability technical overview section of the IBM FileNet P8 Information Center.



Feedback

Last updated: March 2013
wxtip047.htm

© Copyright IBM Corporation 2013.
This information center is powered by Eclipse technology. (http://www.eclipse.org)