+

Search Tips   |   Advanced Search

Required post-customization step

Edit a configuration property so users will see the changes the next time they log in, without having to clear their web browser cache.

Only perform this procedure if you made customization changes to the product user interface.

To edit configuration files, use wsadmin.sh.for details.

Each product web page downloads static script and stylesheets that do not change often. To optimize performance, these pages are cached for extended periods of time so that users only need to download them once per product upgrade. After you make customizations, we can instruct the server to ensure that all web browsers download new copies of these files. To force web browsers to refresh all cached content on the next visit, run the following command to update the product version stamp. The version stamp is automatically updated when we install any ifixes or major product version upgrades.

  1. Use the wsadmin client to access and check out the IBM Connections configuration files.

    1. Access the IBM Connections configuration file: execfile("connectionsConfig.py")

      If we are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, select the node where the file is stored. This information is not used by the wsadmin client when we are making configuration changes.

    2. Check out IBM Connections configuration files:

      LCConfigService.checkOutConfig("/tmp","cell_name")

      where:

      /tmp is the temporary working directory to which configuration files are copied. The files are kept in this working directory while you edit them.

      When we specify a path to the working directory on a system that is running Windows, use a forward slash for the directory. For example: "/tmp".

    3. cell_name is the name of the WAS cell hosting the Connections application. If we do not know the cell name, display it by typing the following command in the wsadmin client: print AdminControl.getCell()

      This input parameter is case-sensitive.

  2. Enter the following command to increment the value of the versionStamp property:

      LCConfigService.updateConfig("versionStamp","gmt_timestamp")

    ...where gmt_timestamp is the GMT time. We can specify an empty string for the time stamp or provide a GMT value string. When we specify an empty string, the client calculates the current GMT time and updates the version stamp with that value. If we choose to provide the time, specify it using the following format: yyyyMMdd.HHmmss and specify the time in GMT. It is best to provide an empty string and let the client format the time stamp. For example:

      LCConfigService.updateConfig("versionStamp","")

  3. After making changes, check the configuration files back in during the same wsadmin session in which you checked them out for the changes to take effect. See Apply common configuration property changes for information about how to save and apply the changes.


Parent topic:
Customizing


Related:
Apply common configuration property changes
Customize the Getting Started view
Files configuration properties
Wikis configuration properties