Install CA PPM
Before you install cappm, plan the installation and all environment details. Repeat the configuration planning process for the pilot, test, QA, training, and production environments.
Before you install
Clarity PPM, plan the installation and all environment details. Repeat the configuration planning process for the pilot, test, QA, training, and production environments.
: The following resources help you plan your installation or upgrade:
Use the following checklist to assist you with new installations:
SaaS administrators can skip the hardware-related configuration items that do not apply.
Video Series: Installation
The following videos help you install
Clarity PPMin on-premise environments:
Video: Prepare for Clarity PPM Installation
Video: Install Clarity PPM
Video: Configure Clarity PPM CSA
- If you are re-installing over a previous fresh install or migrating to a new server, you can backup your installation directory and database. Otherwise, skip this step and perform a new install.
- Verify the third-party software that is supported for this release. SeeCompatibilitiesin the Release Notes (On Premise).
- Verify that you have the required license key information to install some third-party software products. See the documentation or readme file on the installation media.
- Verify that you have administrator rights for the servers.
- Disable any custom database triggers, custom unique restraints, or antivirus scanners that can interfere with the installation scripts.
- Spaces in the PATH variable may cause difficulty on a Windows server. You can escape the entries using quotes. Another option is to replace the entries with their short 8.3 file names. For example, to escape the spaces, change the entry ;C:\Program Files (x86)\;to;"C:\Program Files (x86)\";In this example, the spaces can also be avoided with the short nameC:\Progra~2\:To determine short file names for a path, see the Microsoft Windows documentation.
- Verify you can access the installation media and database images.Clarity PPMuses a backup-based database deployment mechanism. Instead of building the database during the installation, a pre-built, fully populated database backup base image is provided on the installation media. The image contains everything that a new installation requires. The installation media contains the following base images:
: Mirroring and replication of theClarity PPMdatabase (SQL Server or Oracle) are not supported.
- A Microsoft SQL Server base image that is compatible with all supported SQL Server versions.
- An Oracle base image that is compatible with all supported Oracle versions.
- Verify that you do not install a test or development environment on the same server as a production environment.
- As a database administrator, follow the Oracle or Microsoft SQL Server documentation to install the database software. Verify that the database software is operational before you configure it forClarity PPM.
Manage Services with CSA
During and after the installation, use CA PPM System Administration (CSA) to stop, start, and monitor the services in the cluster. The Jaspersoft and database servers are unmanaged, a standard practice for most organizations.
CSAwas formerly known as, and is still referred to as,
Clarity PPMis comprised of the server services that run on the application server. By default, all services are
managed. A managed service is one that is started, stopped, and monitored from CSA using local beacon services running on each system.
Most of the services can be left unmanaged, if desired. An unmanaged service operates the same as a managed service with one difference: The CSA application cannot control or monitor an unmanaged service. The database server, the reports server, and the application server (in some instances) can be unmanaged.
Clarity PPMservices include:
- app:Theapplication servicehandles client requests. You can use one or moreappservices for each cluster. You can configure multiple instances for each server. The app server is always managed.
- beacon:Thebeacon serviceis used to manage a cluster. You can use one beacon service for each server in the cluster.
- bg:You can use one or morebackground servicesfor each cluster. You can configure multiple instances for each server. You are required to manage bg services.
- db:You can use one Oracle or Microsoft SQL Serverdatabase servicefor each cluster. Databases can be managed or unmanaged.
- nsa:Thesystem administration serviceis always managed.You can use one nsa service for each cluster.
Database Backup Images for New Installations
Clarity PPMuses a backup-based database deployment mechanism. The installation media provides two pre-built, fully populated database backup
base images. The base images contain everything that a new installation requires.
Backup images are available for the application and data warehouse databases. If you use Advanced Reporting with Jaspersoft, the data warehouse database is required.
The installation media contains the following images:
- The Microsoft SQL Server base image, compatible with all supported SQL Server versions.
- The Oracle base image, compatible with all supported Oracle versions.
Configure a PPM Database with Oracle
Install Oracle. Follow the third-party documentation. We do not recommend the default Oracle feature where it attempts to automatically install and configure a database for you. Create a CA PPM (formerly niku) database, ppm tablespaces, and database user. Then import the database schema from the database backup file on the CA PPM installation media.
Complete the following tasks in the order presented to configure Oracle for use with
- For extended character handling on an Oracle server, set the NLS language to AL32UTF8.
- UNIX: Edit the UNIX user profile to add the NLS_LANG variable:NLS_LANG=AMERICAN_AMERICA.AL32UTF8EXPORT NLS_LANG
- Windows:Start the registry editor:
- From the Start menu, select Run, and enterregedit.
- Go toHKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\<and change the value for key NLS_LANG to:Oracle Home>AMERICAN_AMERICA.AL32UTF8
- Set the required parameters in the following table for your new database:NameValueCharacter SetAL32UTF8National Character SetUTF8/AL16UTF16nls_date_formatYYYY-MM-DD HH24:MI:SSnls_sortBINARYnls_compBINARYquery_rewrite_enabledtrueCursor_sharingFORCE
- Set the following parameter values to optimize performance when runningClarity PPMwith Oracle 18.104.22.168:
- Set the following parameter values to optimize performance with Oracle 22.214.171.124:
: Also apply the optional fix for a known performance issue with Oracle. SeePost-Install: Optimize Oracle 12c Performancenear the end of this page.
- The following initNIKU.ora file uses Automatic Memory Management (AMM). The following samples are the recommended parameter settings. However, you can adjust the settings according to your environment.
*.audit_file_dest='C:\apps\oracle\admin\niku\adump' *.audit_trail='db' *.compatible='126.96.36.199' *.control_files='C:\apps\oracle\oradata\niku\control01.ctl','C:\apps\oracle\oradata\niku\control02.ctl' *.cursor_sharing='FORCE' *.db_block_size=8192 *.db_domain='' *.db_name='niku' *.diagnostic_dest='C:\apps\oracle' *.job_queue_processes=20 *.memory_max_target=16G *.memory_target=12G *.nls_comp='binary' *.nls_date_format='YYYY-MM-DD HH24:MI:SS' *.nls_sort='binary' *.open_cursors=1000 *.processes=1000 *.remote_login_passwordfile='EXCLUSIVE' *.sessions=1000 *.session_cached_cursors=1000 *.sga_max_size=0 *.sort_area_size=0 *.streams_pool_size=512M
*.compatible='188.8.131.52' *.control_files='/niku/oracle/oradata/niku/control01.ctl','/niku/oracle/oradata/niku/control02.ctl','/niku/oracle/oradata/niku/control03.ctl' *.core_dump_dest='/niku/oracle/admin/niku/cdump' *.cursor_sharing='FORCE' *.db_block_size=8192 *.db_cache_size=16777216 *.db_domain='' *.db_file_multiblock_read_count=16 *.db_name='niku' *.diagnostic_dest='/niku/oracle/admin/niku/udump' *.filesystemio_options='SetAll' *** for non ASM instances. *.job_queue_processes=20 *.memory_max_target=16G *.memory_target=12G *.nls_comp='binary' *.nls_date_format='YYYY-MM-DD HH24:MI:SS' *.nls_sort='binary' *.open_cursors=1000 *.processes=1000 *.remote_login_passwordfile='EXCLUSIVE' *.sessions=1000 *.session_cached_cursors=1000 *.sga_max_size=0 *.sga_target=0 *.sort_area_size=0 *.streams_pool_size=512M *.undo_management='AUTO' *.undo_tablespace='UNDOTBS1' *** The memory target and tablespace sizes can be adjusted depending upon the customer implementation. If customers are using Linux Huge pages, the DBA can disable AMM and use SGA and PGA instead, until Oracle supports AMM and Linux Huge pages. SQLNET.ora parameters: NAMES.DIRECTORY_PATH= (TNSNAMES, EZCONNECT) SQLNET.INBOUND_CONNECT_TIMEOUT = 0
Create the Required Oracle Tablespaces (Sample Script)
To create the required tablespaces for
Clarity PPMto work with Oracle, use the following script and adjust the size as appropriate. The Oracle software and database instance must already be created.
The schema in the backup is NIKU, and the tablespaces are shown in the following example:
CREATE TABLESPACE "USERS_LARGE" DATAFILE '<ORACLE_BASE>\ORADATA\<SID>\USERS_LARGE.DBF' SIZE 2G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 10G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE TABLESPACE "USERS_SMALL" DATAFILE '<ORACLE_BASE>\ORADATA\<SID>\USERS_SMALL.DBF' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 4G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE TABLESPACE "INDX_LARGE" DATAFILE '<ORACLE_BASE>\ORADATA\<SID>\INDX_LARGE.DBF' SIZE 2G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 10G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE TABLESPACE "INDX_SMALL" DATAFILE '<ORACLE_BASE>\ORADATA\<SID>\INDX_SMALL.DBF' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 4G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO;
Example: Creating Tablespaces
ORACLE_BASE= c:\apps\oracle SID=NIKU CREATE TABLESPACE "USERS_LARGE" DATAFILE 'C:\APPS\ORACLE\ORADATA\NIKU\USERS_LARGE.DBF' SIZE 2G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 10G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE TABLESPACE "USERS_SMALL" DATAFILE 'C:\APPS\ORACLE\ORADATA\NIKU\USERS_SMALL.DBF' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 4G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE TABLESPACE "INDX_LARGE" DATAFILE 'C:\APPS\ORACLE\ORADATA\NIKU\INDX_LARGE.DBF' SIZE 2G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 10G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; CREATE TABLESPACE "INDX_SMALL" DATAFILE 'C:\APPS\ORACLE\ORADATA\NIKU\INDX_SMALL.DBF' SIZE 1G REUSE AUTOEXTEND ON NEXT 1G MAXSIZE 4G LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO;
Clarity PPMDatabase Required Oracle User Privileges
The following sample script shows the required privileges for a CA PPM schema user.
CREATE USER <ppm> IDENTIFIED BY <ppm> DEFAULT TABLESPACE users_large TEMPORARY TABLESPACE TEMP PROFILE DEFAULT; GRANT CREATE SESSION TO <ppm>; GRANT ALTER SESSION TO <ppm>; GRANT CREATE TABLE TO <ppm>; GRANT CREATE TRIGGER TO <ppm>; GRANT CREATE VIEW TO <ppm>; GRANT QUERY REWRITE TO <ppm>; GRANT CREATE PROCEDURE TO <ppm>; GRANT CREATE JOB TO <ppm>;
Import the CA PPM Application Database Backup Image (Oracle)
The Oracle database backup that
Clarity PPMprovides contains the complete schema that is needed for a new installation. The schema in the backup is NIKU, and the tablespaces are:
If you need a schema or tablespace remapping, use the Datapump options. For complete information about database import operations and the available options for using the Oracle Datapump, search the Oracle website.
Follow these steps:
- On the CA PPM installation media, locate the Oracle database image in the<root>/databasefolder.
- Save the database backup to a location on the database server.
- Initiate a sqlplus session as the system user and create an import directory:
- To log in to sqlplus, enter the following command:> sqlplus system/<system_password>
- In sqlplus, run the query to create an import directory.SQL> create or replace directory import_directory as '<database backup location>';
- Exit sqlplus.
- To initiate the import, issue the following command:> impdp system/<system_password> DIRECTORY=import_directory transform=oid:n DUMPFILE=oracle_base.db SCHEMAS=niku LOGFILE=import.logAn import.log is generated in the same location as the database backup. Import errors are expected as there are dependencies between the imported items. Once the import has completed, you can recompile the database to resolve invalid objects.If you are using different tablespaces than the ones provided in the backup image, provide tablespace remapping parameters. For information about tablespace remapping parameters, see the Oracle documentation for impdp.
- To compile invalid objects from the import, log in to sqlplus as the sys user (sysdba)and issue the following command:SQL> @utlrp.sqlThe utlrp.sql and utlprp.sql scripts are provided by Oracle to recompile all invalid objects in the database. They are located in the$ORACLE_HOME/rdbms/admindirectory.
- To recompile invalid objects from the CA Clarity PPM Install bin folder, run the following command:admin db compile
Configure Oracle Database Connectivity and Net Service Name
On Windows servers, the Database Configuration Assistant automatically creates the CA PPM service. If the service name is sufficient, you can skip this step.
- Verify that the NLS language setting in the operating system is AL32UTF-8.
- Configure an Oracle net listener service. During Oracle installation, the Oracle Net Configuration Assistant is typically launched automatically to create the default listener. If necessary, start the Oracle Net Configuration Assistant for UNIX or Windows using the appropriate command:
- UNIX:<oracle home>/bin/netca &
- Windows:Click theStartMenu, and choosePrograms, Oracle,Oracle Home,Configuration and Migration Tools, Net Configuration Assistant
To create the TNS listener, use the information in the following table:
Oracle Net Configuration Assistant Screen
Local Net Service Name Configuration
Net Service Name Configuration
Enter the service name provided during the Oracle database installation.
<database server name>
- If you already have a configured TNS Listener on the server, you can skip is step.
- If you are using a third party tool (for example, AuqaData Studio) to connect externally to the Oracle Database, note the following tip from Oracle as a workaround for an existing bug:
In Oracle 12.1, the default value for the SQLNET.ALLOWED_LOGON_VERSION parameter has been updated to 11. This change causes 10.2.0.5 Oracle RAC database creation using DBCA to fail with the following error:
ORA-28040: No matching authentication protocol error in 12.1 Oracle ASM and Oracle Grid Infrastructure environments.
Database clients using pre-11g JDBC thin drivers cannot authenticate to 12.1 database servers unless the
SQLNET.ALLOWED_LOGON_VERSIONparameter is set to the old default of 8.
Workaround: Set the following parameter values in the
New! Limited CA Support is Available for Oracle Multitenant
Oracle 12c introduces multitenancy (MT), pluggable database (PDB) capabilities, and new encryption.
Oracle Multitenant architectures for next-generation cloud databases deliver isolation, agility, and scale. A multitenant container database can hold many pluggable databases. An existing database can simply be adopted with no application changes required. Oracle Multitenant fully complements Oracle Real Application Clusters, Oracle Active Data Guard, and other options.
Follow these steps:
- As a database administrator, install and configure your Oracle MT enabled database. No support from CA is available or required for these steps:
- You can create a container in a test environment for CA PPM 15.3 or higher.
- Create your PDB, directory, and permissions.
- Query your PDB and resolve any connection issues.
- Log in to CSA.
- On theOverviewpage, click the link for your CA PPM server instance.
- Click theDatabasetab.
- UnderInternal Connection: Niku, CSA shows your PDB status asUnavailableuntil you complete the following configuration steps.
- Select theSpecify URLcheck box.TheJDBC URLfield appears with default values that include anSIDassignment. For example:jdbc:clarity:oracle://my_ppm_server:1818;SID=niku;BatchPerformanceWorkaround=true;InsensitiveResultSetBufferSize=0;ServerType=dedicated;supportLinks=true
- Set theServiceNameparameter to the name of your PDB.
The following image shows a new configuration example:
JDBC URLstring shows another example:
jdbc:clarity:oracle://server1:1115; ServiceName=serviceTNS; BatchPerformanceWorkaround=true; InsensitiveResultSetBufferSize=0; ServerType=dedicated; supportLinks=true; AlternateServers=(server2:1115;server3:1115);
Clarity PPMDatabase with Microsoft SQL Server
Instead of Oracle, you can use Microsoft SQL Server. After you install SQL Server, complete the following tasks to import and configure the database for use with
- Set up valid login credentials forClarity PPM. This login name and password are the values that you specify in CSA to log in to the database. The login name and password can be any combination.
- Set the Microsoft SQL Server Database Schema name toniku.
- Import the database backup image. On theClarity PPMinstallation media, locate the MSSQL database image in the<root>/databasefolder.
- Save the database backup to a temporary location on the database server.
- Use the Restore Database tool in Microsoft SQL Server Management Studio to restore the base image.To database: nikuFrom device: c:\<temporary location you saved the database image to> \mssql_base.db
- Verify the import. Remove the temporary folder and its contents.
- Associate the imported database with your SQL server security user by running the following pl/sql as the sa user:USE niku ALTER USER niku WITH LOGIN=<your security user>
- To grant theVIEW SERVER STATEpermission to the<your security user>user, use the following command:GRANT VIEW SERVER STATE to <your security user>
Review the Imported SQL Server Database Options
Mixed collations settings are not supported. If you change the server-level default from SQL_Latin1_General_CP1_CI_AS to another collation, create a new SQL Server instance with the correct collation SQL_Latin1_General_CP1_CI_AS before creating the
The import procedure creates the database with the options in the following table. Review these options to verify that they meet your requirements.
To apply, execute:
ALTER DATABASE <database>
SET ARITHABORT ON
ALTER DATABASE <database>
SET ANSI_NULLS ON
ALTER DATABASE <database>
SET QUOTED_IDENTIFIER ON
MS SQL 2014: 120
To apply, execute:
EXEC SP_DBCMPTLEVEL <database>, 120
MS SQL 2016: 130
To apply, execute:
EXEC SP_DBCMPTLEVEL <database>, 130
Database Schema Name
The login name can be anything, but the default schema name for the login user must be
Database user roles
The database user must be able to alter the
Clarity PPM-schema and otherwise own the database.
READ COMMITTED SNAPSHOT
To apply, execute:
ALTER DATABASE <database>
SET READ_COMMITTED_SNAPSHOT ON
Granted to database user. To apply, execute:
REMOTE QUERY TIMEOUT
sp_configure 'remote query timeout',0
reconfigure with override
Configure the Tomcat Application Server
- Keep your systems up to date with the latest patches. See your vendor documentation for more information.
- Install the appropriate versions of the following software on each server that you plan to include in a cluster. The products that you install on a server depend on the services the server runs.ServiceRequired ProductDatabase service (db)Oracle or Microsoft SQL ServerClarity System Administrator service (nsa),Clarity PPMApplication (app) serviceApache TomcatClarity PPMBackground service (bg), Beacon serviceJava JDK only
- Some third-party library JAR files (currently, jgroups-all.jar and xinclude.jar) are shipped separately from the image. The install.jar image does not contain the third-party files. Any install packages for a previous version ofClarity PPMthat are included in the install.jar also exclude the JAR files. For each release, the files are bundled into a third-party JAR library file. The file name uses the following format:thirdparty.libs.<release number>.jar(for example, thirdparty.libs.15.3.0.jar). To make the files available, retrieve the thirdparty.libs.<release number>.jarIf you place the JAR file in the installation directory, the installer does not prompt you for the location of the file.
- Install Java. All new installations or upgrades require Java. Depending on your environment, you may also require previous JDKs. If you are upgrading from a version earlier than Release 13.1, both Java 8 and Java 7 are required. If upgrading from 13.2 or any higher release to 15.5.0 you need Java 8 and then Java 11 if you plan to continue to 15.5.1 or higher. Navigate to the installation media that you downloaded, or download the latest JDK from the vendor website.
- On Linux, log in to the server as root and go to the cd /usr directory. Extract the jdk.tar.gz file. By default, the JDK is installed in /usr/ path.
- On Windows, run the following command from your download location:<drive>\Java\jdk-x-windows-x64.exeFollow the on-screen instructions but do not use the default Program Files directory. The JDK is installed by default in C:\program files\javaClarity PPMcannot have spaces in the folder path to the JDK. To simplify the installation, install the JDK in a root directory (for example, C:\JDK).
- Set or update the environment variables (JAVA_HOME and PATH) to point to the new JDK.
- The Java Runtime Environment (JRE) is updated frequently with fixes for security issues, including issues that are unknown at the timeClarity PPMis released. To ensure that you have the latest fixes, download the most recent JDK from the Oracle website.Clarity PPMdoes not require the public JRE installation. For the minimum software requirements for this release, see the CA PPM 15.3 Release Notes.
Configure Java Environment Variables on the Application Server
Linux: To update the environment variables on Linux, edit the user (.profile) file and add or modify the following system variables:
- JAVA_HOME: Shell scripts use this variable to locate the correct Java home directory. For example:JAVA_HOME=/<Java home directory>export JAVA_HOMERed Hat and SUSE Linux both use the following default Java home location:/usr/jdkx.y.z_xx
- PATH:Locates the command-line utilities. Add the following information to the beginning of the existing PATH system variable:PATH=/<clarity home>/bin:$JAVA_HOME/bin:$PATHexport PATH
Windows: To update the environment variables on Windows, open the Control Panel and add or modify the following system variables:
- JAVA_HOMESpecifies the JDK home directory only, and is not a path variable. Therefore, onlyValue: <Java home directory>The JAVA_HOME value cannot contain the semi-colon (;) character. If the value has a trailing backslash (\) at the end, the checkinstall script skips all scripts.
- PATHLocates the command-line utilities. Add the following information to the beginning of the existing PATH system variable:Value: <clarity home>\bin;%JAVA_HOME%\bin;%PATH
Perform the Pre-Install Script Steps
- Verify that the database setup is complete.
- Install Apache Tomcat on one or more application servers:
- Navigate to the installation media that you downloaded and locate the apache-tomcat-8.x.zip file.
- Copy the file to the root directory or create an application directory (/tomcat).
- Extract the .zip file using the following command:jar xvf <drive>/Tomcat/apache-tomcat-8.x.zipThe apache-tomcat application is created in the folder where you extracted the files. This folder becomes the Apache Tomcat home directory.
- Verify that the appropriate third-party software has been installed on all of the servers that you plan to use in the cluster.
- Familiarize yourself with CSA. To complete the configuration after you run the installation script, use CSA. For an Apache Tomcat J2EE application server, the installation script installs and starts CSA automatically.
- Every server in a cluster must have the same multicast address value. The nsa service uses the address to discover the Beacon services in the cluster. This value is defined in the Server Properties in CSA.
- Designate one server as the administration server.
- The HTTP and HTTPS Entry URL fields for the server in CSA cannot belocalhostwhen Jaspersoft is integrated withClarity PPM. When you use Jaspersoft, the URLs must be explicitly entered on the Application subtab of the Properties tab for theClarity PPMserver. For example:HTTP Entry URL: http://<server name>:<port> HTTPS Entry URL: https://<server name>:<port>
Run the Installation Checker (checkinstall)
Run the Installation Checker (checkinstall) on the designated server for a new installation or upgrade. Although this utility runs automatically at the start and end of installations and upgrades, you can also run it as a standalone utility to verify that your system is ready for the installation.
The utility detects the following:
- Disk Space
- Oracle Database Table-Space and Partitioned Tables
- Duplicate GL Allocation Slices
- Duplicate/Multiple Idea-to-OBS Associations
- Seeded Custom Object Code Conflicts
- Invalid Matrix Rows
- Other Validations
The Installation Checker can help you assess a new installation or upgrade before you start the actual process. The Installation Checker runs automatically after an upgrade to validate the success or failure of the upgrade process. The utility produces a zipped report archive file that can help you plan an installation or upgrade.
When the Installation checker is invoked as a standalone utility or automatically at the end of an upgrade attempt, a zipped report archive is created. The archive contains the following files:
- precheck-results.xml and precheck-results.html.
- postcheck-results.xml and postcheck-results.html. These files are present only if the Installation Checker is invoked through the upgrade process.
- install.log (if available).
- database output customization files (if present).
- admin.log from the target directory (if present).
- install.properties (if present).
- checkinstall.properties (if present).
The archive has a timestamp encoded name (for example, checkinstall-results_2018-04-17_16-48-31.zip). The file is located in the checkinstall/check-logs directory, and if possible, the file is copied into the <target runtime dir>/logs/checkinstall directory.
Each individual check produces one of the result codes in the following table with a diagnostic message.
Indicates that the check was successful and no potential problems were detected. Specific advice can be present to aid in planning the installation or upgrade.
Indicates a potential problem. Details are contained in the message. Address the problem before running the installation or upgrade.
Indicates a serious installation or upgrade problem. Details are contained in the message. The installation or upgrade process does not continue when one or more error conditions exist.
The following image shows a sample pre-check results page:
Follow these steps:
- Extract theClarity PPMinstaller to theClarity PPMapplication server.
- Open a command prompt and navigate to the checkinstall directory located in the directory to which you extracted the installer.
- Invoke the checkinstall command:LINUX:sh checkinstall.shWindows:checkinstall.batYou are asked for the Operator Username and Operator Email. This information refers to the user who is upgrading or installing and the email of the user. This information is stored as a record in the installation log.
- When you run checkinstall.sh on Linux, anunexpected end of fileerror might occur. As a workaround, convert the script with dos2unix and then run it again.dos2unix ./checkinstall.sh dos2unix: converting file ./checkinstall.sh to Unix format ... sh ./checkinstall.sh(Optional) You can also use the following perl script to run checkinstall:perl -i -pe 'y|\r||d' checkinstall.sh
- Verify the results. The results include any warnings and errors, and also indicate customizations made to the application. Review the customizations and make adjustments for the upgrade as necessary.
Video: Checkinstaller Utility
The following video is provided by CA Technologies.
To play this video in full-screen mode, click the YouTube logo at the bottom of the video.
Clarity PPMInstallation Script
If you are installing a cluster, run the installation script on
each serverthat you plan to include in the cluster. When the installation script finishes, the installation process is not yet complete. Finish the installation tasks and configuration using the
Clarity PPMSystem Administration application.
Clarity PPMSystem Administration password that is created during the installation. The password is required to log in to
Clarity PPMSystem Administration and complete the installation.
During the Apache Tomcat installation, you are asked if you want to install
Clarity PPMSystem Administration locally. Enter
truefor the administration server only. For other servers in the cluster, enter
Follow these steps:
- From the command prompt, navigate to the directory where you want to unpack the installer file, and type the following commands:mkdir temp cd temp
- From the directory, run the JAR command to extract install.jar from the installation media:jar -xvf <path of the installation media>/install.jar
- Run the installation script using the following commands:LINUX:chmod +x ./install.sh sh ./install.shWindows:install.bat
- To complete the command-line installation, follow the on-screen instructions. The workflow and instructions for an installation appear in a single phase at the beginning.See the following list for installation property descriptions:
- Third Parties Libraries Jar DirectorySpecifies the directory where the installer can find the thirdparty.libs.14.1.0.jar file when the file is not in the current directory.
- Clarity PPMHome DirectorySpecifies the directory in which to installClarity PPM. This directory is created if it does not exist.
- JDK Home DirectoryThe required Java JDK version as specified in the release notes. For example: C:\JDK, /usr/jdk, or /usr/Java_x_64.
- Beacon Multicast AddressThe multicast address that the Beacon andClarity PPMSystem Administration use for service discovery. EachClarity PPMcluster requires a unique IP address. The multicast address must be in the Class address range between 184.108.40.206 and 220.127.116.11. Each server within a cluster must use the same address and port.Default value: 18.104.22.168We recommend an IP address in the 239.x.x.x subnet.
- Beacon Multicast PortThe port that the Beacon andClarity PPMSystem Administration use for service discovery. EachClarity PPMcluster requires a unique IP address. Each server within a cluster must use the same address and port.Default value: 9090
- Beacon Client PortDefines the server port number that the Beacon service uses.Default value: 9091
- Super User Command Prefix(UNIX only) The optional command prefix utility, such as sudo, to execute root-level commands. For example, you can implement a root-level command 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 theroot superusername. 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 using sudo, set this value to the user name of the user installing and runningClarity PPM. If you are not runningClarity PPMas root, set this value to the user name of the user who runsClarity PPMservices.
- InstallClarity PPMSystem Administration (CSA)(Apache Tomcat only) Specifies whether to installClarity PPMSystem Administration on the current server. Enter one of the following values:
- If you are installingClarity PPMSystem Administration on this server, entertrue.
- Otherwise, enterfalse.
- Tomcat 8 Home Directory(Apache Tomcat only) Defines the Apache Tomcat 8 home directory.
- CSA Web Port(Apache Tomcat only) Defines the web port number thatClarity PPMSystem Administration uses in a UNIX system. This value must be greater than 1024; otherwise, the service must run as root.Default value: 8090
- Enter password(Apache Tomcat only) Specifies theClarity PPMSystem Administration password.Default value: admin
- Operator User NameSpecifies 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 AddressSpecifies 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 GuideThis prompt records a response from installing users that they have read bothInstalling and UpgradingandChange Impact and Upgrade.
Post-Install: Complete the Installation
These steps explain how to complete the
Clarity PPMinstallation in a configuration running the Apache Tomcat application server.
Follow these steps:
- If not added, deployed, and running, you may need to run the following command to add, deploy, and start the NSA:./service add deploy start nsa
- Log into CSA (formerly NSA). For example, log in to http://HOSTNAME:8090/niku/app using the password you created during the installation, and add, deploy, and start the background, and app services. If you specified a CSA port number other than 8090, use that value instead.
- In the left navigation panel, clickServersand select the local server.
- Click each subtab that is listed on thePropertiestab and complete the fields necessary for your configuration ofClarity PPM. Most installations should use multicast messaging. In fact, clustered Jaspersoft environments are required to use multicast. However, limited support is available for using JDBC PING as an alternative. See CSA: Multicast Messaging and the topic below it titledCSA: Configure JDBC PING as an Alternative to Multicast.
- Set theBind Addressto the IP address of the primary NIC on the server. If the server is part of a cluster, ensure that this IP address is on an IP subnet that includes the other servers as members. Set the bind addresses of the other servers to their IP address. Set the bind address for multicast to work properly. If you change the multicast address or the bind address, you can receive a system error as you navigate away from the subtab page. If you receive an error, log out from CSA, and then log back in and continue the configuration.
- To learn more about other fields, see CSA: CA PPM System Administration.
- Add the application and background services.
- ClickAll Services.
- ClickAddto see the available services.
- Select theClarity PPMApplication andClarity PPMBackground services and clickAdd.
- Select all the services and clickDeploy.
- Select all the services and clickStart
- Run the admin warmup command:admin warmup -url <applnURL> -user <UserID> -password <Password> -verbose
- Run the admin warmup command:admin warmup -url <applnURL> -user <UserID> -password <Password> -verbose
- To verify thatClarity PPMis accessible from a browser, connect using the configuredEntry URLvalue. The Entry URL is configured in CSA on the Application subtab. If you have multiple application servers, the Entry URL points to the load balancer. If you have only one server installed, the Entry URL points to the application server. The Entry URL has the following format:http://<server name>:<port>/niku/nuThe 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.
- Change your default password.
- Install any add-ins that you intend to use with this release. See Add-Ins and Integrations.
- Identify theClarity PPMviews that require configuration before business users can access them.
- Configure portlets and pages as appropriate to expose or hide any new functionality available in the new release.
- Update access rights for users, groups, or OBS instances with new or updated security rights that are introduced in this release. ClickAdministration,Resourcesand add most if not all global access rights to the admin user.
Post-Install: Verify the Installation
You can run a health check on any server. The health check generates a report for each server that is selected and verifies aspects of the installation. The report contains a list of categorized line items, each with an associated status. Examples of line items include the testing of ports, database parameters, and third-party software product installation.
Follow these steps:
- Log in toClarity PPMSystem Administration (CSA).
- On the Overview page, select the check box next to each server that you want to include in the report, and click Run Health Check.
- View the log files in CSA for the servers in a cluster:
- Click Servers in the left navigation pane.
- Click the server name and click Logs.
- In the Log File field, select the log file that you want to view and click Go. Limit the amount of data by selecting a value in the Max Size field.
- (Optional) To download the file, click Download and specify a target location.
- Verify the time settings are identical. For functionality and accuracy of data inClarity PPMand all jobs, including the Load Data Warehouse Job, verify the following:
- The server time is the same (preferable, down to the second) on theClarity PPMapplication server,Clarity PPMdatabase server, and Data Warehouse database server.
- The timezone, date, and time is the same on theClarity PPMapplication server and database servers in the same environment. Do not allow any differences.
- Continue configuring your new installation ofClarity PPMwith CSA. See CSA: CA PPM System Administration.
Post-Install: Optimize Oracle 12c Performance
On local installations of Oracle 12c R1 or R2, you might detect a regression issue with Oracle 12c when ORDERED hint is used in structured queries. An Oracle bug in 12c R2 can degrade performance if the optimizer is set to 22.214.171.124.
- For systems using Oracle 12c R1 (126.96.36.199), no further action is required.
- For systems using Oracle 12c R2 (188.8.131.52), you can optimize performance by setting the optimizer to 184.108.40.206. We recommend applying this optional local fix.
Follow these steps:
- From a command prompt in Oracle, enter the following lines:sqlplus / as sysdba ALTER SYSTEM SET "_fix_control" = '17800514:0'; Exit;
- Run the following command:ALTER SYSTEM SET OPTIMIZER_FEATURES_ENABLE= '220.127.116.11' SCOPE=BOTH;
- Verify that your Oracle 12c R2 initialization file parameters appear similar to the following example:*._fix_control='17800514:0'*._optimizer_multi_table_outerjoin=FALSE*.audit_file_dest='/fs0/oracle/12201/12c/admin/niku/adump'*.audit_trail='DB'*.cluster_database=FALSE*.compatible='18.104.22.168'*.control_files='/fs0/oracle/12201/12c/oradata/niku/CONTROL01.CTL','/fs0/oracle/12201/12c/oradata/niku/CONTROL02.CTL'*.cursor_sharing='FORCE'*.db_block_size=8192*.db_name='niku'*.diagnostic_dest='/fs0/oracle/12201/12c/admin/niku/udump'*.dispatchers='(PROTOCOL=TCP) (SERVICE=nikuXDB)'*.local_listener='LISTENER_NIKU'*.nls_comp='BINARY'*.nls_date_format='YYYY-MM-DD HH24:MI:SS'*.nls_language='AMERICAN'*.nls_sort='BINARY'*.nls_territory='AMERICA'*.open_cursors=1000*.optimizer_adaptive_plans=false*.optimizer_adaptive_reporting_only=TRUE*.optimizer_adaptive_statistics=FALSE*.optimizer_features_enable='22.214.171.124'*.optimizer_inmemory_aware=FALSE*.pga_aggregate_target=4G*.processes=1000*.remote_login_passwordfile='EXCLUSIVE'*.session_cached_cursors=1000*.sessions=1536*.sga_target=80G*.streams_pool_size=536870912*.trace_enabled=TRUE*.undo_tablespace='UNDOTBS1'