Completing post-installation tasks after updating or rolling back to a different service level

This article describes post-installation tasks that you complete after applying a new service level.

About this task

The post-installation functionality includes actions that are performed at the following times:
  • At installation time

    Installation Manager calls the post-installer for any non-profile related configuration actions using positnstall.sh or positnstall.bat. You can see a mention of the post-installer in the installation log.

    Installation manager considers the post-installation step a nonfatal one; therefore, it does not roll back the installation if the post-installer returns FAIL or PARTIAL SUCCESS. Installation manager will display The packages are installed with warnings at the end of the installation. If the post-installation action fails, run app_server_root/bin/postinstall.sh or app_server_root/bin/postinstall.bat with the following parameters (on one line):
    -WS_CMT_CONF_DIR app_server_root/properties/postinstall/
    -MASTER_ACTION_REGISTRY app_server_root/properties/postinstall/masterRegistry.xml
    -SUB_ACTION_REGISTRY app_server_root/properties/postinstall/cacheRegistry.xml
    -WS_PI_ACTION_REGISTRY_EXTENSION app_server_root/properties/postinstall/registryExtension.xml
    -WS_CMT_LOG_HOME app_server_root/logs/postinstall/
    -POSTINSTALL_LOG_FILE app_server_root/logs/postinstall/postinstall.log
    Note: Application Client for IBM® WebSphere® Application Server and IBM HTTP Server for WebSphere Application Server also use the post-installer at installation time. If the post-installer fails, the installation completes with warnings just like for WebSphere Application Server and recovery is very similar. Simply replace app_server_root in the example with app_client_root or IHS_root.
  • At server-startup time
    The runConfigActions.sh or runConfigActions.bat script runs before server startup. This script runs all the necessary configuration actions for all product fix packs and interim fixes that are installed in app_server_root.
    • If the script returns RC=0 (SUCCESS) or RC=2 (PARTIAL SUCCESS), the server starts.
    • If the script returns RC=1 (FAIL), the server does not start.
    If the runConfigActions script returns FAIL or PARTIAL SUCCESS, complete the following actions:
    1. Read the logs.
      The logs are in the following locations:
      Overall log for all products installed
      profile_root/properties/service/productDir/runConfigActions.log
      Log specific to WebSphere Application Server
      profile_root/properties/service/productDir/WebSphere/logs/postinstall.log
      Configuration-manager log specific to a run of the post-installer for WebSphere Application Server
      profile_root/properties/service/productDir/WebSphere/logs/postinstallerConfigActionstimestamp.log
      Log specific to a stack product or feature pack
      profile_root/properties/service/productDir/product_name/logs/postinstall.log
      Configuration-manager log specific to a run of the post-installer for a stack product or feature pack
      profile_root/properties/service/productDir/product_name/logs/postinstallerConfigActionstimestamp.log
      Log specific to an interim fix for a stack product or feature pack
      profile_root/properties/service/productDir/product_name/iFixes/interim_fix_name/logs/postinstall.log
      Configuration-manager log specific to a run of the post-installer for an interim fix for a stack product or feature pack
      profile_root/properties/service/productDir/product_name/iFixes/interim_fix_name/logs/postinstallerConfigActionstimestamp.log
    2. Fix any problems.
    3. Start the server again, or run profile_root/bin/runConfigActions.sh or profile_root/bin/runConfigActions.bat.

      The user running the script must have enough authority to update the profile—in other words, enough authority to start the server.

This applies to all platforms as well as any feature pack, interim fix, or stack product that requires post-installation tasks at server startup.

Procedure




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 20, 2011 12:35:32 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-express-dist&topic=tins_postinstallapp
File name: tins_postinstallapp.html