Escolar Documentos
Profissional Documentos
Cultura Documentos
3:
InstallationwithMS/SQL200
<Brand><Product>
Clarifier(whatcomesafterthecolon)
LabGuide
LabGuide
33CLR24019 <coursecode>
33CLR2401LG1 <inventorycode>
PROPRIETARYANDCONFIDENTIALINFORMATION
2016CA.Allrightsreserved.CAconfidential&proprietaryinformation.ForCA,CAPartnerandCA
Customeruseonly.Nounauthorizeduse,copyingordistribution.Allnamesofindividualsorofcompanies
referencedhereinarefictitiousnamesusedforinstructionalpurposesonly.Anysimilaritytoanyreal
personsorbusinessesispurelycoincidental.Alltrademarks,tradenames,servicemarksandlogos
referencedhereinbelongtotheirrespectivecompanies.TheseMaterialsareforyourinformational
purposesonly,anddonotformanytypeofwarranty.Theuseofanysoftwareorproductreferencedinthe
Materialsisgovernedbytheendusersapplicablelicenseagreement.CAisthemanufacturerofthese
Materials.ProvidedwithRestrictedRights.
CAPPM14.3:I
C InstallationwitthMS/SQL2000
Lab11In
nstallJ2SESDKonWindows1
Lab12SSetUpEnviro
onmentVariiables2
Lab21In
nstallApach
heTomcat5
nstallCAPPM7
Lab31In
Lab41C
CreatetheCA
APPMDatabase11
Lab42C
CreatetheCA
ADataWare
ehouseDataabase14
Lab51In
nstallTomcaatforJasperrsoft19
Lab52C
CreatetheCA
APPMJaspe
ersoftSQLSe
erverDatabaase21
Lab53In
nstallJasperrsoftonWindows23
Lab54C
ConfigureJasspersoft31
Lab61C
ConfigureCA
APPM,DataWarehouse
e,andJasperrsoft33
Lab62In
nstallPMOA
AcceleratorandJasperso
oftContent39
Lab63C
Completethe
eSetupandRunIntegraationJobs41
Lab64R
RunaHealth
hReport48
Lab65SSetLogFileO
Options50
Lab66V
ViewServerLogsinCSA53
Lab71V
ValidatetheCompleteIn
nstallation55
Lab72In
nstallOpenWorkbench57
nstalltheMicrosoftProjjectInterfaccewithSchedduleConnecct60
Lab73In
Lab81B
BackUptheApplication67
Lab82B
BackUptheCAPPMTransactionalD
Database69
Lab83R
RestoretheA
Application71
Lab84R
RestoretheC
CAPPMTran
nsactionalD
Database74
Lab91SScheduleaJo
ob77
Lab92V
ViewtheJob
bLog79
Lab93C
CreateaNew
wJobDefinittion81
Lab94R
RunaReportt85
Lab101MonitorPro
ocessEngine
ePipelines89
Lab102ViewEventMessages91
Lab111CreateaPasswordExprression93
TOC1
2016CA.Allrightsreeserved.
CAPPM14.3:InstallationwithM S/SQL200
LLabChallengge112RevissethePassw
wordExpresssion9
95
A
AppendixA:SolutiontoLabChallengge9
97
AppendixB:CATechnolo
A ogiesDynam
micLabEnvirronment9
99
D
DynamicLab
bEnvironmentAccessan
ndUserGuid
de10
00
SSelfDirected
dLearningAccessandIn
nstructions10
01
B
BestPractice
es10
05
oting10
TTroubleshoo 06
TOC2
T
2016CA.A
Allrightsreserveed.
Module 1: Set Up the Environment
Time 10 - 20 minutes
Instructions:
Note: A demonstration for each of the lab exercises in this course is available from the
C:\LEARNING MATERIALS folder of the training system. A link to this folder is located on the
Desktop. If you have trouble following the lab steps, open the folder and click the
MSSQL_Installation_Lab_Files link to open the list of labs. Then follow the instructions and use the
above lab reference to launch the demonstration.
3. Click Next.
Time 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
4. In the New System Variable dialog, type the following and click OK:
Variable name JAVA_HOME
Variable value C:\CAPPM\Java\jdk1.8.0_40
5. Through Windows Explorer, create the following home folder for the installation of CA PPM:
C:\CAPPM\CAPPM143
6. Return to the System Properties window and click the Advanced tab.
7. On the Environment Variables dialog, under System variables, click New, type the following
variable, and click OK:
Variable name CAPPM_HOME
Variable value C:\CAPPM\CAPPM143
JAVA_HOME is a known environment variable name used by the XML Open Gateway (XOG) and
the CA PPM installer. CAPPM_HOME is not and is therefore optional. However, it can be useful
if the home folder for CA PPM changes location because you will only need to modify the
environment variable and not the PATH variable directly.
It might be useful to test these environment variables to make sure they are set correctly
It is common practice to put Java, Tomcat, and CA PPM into the same C:\CAPPM folder.
Time 5 - 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Time 15 - 20 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Note: Some installation processes can take several minutes to complete. Therefore, you will
sometimes need to wait before proceeding to the next step.
Important: When you open the Command Prompt window for the next series of steps, it is
important to run it as an administrator. This avoids permission issues that might arise when the
installer attempts to register the NSA and Beacon services.
Note: If the command window was not launched with administrator rights, the installer might
throw an error and report Build Failed, while trying to deploy and start the Beacon and NSA
services. However, this is easily remedied. The installation of CA PPM code has been successful. It is
the services installation into the Windows Services subsystem that is failing. To address this issue,
you must manually install Beacon and/or NSA service using the "service add deploy start Beacon"
and "service add deploy start NSA" command strings.
Time 5 - 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the MSSQL
Installation_Lab_Files link to access demonstrations for the labs.
In this lab, you will create the CA PPM database, import the
schema, configure the database options, and test the import.
1. Click Start All Programs Microsoft SQL Server 2012 SQL Server Management Studio.
2. To log in to SQL Server Management Studio, verify the information appears in the fields as
follows and then click Connect:
Server type Database Engine
Server name CLARITYT2
Authentication SQL Server Authentication
Login sa
Password edu2k
10. In the query pane, create the following queries/commands and press Enter:
(These commands can be copied and pasted from the snippets file in C:\Learning Materials.)
13. In the Object Explorer, expand Logins and double-click the niku link.
15. To disconnect from the server, in the left navigation pane, right-click the server name and click
Disconnect.
You do not need to save your query.
23. Close the query pane without saving the changes. The database installation and verification is
complete.
Time 5 - 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the MSSQL
Installation_Lab_Files link to access demonstrations for the labs.
In this lab, you will create the CA PPM Data Warehouse database, import the schema from the
distribution folder, configure the database options create the database link between the Data
Warehouse database and the CA PPM database, and test the CA PPM and Data Warehouse link.
1. Click Start All Programs Microsoft SQL Server 2012 SQL Server Management Studio.
2. To log in to SQL Server Management Studio, verify the information appears in the fields as
follows and then click Connect:
Server type Database Engine
Server name CLARITYT2
Authentication SQL Server Authentication
Login sa
Password edu2k
10. Ensure that the Master database is indicated in the main toolbar, then, in the query pane,
create the following query (these commands can be cut and pasted from the snippets file):
ALTER DATABASE ppm_dwh SET ARITHABORT ON
ALTER DATABASE ppm_dwh SET ANSI_NULLS ON
ALTER DATABASE ppm_dwh SET QUOTED_IDENTIFIER ON
ALTER DATABASE ppm_dwh SET READ_COMMITTED_SNAPSHOT ON
GRANT VIEW SERVER STATE TO ppm_dwh
GO
GRANT ALTER ANY LOGIN TO ppm_dwh
GO
GRANT ALTER ANY LINKED SERVER TO ppm_dwh
GO
SP_DEFAULTDB 'ppm_dwh','ppm_dwh'
GO
USE ppm_dwh
GO
ALTER USER ppm_dwh WITH LOGIN=ppm_dwh
GO
EXEC SP_DBCMPTLEVEL ppm_dwh, 110
GO
use ppm_dwh
Time 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
This lab is executed on the Jaspersoft (reporting) virtual machine. It is assumed that Java has
already been installed on the Jaspersoft vm.
1. Start the Jaspersoft vm, if not already started, and use the Jaspersoft vm for all labs in this
module.
6. Click the Advanced system settings link and click the Environment Variables button
7. Create a new JAVA_HOME environment variable (or update the existing one) with a value of
C:\JDK1.8.0_40 and click OK.
8. Create a new JRE_HOME environment variable (or update the existing one) with a value of
C:\JDK1.8.0_40\JRE and click OK
12. Open a command window as Administrator and verify enter echo %PATH% and verify the value
displayed starts with C:\JDK1.8.0_40\bin;C:\JDK1.8.0_40\JRE\bin;
13. Enter the command java -version and verify version 1.8.0_40 is displayed.
Time 5 - 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the MSSQL
Installation_Lab_Files link to access demonstrations for the labs.
This lab is executed on the CLARITYT2 server
In this lab, you will create the SQL Server database that Jaspersoft uses for its own purposes.
1. Click Start All Programs Microsoft SQL Server 2012 SQL Server Management Studio.
2. To log in to SQL Server Management Studio, verify the information appears in the fields as
follows and then click Connect:
Server type Database Engine
Server name CLARITYT2
Authentication SQL Server Authentication
Login sa
Password edu2k
Time 20 - 40 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
This lab is executed on the Jaspersoft (reporting) virtual machine.
3. Open a command prompt window as administrator and navigate to C:\JSSERVER, and then run
install.bat, answering the questions as follows:
a. Select the Installation Type. To select New, which is the default, press Enter.
c. Accept the default Web App Name of reportservice, and press Enter.
d. Accept the default Web App Port of 8080, and press Enter.
e. Accept the default answer of no for configuring an email server, and press Enter.
f. Accept the default answer of 1 for a Standalone installation, and press Enter.
g. Enter 2 for MS SQL Server to select SQL Server as the database type, and press Enter.
h. Enter the SQL Server Database Hostname. Type CLARITYT2, and press Enter.
i. Enter the SQL Server Database Port Number. Accept the default of 1433, and press Enter.
k. Enter the Jaspersoft Database Username. Type PPM_JASPERSOFT and press Enter.
l. Enter the Jaspersoft Database password. Type ppm_jaspersoft (this was set up in lab 4-2
and it is case sensitive, type carefully) and press Enter.
The installer will now verify the user and connect to the database.
m. When the installer presents the currently selected settings, review them for accuracy, then
type y and press Enter. The installation will take about 30 minutes.
Time 5 - 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
In this lab, you will verify and configure the installation of Jaspersoft. This lab is executed on the
Jaspersoft Server.
1. At the end of the previous lab, you stopped the Jaspersoft service and will now restart it. To do
this:
a. Open a command prompt window, as the administrator.
b. Navigate to the C:\JSTomcat\apache-tomcat-7.0.55\bin directory.
c. Run startup.bat.
d. When the service has started, minimize the two open windows. Do not close them.
2. Open an Internet Browser window and in the address line, type the following and press Enter:
http://jaspersoft:8080/reportservice/
A Login page displays.
4. In the menu bar point to the Manage menu and click Organizations.
7. Click Add Organization. This Organization is used when we set up the Keystore between CA
PPM and Jaspersoft.
10. Open an explorer window and navigate to C:\JSSERVER (the directory in which Jaspersoft is
installed), and review the install.log file for errors.
Goals Configure the system so all components are integrated with each other.
Time 30 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Configuring the new installation involves setup using the CSA, CA PPM, and Jaspersoft so that they
are integrated with each other. You set up the My_Org organization in Jaspersoft in a previous lab
and this is used in the following steps.
This lab is executed on the CA PPM / Database Server vm.
1. To verify if CA PPM Beacon and NSA are running, open a Command Prompt window as
administrator and enter the following:
service status beacon nsa
If the services are already running, there is no need to restart them. Otherwise, start them
using the following commands:
a. If CA PPM Beacon is stopped, start the CA PPM Beacon at the command prompt - enter the
following:
service start beacon
Note: If the CA PPM Beacon is not present, to install it, at the command prompt, enter the
following:
service add start beacon
b. If CSA is stopped, to start the CSA, at the command prompt, enter the following:
service start nsa
Note: If the CSA is not present, to install it, at the command prompt, enter the following:
service add start nsa
3. To open launch Internet Explorer, on the desktop, click the Internet Explorer shortcut.
CA Technologies CA PPM 14.3: Installation with MS/SQL 200 33
5. In the CA PPM System Administration (CSA) Login window, in the Password field, type the
password from a previous lab:
admin
6. Click Login.
The License agreement appears.
11. In the License Types list, select Studio Developer, Creator, Participant, Viewer.
15. In the Database Server pane, make sure the Vendor field is set to MSSQL.
16. In the Internal Connection: Niku section, complete the fields as follows:
Hostname clarityT2
Port Number 1433
Database Name niku
Service Name niku
Login Name niku
Password niku
Confirm Password niku
17. Click Save. In the Internal Connection - Niku section, check that the status is Available.
21. In the Search Server pane, in the Index Directory field, type the following:
C:\CAPPM\searchindex
Note: The recommended best practice is not to store documents and indexes in the CA PPM
home directory, because contents will be erased during upgrades. The CA PPM home directory
is C:\CAPPM\CAPPM143, therefore the defaults will suffice.
22. In the File Store Directory field, type the following, and click Save:
C:\CAPPM\filestore
25. In the Report Server pane, complete the fields as follows in the Report Server - Jaspersoft
section:
Vendor Jaspersoft
Web URL http://jaspersoft:8080/reportservice
User ppmjasperadmin
Organization Name My_Org
Organization ID My_Org
28. Select MSSQL as the vendor, and then fill in the fields in the lower half of the window as shown.
(The password is from Lab 4-2 and is case sensitive.)
Hostname ClarityT2
Port 1433
Database Name ppm_dwh
Service Name ppm_dwh
Password ppm_dwh
Confirm Password ppm_dwh
Custom Database Link Selected
PPM Database Link PPMDBLINK
Note: The login failure is expected because we have not yet created the ppmjasperadmin user
in Jaspersoft. Notice that the database status now indicates "Available".
36. To select all services, click the Select All button, and then click Deploy.
41. To authenticate CA Clarity PPM and Jaspersoft, generate a trusted key store for each
organization. Follow these steps:
a. Open an Administrator: command prompt.
b. Go to C:\CAPPM\CAPPM143\bin.
c. Run the following command: admin jaspersoft keystore
43. You now need to copy the two keystore files to the Jaspersoft server machine, in the following
folder:
C:\JSTomcat\apache-tomcat-7.0.55\webapps\reportservice\WEB-INF\config
The easiest way to do his is to switch to the Jaspersoft server and map C$ on the ClarityT2
server as a network drive:
a. Double-click the Computer icon on the desktop.
b. Click the Map network drive tab. The Map Network Drive page is displayed.
c. In the folder field, enter \\clarityt2\c$ and click Finish. (A drive letter for example Z: will be
allocated)
d. Navigate to Computer>c$(\\clarityt2) Z:> CAPPM>CAPPM143>config
e. Select the my_org.jks and my_org.properties files.
f. Copy the two files (Ctrl+C).
g. Navigate to C:\JSTomcat\apache-tomcat-7.0.55\webapps\reportservice\WEB_INF\config
h. Paste the two files into the config folder (Ctrl+V).
Time 45 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
4. In the same command window, to install the Jaspersoft content, enter the following command:
admin content-jaspersoft csk userName superuser password superuser
Note the uppercase N in the username parameter. If the connection fails, verify the URL
connection in the NSA is correct and the service is running on the Jaspersoft server.
5. When the installation completes, open a new browser window and access the Jaspersoft
console via the following URL:
http://Jaspersoft:8080/reportservice
9. Open a Command Prompt window and restart all services on the ClarityT2 server, by entering:
service stop start all
Goals Complete the system setup in CA PPM so that the integration jobs will run.
Time 45 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
To accomplish these tasks, you will assign access rights to the admin user and execute jobs to
populate the warehouse with the administrator rights, and populate the warehouse with data.
Finally, you will create users in Jaspersoft.
Note that on first login the system will prompt for a password change. Make a note of the
password you select.
1. Open a browser window, on the CA PPM vm, and enter the following url:
http://clarityT2
7. At the bottom of the resulting screen, click Add. Enter fin*main into the Access Right field and
click Filter.
8. On the list displayed, tick the box against Financial Maintenance - Financial Organization
Structure and click Add:
9. Repeat previous steps, but this time filtering for Advanced Reporting, adv*rep, and select all 7
access rights. The final set of rights should contain the following:
10. To enable this user to view projects, for testing in a later lab, click Add.
11. Enter proj*man into the Access Right field and click Filter.
13. Point to the Administration menu and click Reports and Jobs.
14. Enter *warehouse in the Job Definition Name field and click Filter.
16. Enter *Jaspersoft in the Job Definition Name field and click Filter.
17. Verify that the Create and Update Jaspersoft Users job is active.
18. Log out of CA PPM and then log back in again as admin (password cappm) to make the new
rights visible on the Administration menu.
20. On the Organizational Breakdown Structures screen, click New, fill in the screen as shown
below, and click Save AWarehouseWnd Return.
21. Repeat the previous step to create an OBS for the departments:
22. Point to the Administration menu and click Setup (in the Finance section). You will receive a
message that the system currency needs to be selected.
25. Click Entities and then New. Fill in the New Entity screen as follows, then click Save:
26. To set up Fiscal Periods that the warehouse will inherit, click the Fiscal Time Periods tab, and
set some up by clicking New:
27. Point to the Administration menu and click System Options, and complete the Data
Warehouse Options section as shown:
29. We are now ready to execute the integration jobs. Ensure that the Jaspersoft service is running
on the Jaspersoft server. Then in CA PPM navigate to Home > Reports and Jobs > Jobs >
Available Jobs and click the Create and Update Jaspersoft Users job. Fill in the parameters as
shown and click Submit at the bottom of the screen:
30. Wait a short time for the job to complete, then filter for the job and verify it completed:
31. Repeat the previous two steps, but this time filter for the Load Data Warehouse Access Rights
job, and submit this for immediate execution (there are no parameters to complete), and verify
it completed successfully.
32. Finally, repeat the steps again, but this time filter for the Load Data Warehouse job, tick the
box for Full Load and submit for immediate execution. Verify it completed successfully. This job
takes about 5 minutes to run.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
3. Click Run Health Check and scroll to the right of the window.
Note: The health report is stored in an XML file in the C:\CAPPM\CAPPM143\logs directory. The
following steps provide a way for you to run this report in CSA.
The error shown below is because the labs use SQL Server Standard Edition whereas a
production system would use Enterprise Edition.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Note: Logs can be viewed in CSA or can be accessed in the C:\CAPPM\CAPPM143\Logs directory.
1. If you are still logged in to CSA, click Home and go to step 2. Otherwise, log in to CSA using the
admin as the password. The Overview page appears.
5. Scroll down to the Categories section, and in the Priority column, click the first drop-down list.
Notice that you can change the log priority as needed so that specified logs are captured.
The options include Fatal, Error, Warn, Info, Debug, and All.
Note: If the All option is selected, the size of the log can increase very rapidly.
6. You do not need to configure priorities now. Therefore, leave the priority at Fatal.
7. Click Home.
Note: After the log options have been set up, you must restart CA Clarity PPM for the changes
to take effect, unless Detect log configuration changes immediately has been selected.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
1. If you are still logged in to CSA, click Home and go to step 2. Otherwise, log in to CSA using
admin as the password. The Overview page appears.
5. Click the Log File list drop-down, and view the available logs:
admin.log: Administration-related logs
app-ca: Application action-related logs
app-system: Application system-related logs
bg-ca: Background service-related or process engine-related logs
6. In the Max Size list, select 10k and then click Go.
The detailed log file appears.
Time 20 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
7. Click Global.
10. Click Logout. This will allow the newly assigned rights to become effective.
12. Point to the Home menu, and in the Organization section, click Knowledge Store.
13. On the Knowledge Store page, click the Actions drop-down, and click Add Documents.
14. On the Add Documents page, next to the Select Files field, click Browse.
15. In the Choose File dialog, navigate to the C:\Learning Materials folder, select the
Lab_Step_Text_Snippets.txt document and click Open.
17. On the Knowledge Store page, in the Search field, type server (a word from the added
document) and click Go or press Enter.
On the Search Results page, search results include the document you just added.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
The steps in this lab are appropriate if you have installation rights for your desktop. However, in a
typical enterprise, the entire installation is pushed out centrally.
6. On the Select Access Rights page, select Account Settings Navigate and click Add and select
more.
7. In the Access Right filter field, type soft and click Filter.
8. Select Software Download Open Workbench and Software Download Microsoft Project
Interface, and click Add.
9. Click Logout, then login again to make the new access rights effective.
12. On the Account Settings: Software Downloads page, next to Open Workbench (x86), click
Download.
14. In the Select Setup Language dialog, accept English and click OK.
20. Click the Start button, click All Programs, and click Open Workbench.
21. Log in with your CA PPM credentials; admin / cappm, and click OK.
25. Click Yes, because you will not save the project.
The project will open, confirming that Open Workbench and Schedule Connect are successfully
installed.
Time 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Important: Before you install the Microsoft Project Interface, make sure that JDK 1.7 or later is
installed on the user's computer. The installation is similar to the Open Workbench installation, but
there are a few extra steps as detailed below.
3. On the Account Settings: Software Downloads page, next to Microsoft Project Interface (x86),
click Download.
After the download completes you are asked if you wish to run mspsetup.exe or save.
4. Click Run.
The setup wizard appears, indicating that the CA PPM Microsoft Project Interface with CA PPM
Schedule Connect will be installed on your computer. You are also recommended to close all
other applications before continuing.
7. On the Select Destination Location page, the default location is selected. You do not need to
change this. Click Next
8. A warning explains that the default path already exists; this is because the path was created for
the installation of Open Workbench. Click Yes.
9. On the Select Components page, select the following components, being sure not to select the
legacy interface (because the image you are using contains MSP 2013), and click Next.
10. On the Ready to Install page, click Install. The files will be extracted.
12. On the License Agreement page, accept the license agreement and click Next.
13. On the Select Features page, accept the defaults and click Next.
15. If the following screens appear, click Accept and Install to continue the installation:
16. When the installation completes, a message appears, indicating that the install has been
successful.
18. On the Introduction page of the CA PPM Schedule Connect install wizard, click Next.
Because Schedule Connect has already been installed on the machine, during the installation of
Open Workbench in the previous lab, a Program Maintenance window displays.
23. Click the Start button and then click All Programs.
24. Click the Microsoft Office 2013 folder and then click Project 2013.
25. A macro will attempt to run, but will be prevented due to the macro settings in Microsoft
Project. Click Enable Macros.
The installation has added a new menu to the Project 2013 ribbon.
28. Click the Open icon and log in using admin with password cappm:
29. Open the csk.majorIT project (the projects might vary in your image).
Time 15 minutes
Based on the environment, it may take a long time.
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Check with the system administrator for the backup policies of the organization. CA PPM services
should be stopped and then restarted before and after any scheduled maintenance that will
interrupt connectivity between CA PPM and the database.
3. The backup process starts and requests the location of the backup directory. To create the
backup directory, type C:\CAPPM\CAPPM_BACKUP
Note: If there is an existing backup folder, the folder is overwritten with the new backup.
After the backup is finished, the prompt appears. The CA PPM application is backed up in the
created directory.
4. To restart the services, open a Command Prompt window and enter the following:
service start all
Time 10 minutes
Based on the environment, it may take a long time.
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
1. The application service should be stopped before performing a database backup. To stop the
application and background services, open a Command Prompt window and enter the
following:
service stop app bg
Note: When The CA PPM App Server service was stopped successfully is displayed, you can
proceed.
2. Click Start All Programs Microsoft SQL Server 2012 Microsoft SQL Server Management
Studio.
3. Log in to the CA PPM database server using the following credentials and click Connect:
Server name CLARITYT2
Login sa
Password edu2k
9. Click OK.
12. When The backup of database niku completed successfully is displayed, click OK.
14. To restart the application service, open a Command Prompt window and enter the following:
service start app bg nsa beacon
Time 15 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Check with the system administrator for the restore policies of the organization. CA PPM services
should be stopped and then restarted before and after any scheduled maintenance that will
interrupt connectivity between CA PPM and the database.
2. Using Windows Explorer, copy saxon.jar from the following staging folder:
C:\CAPPM\staging\tools\lib
Replace with:
<proputil ref="version" loadFile="tools/version.properties"
8. If the C:\CAPPM\CAPPM143 directory has not been removed during preparation for restoring
the application, rename the C:\CAPPM\CAPPM143 directory to c:\CAPPM\CAPPM143_old.
11. Execute the restore.bat script. The restore process starts and the original directory is
automatically created in the Clarity home directory.
Note: If the folder exists, the contents will be overwritten with the new restored files.
12. To restart the services, type service start all at the command prompt, and press Enter.
Time 5 - 10 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
In this lab, you will restore the CA PPM Transactional database from the backup taken in a prior lab.
Before executing this lab, ensure that all CA PPM services are stopped.
1. To stop the CA PPM services, open a command window and execute the following command:
service stop all
2. Click Start All Programs Microsoft SQL Server 2012 SQL Server Management Studio.
3. To log in to SQL Management Studio, make sure that the information appears in the fields as
follows and then click Connect:
Server name CLARITYT2
Login sa
Password edu2k
4. Before restoring the database, we need to delete the existing one. In the left pane, expand
Database.
6. In the Delete Object dialog, click OK. The niku database is deleted and is no longer present in
the list of databases in the Object Explorer pane.
7. In the Object Explorer pane, right-click Databases, then click Restore Database.
f. Click OK.
15. In the Object Explorer list, expand the Security folder and then expand the Logins folder.
16. Double-click the niku login and verify the default database is niku. If this is not the case, make
the adjustment using the Default Database drop-down list.
18. To disconnect from the server, in the left navigation pane, right-click the CLARITYT2 Server and
click Disconnect.
19. In the Object Explorer list, click Connect and click Database Engine.
20. On the Connect to Server screen, make sure that the information appears in the fields as
follows and then click Connect:
Server name CLARITYT2
Login niku
Password niku
27. After the restore is finished, CA PPM can be restarted. To restart the application service, from
the Command Prompt window, enter the following:
service start all
When all services have been started successfully, close the Command Prompt window.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
You have already executed jobs when the integration jobs were run in lab 6. In this lab we will
schedule a job to run periodically. Ensure that all services are running on both servers.
1. On the CA PPM server, open a browser window and navigate to the following URL to open CA
PPM:
http://clarityT2
3. Point to the Home menu, and click the Reports and Jobs link.
5. Click the job type link for the Load Data Warehouse job.
The properties page appears.
6. Schedule the job as needed. In this example, use the following settings to have it run every 15
minutes.
a. Clear Immediately and select Scheduled.
b. Click the Start Date icon.
The Date Picker window appears.
c. Select Today.
d. In the Start Time lists, select a time 15 Minutes ahead of the current time
e. Click Set Recurrence.
The Recurrence window appears.
i. Click Use Unix Crontab entry format
ii. Enter the following string 00,15,30,45 * * * *
iii. Click Save And Return.
7. Notify the Resources as needed. In this example, accept the default of admin.
8. Click Submit.
The Job now appears on the Jobs tab with a Job Status of Scheduled and, will show as
processing every 15 minutes. This is how the Data Warehouse will be updated to keep it
synchronized with the CA PPM transactional database.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
3. Scroll down the table and under Job Type, click LDAP - Synchronize New and Changed Users.
The Job Properties page appears.
4. Click Submit.
The Jobs: Scheduled Jobs page appears.
6. On the Jobs tab, next to the failed job, click the Log icon.
7. In the Job column, click LDAP - Synchronize New and Changed Users.
Note: For a failed job, you will see high-level log details, but to view the detailed log, you must
log in to CSA.
10. In the Cluster Health Overview section, click the Logs icon.
12. For the log display, confirm that the Max Size list is set to 1K and click Go.
You will see the error message indicating the synchronize new and changed users job failed,
and the reason for the failure:
Goals Create a new job definition for a SQL Procedure type job.
Time 15 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Notes:
To create a job definition in CA PPM, the executable file must be developed first.
The stored procedure has already been created in the CA PPM database.
The stored procedure name, in this case, full_name_sp must be used to create the job
definition.
3. Click New and create two new resources using the following as a template (it supplies the
minimum data needed). Click Save and Return when completed:
Field Values for first Resource Values for second Resource
Last Name User 1 User 2
First Name Lab Lab
User Name LU1 LU2
Resource ID LU1 LU2
Password clarity clarity
Password clarity clarity
Force Password Change checked checked
Email Address luone@nowhere.com lutwo@nowhere.com
Employment Type Employee Employee
Status Active Active
4. Close CA PPM.
5. Click Start All Programs Microsoft SQL Server 2012 SQL Server Management Studio.
7. Click Connect.
9. Click Execute.
Notice the full_name column from the cmn_sec_users table (final column) is NULL for the two
new resources created.
10. You will create a stored procedure that will be the new CA PPM job. Click New Query and type
the following:
Create Procedure full_name
(@p_job_run_id numeric, @p_job_user_id numeric)
As
Begin
Update cmn_sec_users
Set full_name =
(Select r.full_name from srm_resources r
Where r.user_id = cmn_sec_users.id)
Where full_name is null
End
19. Point to the Home menu, and click Reports and Jobs.
23. To see job status set to complete, on the Jobs tab, filter for "Full".
The Full Name Job status is Completed.
Time 15 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
To run reports, you must have some rights on the objects displayed in the reports, and the
Jaspersoft service must be running on the Jaspersoft server. Here we will use resources.
6. Log out and in again, to refresh the rights attached to the admin user.
10. When complete, execute the Load Data Warehouse Job. Hint: Filtering for jobs that start with
Load will also assist here.
11. When complete, point to the Home menu, and click Advanced Reporting.
12. Click the Library menu, and then click Resource Availability report link.
13. To execute the report, accept all default parameter values in the left hand pane and click Apply:
Service Packs
From time to time CA release service packs that fix issues with CA PPM or enhance functionality
in accordance with users' requests. Fix packs are applied on top of the currently executing
version, and are cumulative, so there is no need, for example, to apply service pack 2 and then
service pack 3, as service pack 3 has all the content of service pack 2 and more.
Each service pack comes with release notes that indicate what it contains and how it should be
applied. CA Strongly recommend that service packs are applied to a non-production instance
for evaluation before being applied to a production instance.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
2. Add the global Process Engine Monitoring right to the admin user using the same method you
used in previous labs, then log out and log in again to make your change effective.
4. To view the pipelines for a specific background server, under Name, click the server.
The Process Engines page appears with a list of all pipelines associated to the selected server.
5. Note: For more information about pipelines, see the CA PPM Administration Guide. Contact CA
Support before configuring pipelines for the process engine.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
Note: Sometimes the icon in the Status column might remain gray, indicating that the status
cannot be determined, even though the bg service is running. If this happens, to check if the bg
service is still active, click the process engine name link and wait 30 seconds. After the refresh
period, which is 30 seconds, it will show a running status.
See the CA PPM Administration Guide for more information about process events.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
5. Click Save.
11. To provide a password that matches the criteria in the regular expression, in the Password and
Confirm Password fields, type the following:
Clarity1
94 CA PPM 14.3: Installation with MS/SQL 200 CA Technologies
Goals Revise a password expression and error message from the previous lab.
Time 5 minutes
Instructions:
Note: As explained in the first lab, open the C:\LEARNING MATERIALS folder and click the
MSSQL_Installation_Lab_Files link to access demonstrations for the labs.
1. The new password needs to be at least six characters, which must include at least one of each
of the following characters:
Uppercase letter
Lowercase letter
Digit
Special character
3. To test the password rules, create a new resource with a password that does not meet the
requirements that you have set.
The following solution provides step-by-step instructions to complete the lab challenge.
Solution
1. Log in to CA PPM as admin.
The Overview: General page appears.
3. Under Change Password Options, clear the fields and type the following:
Field Value
Regular Expression ^(?=.*\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[^0-9a-zA-Z]).{6,}$
Error Message Password must be at least six characters and must include at least
one uppercase letter, one lowercase letter, one digit, and one
special character.
4. Click Save.
Getting Started
Dynamic Lab Environment is the name of the CA Education virtual environment for labs and
practice activities. The technology behind the Dynamic Lab Environment is provided by Skytap and
some of the instructions in this document reference Skytap.
This appendix provides the following information:
System and network requirements
Self-Directed Learning login and usage information
Setting up an environment (other than Self-Directed Learning)
Best practices
Troubleshooting
Escalating unresolved issues
System Requirements
The minimum system requirements for an individual client machine accessing the Dynamic Lab
Environment are listed below. Please check that you meet the minimum requirements and that
you have the equipment you need before attempting to use the environment.
Java Version
The acceptable Java versions are Java 1.6, 1.7, or newer.
If you are unsure which version of Java you are running, simply click the following link and it
will auto-detect: http://java.com/en/download/installed.jsp or type java -version in the
terminal for Linux.
If you are running OS X, please see Running Java on Mac OS X.
For information on installing Java on your local Linux machine, see How to install Java on my
local Linux machine.
After you register for the course, you will receive a system-generated email that includes two
important pieces of information:
A published URL to access your assigned lab environment
The date and time on which your access to that environment expires
Keep this email as you will need to use the URL whenever you access your lab environment.
Here is a sample email with the two pieces of information highlighted:
The above sample environment includes three VMs. Your particular environment will be
appropriate for the course activities for which you have registered.
NOTE: When you initially access your environment, you may see a Java prompt, asking if
you want to run this application. Click Run if you see this prompt. It will enable you to
properly connect into the environment and enable the keyboard to work correctly.
When you click Suspend, your allocated lab time is preserved and the time clock remains paused
until you change the status to Run. The VMs in a suspended environment display that status as
shown in the following image:
Once you have suspended your environment, you can minimize or close the browser window in
which the environment has been running. Use the same URL you were sent in email to re-open
your environment when you are ready to resume.
This may take several minutes. The environment is ready the when VMs are highlighted in green
and display a Running status. Click on the machine(s) you want to directly access to start or resume
your lab activities.
Network Requirements
We recommend a minimum download speed of 1.16 Mb/sec (150 KB/sec) per client connection
(i.e., each individual user). In addition, we recommend latency of 250ms or less.
If you have a group of 15 users, each connecting to their own client session from the same physical
location concurrently, the recommended amount of bandwidth required is
1.16Mb/sec per user x 15 or 17.5Mb/sec.
Connection Test
If you are connecting for the first time, or connecting from a computer you have never used before,
run the connection and speed tests to make sure that your browser supports a connection to the
Dynamic Lab Environment. These tests are hosted by Skytap directly.
Use the following URL to use the Skytap Connectivity Checker to run connection and speed tests:
https://cloud.skytap.com/tools/connectivity
Best Practices
Use the following list of best practices to help you avoid potential issues with the Dynamic Lab
Environment:
Ensure that you are connected to a dedicated hardwired network connection on a
broadband internet connection.
Do not use Wi-Fi connection because it is more susceptible to higher latency issues
impacting performance.
Close all applications and documents you are not using for your virtual training; applications
running in the background may use up your computer's bandwidth and affect system
performance.
You should not be connected to a corporate VPN while connecting to the virtual training
class.
Troubleshooting
Run both Connectivity Checker and Speed Test from appropriate application regions and submit
results to educationlabs@ca.com. Before the start of class, make sure your browser supports a
connection to the remote labs.