Portal Fails To Start After Upgrading To 5.2.3

Products

• CA API Developer Portal

Issue/Introduction

After upgrading to portal 5.2.3 we receive the following error when trying to start things up:

#./portal.sh
bi7c7cob8vk6dkaw1b7amr1xh
Creating secret DATABASE_USERNAME
pk6btkr30gjzbez8dckgnv8t6
Creating secret DATABASE_PASSWORD
Error response from daemon: rpc error: code = InvalidArgument desc = secret data must be larger than 0 and less than 512000 bytes

Environment

CA API Developer Portal 5.2.3

Cause

With portal 5.2.3 we now secure data contained within the portal.conf file via secrets so the values are not available in plain text while the portal is in a running state.  Entries contained within the portal.conf file should have a value associated with it or it will lead to the error being seen in this situation.

Resolution

Reviewing the portal.conf file we could see that there was no value associated with the PORTAL_SMTP_USERNAME or
PORTAL_SMTP_PASSWORD settings.

After updating these settings with values the portal started up successfully.

If you are not using smtp with your portal environment you can completely remove those settings from the portal.conf file.

Additional Information

Review our documentation which discusses this new feature in portal 5.2.3 here:

https://techdocs.broadcom.com/us/en/ca-enterprise-software/layer7-api-management/api-developer-portal/5-2/install-configure-and-upgrade/install-portal-on-docker-swarm/secure-portal-application-secrets.html