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
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
-- 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.