Well ever since Pega 8.6 came out I have been inkling to try out the Cosmos React UI . There were probably 2 main options which came to my mind
Use the cloud instances from Pega Academy
Set up “Cosmos React UI” to work in Pega Personal Edition
Option 1 was probably the easy way out , but there’s nothing like a little bit of tinkering in personal edition to truly understand what’s going on under the hood . So in this discussion i’ll describe what I did to get this working and hopefully it helps someone else .
So first things first the prerequisites
Install Pega Personal Edition the usual way nothing fancy , jsut check that it’s working and shut it down
Install Docker. If you use windows then you could use Docker Desktop, follow the article Install Docker Desktop on Windows | Docker Documentation, it’s really easy. Just make sure you follow all the steps specifically the one regarding WSL 2 feature on Windows.
Download an install Open SSL (will be used for working with SSL Certs)
Check that docker is working fine , I just used a the following command in powershell / command prompt and then navigate to localhost:8011
docker run -d -p 8011:80 docker/getting-started
Stop the Container
docker ps
-- copy the container ID from the output
docker stop <container ID>
Request pega platform image access key. This can generally be raised from Digital Delivery | Pega . and you’d receive a email with the access key. Some people may run into issues with this step since access to the key is based on the license agreement your organization has with Pega. If you do run into issues getting the key then talk to your organization’s Pega Account Executive.
Now to Setup
Generate a SSL certificate , I used a self signed cert since this is just for personal use , the following command can be used from Powershell
Then generate the .cert and .key file , run the following form Powershell
keytool -importkeystore -srckeystore C:\certs\pegalocalkeystore.jks -destkeystore C:\certs\pegalocalkeystore.p12 -deststoretype PKCS12
- Run the following commands from the folder where Open SSL is installed and use the appropriate folder in place of C:\certs\
.\openssl pkcs12 -in C:\certs\pegalocalkeystore.p12 -nokeys -out C:\certs\pegalocal.crt
.\openssl pkcs12 -in C:\certs\pegalocalkeystore.p12 -nocerts -nodes -out C:\certs\pegalocal.key
docker login pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest
-- Enter the user name and key received in the email (prerequisite step 6) if prompted
docker run -p 3443:3443 -v C:\certs:/host_folder --name constellation-service pega-docker.downloads.pega.com/constellationui/service:8.6.0-rc-latest port=3443 urlPath=/constellation httpsKey=pegalocal.key httpsCert=pegalocal.crt logLevel=info
Enable SSL for Tomcat used by Pega Personal Edition by updating the server.xml file , I just used the nio implementation , snippet below.
I am using Client Cloud . I followed this pdn article : Pegasystems Documentation , but still unable to connect to constellation. Attached the screenshot for your reference.
I added the https://:/prweb/constellation to DSS : pega-uiengine!constellationsvcURL
@VaishnavyT3609 There’s a few things that you should probably check
The connectivity between the constellation service / ui service (the one which is a node js server) and the pega server (one which runs on tomcat or a similar web container) eg. check the firewall rules. A 404 is generally caused by connectivity problems . Make sure you follow Installing Constellation by using Docker | Pega
If you are sure there’s no connectivity related issues the next thing to check would certificate issues , make sure that there are no SSL errors
Finally make sure that the app you create in pega is created after any issues with the previous 2 points are solved and the constellationsvcURL is set
@DUTTAK01 How do we do step 5 of importing the certificate file into the tomcat truststore? Is it done through the keytool? If so, can you please provide the command?
@DilipKumarN when you talk about being stuck on step 3 ru talking about - the step for Installation of Constellation engine?
If so then by the looks of the error message it seems to be a issue with the docker container accessing the storage service. if so then make sure that WSL 2 is properly installed and has the necessary permissions (the one detailed in Install Docker Desktop on Windows | Docker Documentation).
1645115095929 storage-interaction: initialiseStorageServiceAndGUID : ping failed to service : Args = [object Object]
ConstellationUI service (HTTPS): listening on port 3443, static root=/usr/src/app/dist, url path=/constellation, nginx=null, loglevel=1
1645115095929 httpmain.cllnInitialise() - storage service not available for use
Hi, This is just a log statement for our understanding(“storage service not available for use”), it doesn’t have any impact on docker-based static service running. And your constellation service is up and running on 3443 port.
@KAUSTAV.DUTTA We have made all the configurations for 8.7 on our local desktop, however, we are still not able to connect to the constellation server. We have configured DSS ConstellationSvcURL to https://localhost:3443/constellation as well.
Do we need to have any other DSS configured for 8.7 or is the above DSS setting still valid for 8.7?
