FileNet P8 Application Engine, Version 5.2.1              

Setting the bootstrap properties on first login

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

About this task

In addition to the preferences covered in this topic, more preferences can be set for the Workplace application by using Workplace Site Preferences. For more information, see Site preferences.

Procedure

  1. Log on 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 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 Sockets 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. 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 Administration Console for Content Platform Engine to access this file.

    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 base documentation server URL in the Documentation server field.
      The format of the base documentation URL depends on the documentation package you use:
      Table 1. Base documentation URLs
      FileNet P8 documentation package URL
      Online documentation at www.ibm.com http://www.ibm.com/support/knowledgecenter/SSNW2F_5.2.1/
      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 information center is installed.
      • port# is the port number.
      • application_name is the name of the deployed FileNet P8 Platform application. If you installed a local information center, the application name is typically p8docs

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

    4. Enter the ISRA Interface Servlet URL.

      For more information, see Enabling Application Engine to use Image Services Resource Adapter.

  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 email to an object store each time the email is sent.

    Select Yes if you want users prompted to add an email to an object store when the email 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 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.

What to do next

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.



Last updated: October 2015
p8pin135.htm

© Copyright IBM Corporation 2013, 2015.