Upgrading a CPI

To upgrade a virtual node’s CPI Corda Package Installer. A signed ZIP/JAR combination of a CPB and a Group Policy File that defines not only the application code that a virtual node will run, but also the details of the MGM with which to register, and the details of network PKI requirements. , use the PUT method of the api/v1/virtualnode/<virtualnodeshortid>/cpi/<targetcpifilechecksum> endpoint :

To upgrade a CPI, do the following:

1. Set the state of the virtual node to MAINTENANCE.
2. Ensure no flows are running (that is, all flows have either “COMPLETED”, “FAILED” or “KILLED” status). You can check the list of running flows using GET /api/v1/flow/<holdingidentityshorthash>
3. Send the checksum of the CPI to upgrade to using the PUT method of the api/v1/virtualnode/<virtualnodeshortid>/cpi/<targetcpifilechecksum> endpoint :
   • Bash
   • PowerShell

   curl -k -u $REST_API_USER:$REST_API_PASSWORD -X PUT $REST_API_URL/api/v1/virtualnode/<virtualnodeshortid>/cpi/<targetcpifilechecksum>
   

   Invoke-RestMethod -SkipCertificateCheck -Headers @{Authorization=("Basic {0}" -f $REST_API_USER:$REST_API_PASSWORD)} -Method PUT -Uri $REST_API_URL/api/v1virtualnode/<virtualnodeshortid>//cpi/<targetcpifilechecksum>