FileNet P8 Application Engine, Version 5.0.+              

Setting the bootstrap properties on first login

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

In addition to the preferences covered in this topic, more preferences can be set for the Workplace application using Workplace Site Preferences. For more information, see the IBM® FileNet® P8 help topic Working with documents > Working with documents in Workplace > Site preferences.

  1. Sign in to Workplace:
    1. On any computer, open a browser and type:

      http://ApplicationEngineServerName:port#/Workplace

      Important: ApplicationEngineServerName cannot be localhost or an IP address.
    2. Enter a user name and password, and then click Sign 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 Working with documents > Working with documents in Workplace > 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 sign-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 Application Engine SSL security for instructions on setting up SSL security for one or more Application Engine 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.

    1. Select whether or not to create user tokens for your Application Engine (Default: Yes).
    2. Select whether or not the application will pick up generated tokens from other applications (Default: Yes).
    3. Specify a Token timeout interval (1 - 15 minutes).
  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. 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://publib.boulder.ibm.com/infocenter/p8docs/v5r0m0/topic/com.ibm.p8.doc
      Installed P8 information center http://server_name:port#/application_name/topic/com.ibm.p8.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

      If no documentation URL is specified, the Workplace Help link will default to http://localhost.

    4. Enter the ISRA Interface Servlet URL.

      For more information, see Enabling Application Engine to use ISRA.

  5. Set Banner Image.

    The banner image is the graphic that appears at the upper left-hand side of the Workplace application pages. If you have a banner image that you would like to use in place of the default, follow this procedure.

    1. Copy the new graphic file to the location of your choice on Application Engine in the /FileNet/AE/Workplace folder.
    2. In the Path field, type the path (relative to the /Workplace folder) to the new banner graphic file.
    3. In the Image Width field, type the width of the image (in pixels).
    4. In the Image Height field, type the height of the image (in pixels).
  6. Configure Application Integration.

    This preference setting only affects Outlook integration.

    Select No (default) if you do not want users to be prompted to add an e-mail to an object store each time the e-mail is sent.

    Select Yes if you want users prompted to add an e-mail to an object store when the e-mail is sent.

  7. Add Application Engine Administrators (ae_admin_user). Add the users and groups that will perform Application Engine 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 Working with documents > Working with documents in Workplace > 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 and navigate to Admin > Site Preferences > Access Roles.

    When you access the bootstrap preference page via the Site Preferences application, an additional preference, Guest info (to allow guest sign ins), is also available.

  8. 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 and navigating to Admin > Site Preferences > Bootstrap.

In a web farm/clustered environment, all Application Engine installations share site preferences by using the same bootstrap.properties file.



Feedback

Last updated: November 2010


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