Troubleshooting the blueprint design server

Derby conflict during installation

If you install IBM® UrbanCode™ Deploy and the blueprint design server on the same system and use Derby for both systems, you might see this error during the blueprint design server installation:

Starting embedded database ...
Stopping embedded database ...
[ant:java] : /opt/ibm-ucd-patterns/var/db is not a valid directory
        at org.apache.tools.ant.taskdefs.Java.setupWorkingDir(Java.java:855)
        at org.apache.tools.ant.taskdefs.Java.setupExecutable(Java.java:825)

In this case, use a different database for either system; do not use Derby for both IBM UrbanCode Deploy and the blueprint design server.

Palette does not show virtual images

If you do not see your virtual images in the palette, make sure that the images are configured properly. For example, Amazon EC2 images must be registered with the cloud discovery service; see Registering Amazon EC2 images with the cloud discovery service. For all clouds, see Configuring images for use with the blueprint designer.

Make sure that you are connected to the correct cloud project and that you have permission to see the images.

Check the logs

The default location for the blueprint design server logs is /opt/ibm-ucd-patterns/logs.

Permissions

Ensure that your user account has access to the correct cloud projects and other resources. To use the blueprint designer, a user account must be on a team and, and the account must have a role on that team. The team must have access to a cloud project. See Configuring security for the blueprint design server.

If your user account is imported from IBM UrbanCode Deploy, the components that you can see in the blueprint editor are limited by your permissions on the blueprint design server.

Check the cloud discovery service

The cloud discovery service receives many concurrent requests from the blueprint design server. Each request opens a file on the discovery service. If many users are using the blueprint designer at the same time, the discovery service might reach the open file limit. In this case, the blueprint design server does not respond normally. To resolve the problem, increase the number of files that can be open on the discovery service. On a Linux system, increase the ulimit value to allow more open files.

In versions before version 6.1.1.1, the discovery service could be installed automatically as part of an engine or separately from other components of the product. Beginning in version 6.1.1.1, the discovery service is installed as part of the blueprint design server.

Check the DNS access to the blueprint design server host name

If your blueprint design server is running on a cloud system that does not provide DNS lookup for host names, the blueprint design server might not function properly. In this case, blueprints do not appear on the dashboard page or in the list of files on the blueprint design server. You might also see errors when you create or update blueprints. In the log, you see errors that say Timeout occurred while waiting for a response from service tier.

To resolve this issue, add a reference that relates the host name to the IP address in the /etc/hosts file on the computer that hosts the blueprint design server.

Indentation problem B

Indentation is significant in Heat templates. Therefore, you must keep the indentation consistent throughout the template. To fix this problem, convert spaces to tabs and make sure that each indentation level in the template has the same number of tabs. This error tends to appear when you copy and paste from other editors into the blueprint editor.

Resized virtual machines on VMware did not change size

If you change the size of a VMware virtual machine in the blueprint designer, you might need to extend the file system to see the change on the virtual machine. See Increasing the size of a disk partition.

For more troubleshooting information, see the UrbanCode community on IBM developerWorks®: https://www.ibmdw.net/answers/questions/?community=urbancode.