search cancel

How to build a cabi_external with DX IM 20.1 and CABI 7.1.1

book

Article ID: 188529

calendar_today

Updated On:

Products

DX Unified Infrastructure Management (Nimsoft / UIM)

Issue/Introduction

How to install and configure cabi_external for DX IM 20.1 and CABI 7.1.1

Environment

Release : 20.1

Component : UIM - CABI

Resolution

1. Contact Support to get the controlled release of Unified CABI 7.1.1 for Windows.
https://techdocs.broadcom.com/us/en/ca-enterprise-software/it-operations-management/unified-infrastructure-management/20-3/installing/ca-business-intelligence-with-ca-uim/installing-and-upgrading-ca-business-intelligence-jasperreports-server-with-ca-uim/install-or-upgrade-for-an-external-ca-business-intelligence-jasperreports-server.html

2. Install CABI 7.1.1 in a dedicated server.


3. Download the packages required for cabi_external on the Archive.
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/it-operations-management/unified-infrastructure-management/20-1/installing/ca-business-intelligence-with-ca-uim/installing-and-upgrading-ca-business-intelligence-jasperreports-server-with-ca-uim/install-or-upgrade-for-an-external-ca-business-intelligence-jasperreports-server.html#concept.dita_57002425dc64588f2e629bab14d5e7dfea3d4daf_SoftwareRequirements



4. Deploy the cabi_external probe on a dedicated CABI robot.




5. Open the Raw Configure for the cabi_external probe. Highlight the cabi_external probe, <Ctrl> + Right-Click (or Shift + Right-Click) and choose Raw Configure.

6. Change the cabi_url key value to the URL for the CABI Server.
The format is http://<cabi_server_name_or_IP>:<port>/<webapp>
where <webapp> is usually jasperserver-pro.



7. Restart the cabi_external robot.
Review the C:\Program Files (x86)\Nimsoft\probes\service\cabi_external\cabi_external.log file.

Apr 12 08:37:19:303 [main, cabi_external] EncryptorService was already initialized.
Apr 12 08:37:19:897 [main, cabi_external] ****************[ Starting ]****************
Apr 12 08:37:19:897 [main, cabi_external] 4.2.0
Apr 12 08:37:19:897 [main, cabi_external] CA
Apr 12 08:37:19:897 [main, cabi_external] port=48008
Apr 12 08:37:20:100 [main, cabi_external] Login to NimBUS is OK
Apr 12 08:37:21:803 [main, cabi_external] cabi_mode is 'external'
Apr 12 08:37:21:803 [main, cabi_external] Running installation sequence since this is either a fresh install or an upgrade
Apr 12 08:37:23:897 [main, cabi_external] stdout: Wallet Type: null
Apr 12 08:37:24:428 [main, cabi_external] creating JNDI settings for the external mode for tomcat 7 ... 
Apr 12 08:37:24:553 [main, cabi_external] creating JNDI settings for the external mode for tomcat 8 ... 
Apr 12 08:37:24:584 [main, cabi_external] creating overlay folder zip ... 
Apr 12 08:37:25:568 [main, cabi_external] updating the jar file=C:\Program Files (x86)\Nimsoft\probes\service\cabi_external\config\internal\uim-cabi-overlay-installer.jar(uri=jar:file:///C:/Program%20Files%20(x86)/Nimsoft/probes/service/cabi_external/config/internal/uim-cabi-overlay-installer.jar,size=2400286) with files=[C:\Program Files (x86)\Nimsoft\probes\service\cabi_external\config\internal\overlay.zip] ... 
Apr 12 08:37:25:631 [main, cabi_external] successfully loaded the jar file system=C:\Program Files (x86)\Nimsoft\probes\service\cabi_external\config\internal\uim-cabi-overlay-installer.jar
Apr 12 08:37:26:068 [main, cabi_external] Creating Jasper Rest Session using cabiAppUrl: http://lvndev000808.bpc.broadcom.net:8080/jasperserver-pro for user: superuser ... 
Apr 12 08:37:26:147 [main, cabi_external] Successfully created session [time taken=0 minute(s) 0 second(s) (79 ms)]
Apr 12 08:37:26:693 [main, cabi_external] making rest service call to create folder=ClientFolder{version=null, permissionMask=null, uri='/public/ca/uim', label='Unified Infrastructure Management'}...
Apr 12 08:37:27:287 [main, cabi_external] making rest service call to create folder=ClientFolder{version=null, permissionMask=null, uri='/public/ca/uim/datasources', label='datasources'}...
Apr 12 08:37:27:475 [main, cabi_external] creating data source: , path=/public/ca/uim/datasources/uim_datasource, dataSourceName=UIM Datasource, dataSourceDesc=UIM Datasource, dbType=DB_TYPE_SQL_SERVER, hostName=lvnbld010260.bpc.broadcom.net, port=1433, user=sa, dbNameOrServiceName=CA_UIM ... 
Apr 12 08:37:27:475 [main, cabi_external] making rest service call to create datasource=[driverClass=tibcosoftware.jdbc.sqlserver.SQLServerDriver,username=sa,connectionUrl=jdbc:tibcosoftware:sqlserver://lvnbld010260.bpc.broadcom.net:1433;databaseName=CA_UIM,timezone=null] ... 
Apr 12 08:37:27:881 [main, cabi_external] either domain is new or its version has changed so need to upload domain
Apr 12 08:37:27:975 [main, cabi_external] creating automatic backup of existing CABI report uri(s): [/public/ca/uim]) ... 
Apr 12 08:37:30:272 [main, cabi_external] successfully created automatic backup at: C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\auto-backup\auto-backup_2020-04-12_08-37-27-975.zip [time taken=0 minute(s) 2 second(s) (2313 ms)]
Apr 12 08:37:30:272 [main, cabi_external] setting configuration property 'auto_backup_last_utc_time_in_ms'=1586695050272 ... 
Apr 12 08:37:30:272 [main, cabi_external] uploading domain=C:\Program Files (x86)\Nimsoft\probes\service\cabi_external\config\domain\UIM_Domain_MSSQL.zip ... 
Apr 12 08:37:31:381 [main, cabi_external] setting the config property last_uploaded_domain_version=3.2.0-1 ... 
Apr 12 08:37:31:381 [main, cabi_external] either topic is new or its version has changed so need to upload topic
Apr 12 08:37:31:459 [main, cabi_external] skipping the auto backup since last backup was created 0 hr(s) back (1187 ms) which is less than the specified auto-backup frequency of 24 hr(s) (86400000 ms). If you want frequent auto backup(s) please configure the probe property 'auto_backup_fequency_in_hours' accordingly [specify 0 (zero) value to force auto backup every time]. 
Apr 12 08:37:31:475 [main, cabi_external] uploading topic=C:\Program Files (x86)\Nimsoft\probes\service\cabi_external\config\topic\uim-topic-MSSQL.zip ... 
Apr 12 08:37:32:522 [main, cabi_external] setting the config property last_uploaded_topic_version=3.2.0-1 ... 
Apr 12 08:37:32:709 [main, cabi_external] cabi installed successfully.
Apr 12 08:37:32:709 [main, cabi_external] registering dir=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload to the directory watcher service ... 
Apr 12 08:37:32:709 [main, cabi_external] UserSynchronizationThread initialized to run every 60 seconds.
Apr 12 08:37:32:709 [main, cabi_external] changing probe state from 'INITIALIZING' to 'RUNNING'
Apr 12 08:37:32:892 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] skipping the auto backup since last backup was created 0 hr(s) back (2620 ms) which is less than the specified auto-backup frequency of 24 hr(s) (86400000 ms). If you want frequent auto backup(s) please configure the probe property 'auto_backup_fequency_in_hours' accordingly [specify 0 (zero) value to force auto backup every time]. 
Apr 12 08:37:32:892 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] uploading file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_core_dashboards.zip .... 
Apr 12 08:37:42:236 [UserSynchronizationThread, cabi_external] Created user 'administrator' in organization 'UIM'
Apr 12 08:37:42:236 [UserSynchronizationThread, cabi_external] Finished synchronizing users between UIM and CABI
Apr 12 08:37:59:834 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] successfully uploaded file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_core_dashboards.zip
Apr 12 08:38:00:209 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] skipping the auto backup since last backup was created 0 hr(s) back (29937 ms) which is less than the specified auto-backup frequency of 24 hr(s) (86400000 ms). If you want frequent auto backup(s) please configure the probe property 'auto_backup_fequency_in_hours' accordingly [specify 0 (zero) value to force auto backup every time]. 
Apr 12 08:38:00:209 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] uploading file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_cabi_health_reports.zip .... 
Apr 12 08:38:07:414 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] successfully uploaded file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_cabi_health_reports.zip
Apr 12 08:38:07:742 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] skipping the auto backup since last backup was created 0 hr(s) back (37470 ms) which is less than the specified auto-backup frequency of 24 hr(s) (86400000 ms). If you want frequent auto backup(s) please configure the probe property 'auto_backup_fequency_in_hours' accordingly [specify 0 (zero) value to force auto backup every time]. 
Apr 12 08:38:07:742 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] uploading file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_mcs_dashboards.zip .... 
Apr 12 08:38:15:478 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] successfully uploaded file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_mcs_dashboards.zip
Apr 12 08:38:15:806 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] skipping the auto backup since last backup was created 0 hr(s) back (45534 ms) which is less than the specified auto-backup frequency of 24 hr(s) (86400000 ms). If you want frequent auto backup(s) please configure the probe property 'auto_backup_fequency_in_hours' accordingly [specify 0 (zero) value to force auto backup every time]. 
Apr 12 08:38:15:806 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] uploading file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_unified_reporter.zip .... 
Apr 12 08:38:28:166 [com.ca.cabi4uim.DirWatcherServicePool-1-thread-1, cabi_external] successfully uploaded file=C:\Program Files (x86)\Nimsoft\probes\service\cabi\content\upload\uim_unified_reporter.zip

8. Log in to the CABI server as the user who is configured to run the CABI Tomcat service.

9. Go to the filesystem of the robot with the cabi_external probe.
C:\Program Files (x86)\Nimsoft\probes\service\cabi_external\config\bin

10. Copy the uim-cabi-overlay-installer.jar file.

11. Add the file to the CABI Server root directory. Use the appropriate path for your operating system:

- Windows: <CABI_Server_installation>/Program Files/CA/SC/CA Business Intelligence
- Unix: <CABI_Server_installation>/opt/CA/SharedComponents/CA Business Intelligence

12. Set the environment variable on the CABI server.

- JAVA_HOME=<CABI_Server_installation>/Program Files/CA/SC/CA Business Intelligence/jre/bin
- PATH=<CABI_Server_installation>/Program Files/CA/SC/CA Business Intelligence/jre/bin (add)





13. Open a Command-Prompt (Admin) on the CABI Server.


14. Go to the CABI Server root directory.
C:\Program Files\CA\SC\CA Business Intelligence\

15. Run the installer on CABI Server: java -jar uim-cabi-overlay-installer.jar


16. The log file is created.


17. Restart the CABI web server.


18. On the CABI machine, open the JasperReports URL: http://localhost:8080/jasperserver-pro

19.  Go to Manage --> Organizations
Ensure the UIM organization was created.


20. Go to View --> Repository
Ensure the ca repository was created.


21. Click on Home and View Data Sources.


22. Right-click on UIM Datasource and choose Edit.



23. Test the connection.


24. Do the same for UIM JNDI Datasource.

25. Click on Home and View Dashboards. Click on UIM Summary dashboard.



26. Deploy the ump_cabi package on the UMP machine.

27. In the UMP, launch the Unified Dashboard --> CA Business Intelligence --> Summary Dashboard.



28. In Raw Configure of wasp probe on the UMP machine, create the cabi entry under setup and set the cabi_external service path:
/WIN-O0F065HNCIV_domain/WIN-O0F065HNCIV_hub/lvnbld010263/cabi_external


29. Deactivate and active the wasp probe on the UMP machine.

30. Launch the Unified Dashboards again. It should display as below:


31. Launch the Operator Console.



32. If the Operator Console does not load successfully, review this KB article:
https://knowledge.broadcom.com/external/article?articleId=77125

Additional Information

How to enable SQL logging on the JasperReports.

Manage --> Server Settings




Review the C:\Program Files\CA\SC\CA Business Intelligence\apache-tomcat\webapps\jasperserver-pro\WEB-INF\logs\jasperserver.log file.
In the example below, the SQL query to display the Devices in the UIM Summary dashboard.




https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/it-operations-management/unified-infrastructure-management/20-1/installing/ca-business-intelligence-with-ca-uim/installing-and-upgrading-ca-business-intelligence-jasperreports-server-with-ca-uim/install-or-upgrade-for-an-external-ca-business-intelligence-jasperreports-server.html

Attachments