Upgrade CA PPM

The following image shows how a system administrator upgrades a  installation for single and clustered servers.
ccppmop143
The following image shows how a system administrator upgrades a 
Clarity Project and Portfolio Management (PPM)
 installation for single and clustered servers.
This image shows how to upgrade CA PPM
This image shows how to upgrade CA PPM
 
Follow these steps:
  
 
Video: CA PPM Upgrade Assessment Utility
The following video is provided by CA Technologies.

To play this video in full screen, click the YouTube logo to the right of Settings at the bottom of the video. 
Pre-Upgrade Requirements
Consider the following important points before beginning the upgrade:
  • Run the Delete Process Instance job before you upgrade. Without performing this step, a series of full scans on the BPM_ERRORS table can slow performance. For every query, the database flushes all buffer data to disk in order to load and read new rows. Run this job with date parameters to improve performance. For example, run in monthly time segments. Run this job for Oracle and Microsoft SQL databases.
  • Read the Change Impact and Upgrade information for each release between the one you are currently using and the release to which you are upgrading. This content contains important preupgrade and postupgrade steps that apply to a specific upgrade release.
  • License key information is required to install some third-party software products. See the documentation or readme file that is provided with the installation media.
  • A user account with administrator rights is required for the server or servers on which you intend to install.
  • Verify that you are following a recommended upgrade path. Not all product releases have upgrade paths between them.
  • Back up the existing installation directory and database before you upgrade.
  • Disable any custom database triggers or antivirus scanners that can interfere with the upgrade or installation scripts.
  • Verify the configuration settings on the 
    Clarity Project and Portfolio Management (PPM)
     database server and note any changes that you want to make.
  • Verify that you have sufficient disk space available on the server on which the upgrade is performed.
  • Upgrade the following third-party software (as needed) to work with this release.
    • Java SDK
    • Apache Tomcat or IBM WebSphere (application server)
    • CA Business Intelligence (reports server)
    For information about the versions of third-party software that this release supports, see Compatibilities in the
    Release Notes
    .
  • Verify that a standard calendar exists in the product by looking at the properties of existing calendars. A standard calendar has the Standard check box selected in the calendar properties. To view properties of calendars, open the Administration menu, and from Project Management, click Base Calendars.
  • If XDM was part of a previous version of 
    Clarity Project and Portfolio Management (PPM)
     that you are upgrading, an XDM step appears in the installation process. After you run this step, ensure that XDM is distributed to the other servers in the cluster.
  • Recommended:
     We recommend that you turn off auditing on all objects before you start the upgrade process.
Upgrade an Apache Tomcat Single Server
This procedure describes how to upgrade an Apache Tomcat server.
Follow these steps:
  1. Stop and remove all services.
    service stop remove all
  2. Set up the application server by installing or upgrading needed third-party software.
    For information about setting up the application server, see
    Set Up the Application Server
    .
  3. From the command prompt, navigate to the directory where you want to unpack the 
    Clarity Project and Portfolio Management (PPM)
     installer file.
  4. Issue the following commands:
    mkdir temp cd temp
  5. From the directory, run the jar command to extract install.jar from the installation media:
    jar -xvf <path of the installation media>/install.jar
  6. Run the installation script:
    UNIX
    chmod +x ./install.sh sh ./install.sh
    Windows
    install.bat
  7. To complete the command-line upgrade, follow the prompts. 
    During the upgrade, default values from the existing 
    Clarity Project and Portfolio Management (PPM)
     installation are automatically entered as responses to the prompts.
    See the following list for upgrade property descriptions:
    • Clarity Project and Portfolio Management (PPM)
       Home Directory
      Specifies the directory in which to install 
      Clarity Project and Portfolio Management (PPM)
      . This directory is created if it does not exist.
    • Clarity Project and Portfolio Management (PPM)
       Target Directory (upgrade only)
      Specifies a new install directory for the upgrade process that is different from the current install directory. The default value is the current install directory.
    • JDK 1.8.0 Home Directory
      The Java JDK home directory (1.8.0_40 or higher).
    • Beacon Multicast Address
      The multicast address that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. The multicast address must be in the Class address range between 224.0.0.0 and 239.255.255.255. Each server within a cluster must use the same address and port. 
      Default value: 230.0.0.1
      We recommend an IP address in the 239.x.x.x subnet.
    • Beacon Multicast Port
      The port that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. Each server within a cluster must use the same address and port.
      Default value: 9090
    • Beacon Client Port
      Defines the server port number that the Beacon service uses.
    • Super User Command Prefix
      (UNIX only) The optional command prefix utility, such as sudo, to execute root-level commands. An example where you could implement a root-level command is when choosing a socket port below 1024 because root-level access is required to allocate it.
    • Super User Name
      (UNIX only) The optional replacement for the 
      root superuser
       name. This name can be used alone or with the superuser command prefix. For example, if used with sudo, specify the user to which sudo rights are given here.
    • J2EE Server Vendor
      Specify the J2EE server vendor: Apache Tomcat (default) or Generic J2EE. The supported generic J2EE vendor is IBM WebSphere (for IBM AIX only).
    • Install 
      Clarity Project and Portfolio Management (PPM)
       System Administration (CSA) Locally
      (Apache Tomcat only) Enter one of the following values:
      • If you are installing 
        Clarity Project and Portfolio Management (PPM)
         System Administration on this server, enter 
        true
        .
      • Otherwise, enter 
        false
        .
    • Tomcat 8 Home Directory
      (Apache Tomcat only) Defines the Apache Tomcat home directory.
    • CSA Web Port
      (Apache Tomcat only) Defines the web port number that 
      Clarity Project and Portfolio Management (PPM)
       System Administration uses. For a UNIX system, this value must be greater than 1024, or the service must be run as root.
    • Enter password
      (Apache Tomcat only) Specifies the 
      Clarity Project and Portfolio Management (PPM)
       System Administration password.
      Default value: admin
    • Operator User Name
      Specifies the user name of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Operator Email Address
      Specifies the email address of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Acknowledge reviewing Install Guide and Change Impact & Upgrade Guide
      This prompt records a response from installing users that they have read both 
      Installing and Upgrading
       and 
      Change Impact and Upgrade.
  8. Start the 
    Clarity Project and Portfolio Management (PPM)
     System Administration application.
  9. Update the properties of the server:
    1. In the left navigation panel, click Servers and select the server.
      The Properties tab for the server appears.
    2. Click each subtab that is listed on the Properties tab and complete the fields necessary for your configuration.
      For complete information about all of the fields that are found on the subtabs, see
      Clarity Project and Portfolio Management (PPM)
      System Administration (CSA) Server Properties
      .
  10. Start all services.
    1. Click All Services.
    2. Select the services and Click Start.
  11. To verify that 
    Clarity Project and Portfolio Management (PPM)
     is accessible from a browser, connect using the configured 
    Entry URL 
    value.
    The Entry URL is configured in 
    Clarity Project and Portfolio Management (PPM)
     System Administration on the Application subtab. If you have multiple application servers, the Entry URL points to the load balancer. If you have a single-server installation, the Entry URL points to the application server.
    The Entry URL has the following format:
    http://<
    server name
    >:<
    port
    >/niku/nu
    The default user ID and password are admin/admin. If the default HTTP port value of 80 is used, you do not have to specify the <
    port
    > value.
Upgrade an IBM WebSphere Single Server
This procedure describes how to upgrade a single IBM WebSphere server.
Follow these steps:
  1. Use the J2EE vendor (IBM) administration console and stop the 
    Clarity Project and Portfolio Management (PPM)
     and 
    Clarity Project and Portfolio Management (PPM)
     System Administration applications.
  2. Remove all services.
  3. Set up the application server by installing or upgrading needed third-party software.
    For information, see
    Set Up the Application Server
    .
  4. Open a command prompt on the application server and navigate to the directory where you want to unpack the 
    Clarity Project and Portfolio Management (PPM)
     installer file.
  5. Issue the following commands:
    mkdir temp cd temp
  6. From the directory, run the jar command to extract install.jar from the installation media:
    jar -xvf <path of the installation media>/install.jar
  7. Run the installation script:
    UNIX
    chmod +x ./install.sh sh ./install.sh
    Windows
    install.bat
  8. To complete the command-line upgrade, follow the prompts. 
    During the upgrade, default values from the existing 
    Clarity Project and Portfolio Management (PPM)
     installation are automatically entered as responses to the prompts.
    See the following list for upgrade property descriptions:
    • Clarity Project and Portfolio Management (PPM)
       Home Directory
      Specifies the directory in which to install 
      Clarity Project and Portfolio Management (PPM)
      . This directory is created if it does not exist.
    • CA Clarity PPM Target Directory (upgrade only)
      Specifies a new install directory for the upgrade process that is different from the current install directory. The default value is the current install directory.
    • JDK 1.8.0 Home Directory
      The Java JDK home directory (1.8.0_40 or higher).
    • Beacon Multicast Address
      The multicast address that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. The multicast address must be in the Class address range between 224.0.0.0 and 239.255.255.255. Each server within a cluster must use the same address and port. 
      Default value: 230.0.0.1
      We recommend an IP address in the 239.x.x.x subnet.
    • Beacon Multicast Port
      The port that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. Each server within a cluster must use the same address and port.
    • Beacon Client Port
      Defines the server port number that the Beacon service uses.
    • Super User Command Prefix
      (UNIX only) The optional command prefix utility, such as sudo, to execute root-level commands. An example where you could implement a root-level command is when choosing a socket port below 1024 because root-level access is required to allocate it.
    • Super User Name
      (UNIX only) The optional replacement for the 
      root superuser
       name. This name can be used alone or with the superuser command prefix. For example, if used with sudo, specify the user to which sudo rights are given here. If you are not running 
      Clarity Project and Portfolio Management (PPM)
       as root, set this value to the user name of the user who runs 
      Clarity Project and Portfolio Management (PPM)
       services.
    • J2EE Server Vendor
      Specify the J2EE server vendor: Apache Tomcat (default) or Generic J2EE. The supported generic J2EE vendor is IBM WebSphere.
    • Install 
      Clarity Project and Portfolio Management (PPM)
       System Administration (CSA) Locally
      (Apache Tomcat only) Enter one of the following values:
      • If you are installing 
        Clarity Project and Portfolio Management (PPM)
         System Administration on this server, enter 
        true
        .
      • Otherwise, enter 
        false
        .
    • Tomcat 8 Home Directory
      (Apache Tomcat only) Defines the Apache Tomcat home directory.
    • CSA Web Port
      (Apache Tomcat only) Defines the web port number that 
      Clarity Project and Portfolio Management (PPM)
       System Administration uses. For a UNIX system, this value must be greater than 1024; otherwise, the service must be run as root.
    • Enter password
      (Apache Tomcat only) Specifies the 
      Clarity Project and Portfolio Management (PPM)
       System Administration password.
      Default value: admin
    • Operator User Name
      Specifies the user name of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Operator Email Address
      Specifies the email address of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Acknowledge reviewing Install Guide and Change Impact & Upgrade Guide
      This prompt records a response from installing users that they have read both 
      Installing and Upgrading
       and 
      Change Impact and Upgrade.
  9. From the J2EE application server administration console (IBM WebSphere), deploy the nsa.ear file to set up 
    Clarity Project and Portfolio Management (PPM)
     System Administration.
    The upgrade script places the nsa.ear file in the 
    Clarity Project and Portfolio Management (PPM)
     home directory on the application server.
    For information about deploying using the administration console, see the appropriate vendor documentation.
  10. Start 
    Clarity Project and Portfolio Management (PPM)
     System Administration and configure the server properties as needed.
    1. In the left navigation panel, click Servers, and then click the server name.
      The Properties tab for the server appears.
    2. Click each subtab that is listed on the Properties tab and complete the fields necessary for your configuration of 
      Clarity Project and Portfolio Management (PPM)
      .
      For complete information about all of the fields that are found on the subtabs, see
      Clarity Project and Portfolio Management (PPM)
      System Administration (CSA) Server Properties
      .
  11. Package the niku.ear file.
    1. In the 
      Clarity Project and Portfolio Management (PPM)
       System Administration left navigation pane, click Install and Upgrade.
    2. Click Package Application EAR.
    3. Click Create Package.
      A Status window appears and displays the status until the EAR file is created in the Clarity home directory:
      <clarity home>/niku.ear
  12. Start all services.
    1. Click All Services.
    2. Select the services and click Start.
  13. From the application server administration console (IBM WebSphere), deploy the niku.ear file.
  14. To verify that 
    Clarity Project and Portfolio Management (PPM)
     is accessible from a browser, connect using the configured 
    Entry URL 
    value.
    The Entry URL is configured in 
    Clarity Project and Portfolio Management (PPM)
     System Administration on the Application subtab. If you have multiple application servers, the Entry URL points to the load balancer. If you have a single-server installation, the Entry URL points to the application server.
    The Entry URL has the following format:
    http://<
    server name
    >:<
    port
    >/niku/nu
    The default user ID and password are admin/admin. If the default HTTP port value of 80 is used, you do not have to specify the <port> value.
Upgrade an Apache Tomcat Cluster
This procedure describes how to upgrade Apache Tomcat clustered servers.
Follow these steps:
  1. Stop and remove all services in the cluster. Run the following combination of commands on each server:
    service stop remove all
  2. Set up all servers by installing or upgrading needed third-party software.
    For information about setting up the application server, see
    Set Up the Application Server
    .
  3. Open a command prompt on the server, and navigate to the directory where you want to unpack the 
    Clarity Project and Portfolio Management (PPM)
     installer file.
  4. Issue the following commands:
    mkdir temp cd temp
  5. From the directory, run the jar command to extract install.jar from the installation media:
    jar -xvf <path of the installation media>/install.jar
  6. Run the installation script:
    UNIX
    chmod +x ./install.sh sh ./install.sh
    Windows
    install.bat
  7. To complete the command-line upgrade, follow the prompts. 
    During the upgrade, default values from the existing 
    Clarity Project and Portfolio Management (PPM)
     installation are automatically entered as responses to the prompts.
    See the following list for upgrade property descriptions:
    • Clarity Project and Portfolio Management (PPM)
       Home Directory
      Specifies the directory in which to install 
      Clarity Project and Portfolio Management (PPM)
      . This directory is created if it does not exist.
    • Clarity Project and Portfolio Management (PPM)
       Target Directory (upgrade only)
      Specifies a new install directory for the upgrade process that is different from the current install directory. The default value is the current install directory.
    • JDK 1.8.0 Home Directory
      The Java JDK home directory (1.8.0_40 or higher).
    • Beacon Multicast Address
      The multicast address that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. The multicast address must be in the Class address range between 224.0.0.0 and 239.255.255.255. Each server within a cluster must use the same address and port. 
      Default value: 230.0.0.1
      We recommend an IP address in the 239.x.x.x subnet.
    • Beacon Multicast Port
      The port that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. Each server within a cluster must use the same address and port.
      Default value: 9090
    • Beacon Client Port
      Defines the server port number that the Beacon service uses.
    • Super User Command Prefix
      (UNIX only) The optional command prefix utility, such as sudo, to execute root-level commands. An example where you could implement a root-level command is when choosing a socket port below 1024 because root-level access is required to allocate it.
    • Super User Name
      (UNIX only) The optional replacement for the 
      root superuser
       name. This name can be used alone or with the superuser command prefix. For example, if used with sudo, specify the user to which sudo rights are given here.
    • J2EE Server Vendor
      Specify the J2EE server vendor: Apache Tomcat (default) or Generic J2EE. The supported generic J2EE vendor is IBM WebSphere (for IBM AIX only).
    • Install Clarity System Administration (CSA) Locally
      (Apache Tomcat only) Enter one of the following values:
      • If you are installing 
        Clarity Project and Portfolio Management (PPM)
         System Administration on this server, enter 
        true
        .
      • Otherwise, enter 
        false
        .
    • Tomcat 8 Home Directory
      (Apache Tomcat only) Defines the Apache Tomcat home directory.
    • CSA Web Port
      (Apache Tomcat only) Defines the web port number that 
      Clarity Project and Portfolio Management (PPM)
       System Administration uses. For a UNIX system, this value must be greater than 1024; otherwise, the service must be run as root.
    • Enter password
      (Apache Tomcat only) Specifies the 
      Clarity Project and Portfolio Management (PPM)
       System Administration password.
      Default value: admin
    • Operator User Name
      Specifies the user name of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Operator Email Address
      Specifies the email address of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Acknowledge reviewing Install Guide and Change Impact & Upgrade Guide
      This prompt records a response from installing users that they have read both 
      Installing and Upgrading
       and 
      Change Impact and Upgrade.
  8. Start the 
    Clarity Project and Portfolio Management (PPM)
     System Administration application.
  9. Update the properties for each server in the cluster.
    1. In the left navigation panel, click Servers and select the server.
      The Properties tab for the server appears.
    2. Click each subtab that is listed on the Properties tab and complete the fields necessary for your configuration.
      For complete information about all of the fields that are found on the subtabs, see
      Clarity Project and Portfolio Management (PPM)
      System Administration (CSA) Server Properties
      .
  10. Verify that the database is accessible.
    To verify, open the Database subtab for a server and in the Internal Connection section verify that the status is Available.
  11. Start the Beacon service on all servers in the cluster.
    The Beacon service is required to distribute the upgraded content remotely to servers in the cluster.
  12. In the left navigation pane, select Distribute All.
    The Distribute All process is typically used to upgrade other servers in a cluster. However, if you are upgrading to 
    Clarity Project and Portfolio Management (PPM)
     from a version earlier than Release 8.1.1, you are required to upgrade each server individually.
    Use the following steps if you are upgrading from a release earlier than Release 8.1.1:
    1. Use FTP or otherwise transfer the install.jar file to the other servers in your distributed installation.
    2. Stop the local Beacon service before installing the new package.
    3. Install on each server using the install.jar file.
    4. Restart the Beacon service when all servers are installed.
  13. When the Distribute All command completes, complete these steps:
    1. Stop the Beacon service.
    2. Manually copy the following jar files from the administration server that runs 
      Clarity Project and Portfolio Management (PPM)
       System Administration to all the remaining servers in the cluster. The jar files replace the existing files in the $CLARITY_HOME/bin AND $CLARITY_HOME/lib directories.
      <install_dir>/bin/wrapper.jar
      <install_dir>/lib/commons-logging.jar 
      <install_dir>/lib/jgroups-all.jar
      <install_dir>/lib/log4j.jar
      <install_dir>/lib/nsa.jar 
      <install_dir>/lib/union.jar
      This extra step avoids any issues that might arise from distributing while files are in use on the administration server.
  14. To verify that the installation steps completed successfully, click Installation Overview in the left navigation pane.
  15. Review the 
    Clarity Project and Portfolio Management (PPM)
     Administration server 
    admin.log
     file for general errors or custom Studio Query (NSQL) validation errors.
  16. Start all services.
    1. Click All Services.
    2. Select the services and Click Start.
  17. To verify that 
    Clarity Project and Portfolio Management (PPM)
     is accessible from a browser, connect using the configured 
    Entry URL 
    value.
    The Entry URL is configured in 
    Clarity Project and Portfolio Management (PPM)
     System Administration on the Application subtab. If you have multiple application servers, the Entry URL points to the load balancer. If you have a single-server installation, the Entry URL points to the application server.
    The Entry URL has the following format:
    http://<
    server name
    >/niku/nu
    The default user ID and password are admin/admin.
Upgrade an IBM WebSphere Cluster
This procedure describes how to upgrade a cluster running on IBM WebSphere.
Follow these steps:
  1. Use the J2EE vendor (IBM) administration console and stop the 
    Clarity Project and Portfolio Management (PPM)
     and 
    Clarity Project and Portfolio Management (PPM)
     System Administration applications.
  2. Remove all services in the cluster.
  3. Set up all servers by installing or upgrading required third-party software.
    For more information, see
    Set up the Application Server
    .
  4. From the administration server command prompt, navigate to the directory where you want to unpack the 
    Clarity Project and Portfolio Management (PPM)
     installer file.
  5. Issue the following commands:
    mkdir temp cd temp
  6. From the directory, run the jar command to extract install.jar from the installation media:
    jar -xvf <path of installation media>/install.jar
  7. Run the installation script:
    UNIX:
    chmod +x ./install.sh sh ./install.sh
    Windows:
    install.bat
  8. To complete the command-line upgrade, follow the prompts. 
    During an upgrade, default values from the existing 
    Clarity Project and Portfolio Management (PPM)
     installation are automatically entered as responses to the prompts.
    See the following list for upgrade property descriptions:
    • Clarity Project and Portfolio Management (PPM)
       Home Directory
      Specifies the directory in which to install 
      Clarity Project and Portfolio Management (PPM)
      . This directory is created if it does not exist.
    • Clarity Project and Portfolio Management (PPM)
       Target Directory (upgrade only)
      Specifies a new install directory for the upgrade process that is different from the current install directory. The default value is the current install directory.
    • JDK 1.8.0 Home Directory
      The Java JDK home directory IBM Java 8 (64-bit):1.8.0. Only AIX is supported for use with WebSphere.
    • Beacon Multicast Address
      The multicast address that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. The multicast address must be in the Class address range between 224.0.0.0 and 239.255.255.255. Each server within a cluster must use the same address and port. 
      Default value: 230.0.0.1
      We recommend an IP address in the 239.x.x.x subnet.
    • Beacon Multicast Port
      The port that the Beacon and 
      Clarity Project and Portfolio Management (PPM)
       System Administration use for service discovery. Each 
      Clarity Project and Portfolio Management (PPM)
       cluster requires a unique IP address. Each server within a cluster must use the same address and port.
    • Beacon Client Port
      Defines the server port number that the Beacon service uses.
    • Super User Command Prefix
      (UNIX only) The optional command prefix utility, such as sudo, to execute root-level commands. An example where you could implement a root-level command is when choosing a socket port below 1024 because root-level access is required to allocate it.
    • Super User Name
      (UNIX only) The optional replacement for the 
      root superuser
       name. This name can be used alone or with the superuser command prefix. For example, if used with sudo, specify the user to which sudo rights are given here.
    • J2EE Server Vendor
      Specify the J2EE server vendor: Apache Tomcat (default) or Generic J2EE. The supported generic J2EE vendor is IBM WebSphere (for IBM AIX only).
    • Install 
      Clarity Project and Portfolio Management (PPM)
       System Administration (CSA) Locally
      (Apache Tomcat only) Enter one of the following values:
      • If you are installing 
        Clarity Project and Portfolio Management (PPM)
         System Administration on this server, enter 
        true
        .
      • Otherwise, enter 
        false
        .
    • Tomcat 8 Home Directory
      (Apache Tomcat only) Defines the Apache Tomcat home directory.
    • CSA Web Port
      (Apache Tomcat only) Defines the web port number that 
      Clarity Project and Portfolio Management (PPM)
       System Administration uses. For a UNIX system, this value must be greater than 1024; otherwise the service must be run as root.
    • Enter password
      (Apache Tomcat only) Specifies the 
      Clarity Project and Portfolio Management (PPM)
       System Administration password.
      Default value: admin
    • Operator User Name
      Specifies the user name of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Operator Email Address
      Specifies the email address of the operator who is running the installation script. This information is kept as a record in the installation log.
    • Acknowledge reviewing Install Guide and Change Impact & Upgrade Guide
      This prompt records a response from installing users that they have read both 
      Installing and Upgrading
       and 
      Change Impact and Upgrade.
  9. From the J2EE application server administration console (IBM WebSphere), deploy the nsa.ear file to set up 
    Clarity Project and Portfolio Management (PPM)
     System Administration.
    The upgrade script places the nsa.ear file in the 
    Clarity Project and Portfolio Management (PPM)
     home directory on the application server.
    For information about deploying using the administration console, see the appropriate vendor documentation.
  10. Start 
    Clarity Project and Portfolio Management (PPM)
     System Administration and configure the server properties for all servers as needed.
    1. In the left navigation panel, click Servers, and then click the server name.
      The Properties tab for the server appears.
    2. Click each subtab that is listed on the Properties tab and complete the fields necessary for your configuration of 
      Clarity Project and Portfolio Management (PPM)
      .
      For complete information about all of the fields that are found on the subtabs, see
      Clarity Project and Portfolio Management (PPM)
      System Administration (CSA) Server Properties
      .
  11. Package the niku.ear file.
    1. In the 
      Clarity Project and Portfolio Management (PPM)
       System Administration left navigation pane, click Install and Upgrade.
    2. Click Package Application EAR.
    3. Click Create Package.
      A Status window appears and displays the status until the EAR file is created in the Clarity home directory:
      <clarity home>/niku.ear
  12. Start the Beacon service on all servers in the cluster.
    The Beacon service is required to remotely distribute the upgraded content to servers in the cluster.
  13. To update all servers that contain a 
    Clarity Project and Portfolio Management (PPM)
     installation (that is, servers that may be running standalone bg services), select Distribute All in the left navigation pane.
  14. When the Distribute All command completes, complete these steps:
    1. Stop the Beacon service.
    2. Manually copy the following jar files from the administration server that runs 
      Clarity Project and Portfolio Management (PPM)
       System Administration to all the remaining servers in the cluster. The jar files replace the existing files in the $CLARITY_HOME/bin AND $CLARITY_HOME/lib directories.
      <install_dir>/bin/wrapper.jar
      <install_dir>/lib/commons-logging.jar 
      <install_dir>/lib/jgroups-all.jar
      <install_dir>/lib/log4j.jar
      <install_dir>/lib/nsa.jar 
      <install_dir>/lib/union.jar
      This extra step avoids any issues that might arise from distributing while files are in use on the administration server.
  15. To verify that the installation steps completed successfully, click Installation Overview in the left navigation pane.
  16. Review the 
    Clarity Project and Portfolio Management (PPM)
     Administration server 
    admin.log
     file for general errors or custom Studio Query (NSQL) validation errors.
  17. Start all services.
    1. Click All Services.
    2. Select the services and click Start.
  18. From the application server administration console (IBM WebSphere), deploy the niku.ear file on all servers in the cluster.
  19. To verify that 
    Clarity Project and Portfolio Management (PPM)
     is accessible from a browser, connect using the configured 
    Entry URL 
    value.
    The Entry URL is configured in 
    Clarity Project and Portfolio Management (PPM)
     System Administration on the Application subtab. If you have multiple application servers, the Entry URL points to the load balancer. If you have a single-server installation, the Entry URL points to the application server.
    The Entry URL has the following format:
    http://<
    server name
    >:<
    port
    >/niku/nu
    The default user ID and password are admin/admin. If the default HTTP port value of 80 is used, you do not have to specify the <port> value.
Complete the Post-Upgrade Tasks
The following post-upgrade tasks are required:
  • Upgrade any add-ins that you intend to use with this release.
    For more information, see
    Install an Add-in
    .
  • Identify the 
    Clarity Project and Portfolio Management (PPM)
     views that were upgraded automatically and the views that you must upgrade manually.
  • Configure portlets and portlet pages as appropriate to expose or hide the new functionality after the upgrade.
  • Update rights assignments for users, groups, or OBS instances with new or updated security rights that are introduced in this release.
  • If you are upgrading with XDM, ensure that the XDM is distributed to other servers in the cluster.
  • Run the Oracle Table Analyze Job from 
    Clarity Project and Portfolio Management (PPM)
     after the upgrade is done to gather schema statistics. The expected time for this job to complete depends on the size of the database. We recommend that you run this job right after the upgrade and at off peak hours thereafter.
    If you use a custom statistics job, refer to the updated Oracle Table Analyze Job procedure in the 
    Clarity Project and Portfolio Management (PPM)
     schema in Release 14.2 (CMN_JOB_ANALYZE_SP) and make necessary corrections in the custom statistics job.
Verify NSQL Queries
During the upgrade process, the NSQL validator script runs to verify the NSQL queries. The validator writes the results to the admin.log file.
Look for the following information in the log:
  • Query name
  • Query ID
  • Content Source
  • Query ID from CMN_NSQL_QUERIES of the query that failed validation
To ensure that portlets work correctly, correct any invalid queries. If a query is associated with a portlet, clear the
Available for User Portlets
check box on the query properties page to edit the query. You cannot edit system queries that are provided by 
Clarity Project and Portfolio Management (PPM)
.
Follow these steps:
  1. Open Administration, and from Studio, click Queries.
  2. Open a query.
  3. Clear the Available for User Portlets check box.
  4. Click Save and Continue.
  5. Review the errors and repair the broken query constructs or fields.
  6. To confirm that the NSQL query is valid, click the Preview button.
  7. Click the General tab.
  8. Select the Available for User Portlets check box.
  9. Click Save and Return.
Some NSQL queries are delivered with add-ins. Applying an update for an add-in makes fixes for the NSQL queries that pertain to the add-in available for an update on the server.