Connecting the blueprint design server to the server

In most cases, you connect the blueprint design server to the server at installation time, but you can also connect them later.

Before you begin

Install the server, engine, and blueprint design server.

Procedure

Connect the server to the blueprint design server:
1. On the server, click Settings > Pattern Integrations.
2. Click New Pattern Integration.
3. Specify a name for the connection to the blueprint design server.
4. In the URL field, specify the complete URL to the blueprint design server, such as http://patterns.example.com:8080/landscaper.
5. Specify the user name and password to use to connect.
6. Click Save.
Connect the blueprint design server to the server:
1. In the blueprint designer, click Settings > System Settings.
2. In the UrbanCode Server URL field, specify the complete URL of the IBM® UrbanCode™ Deploy server, such as https://ucdserver.example.com:8443.
3. With an IBM UrbanCode Deploy server account that has access to the components, authenticate with either a token or a user name and password:
  - To specify a token, set Token Based Authentication to On. On the server, generate a token by clicking Settings > Tokens and then clicking Create Token. In the blueprint designer System Settings window, specify the token value in the Token field.
  - To specify a user name and password, set the Token Based Authentication toggle button to Off. In the Username and Password fields, enter the IBM UrbanCode Deploy server user name and password.
  Note: When a user edits a blueprint, that user can see the components that are associated with this token or user name. To restrict access to components, import user accounts from the IBM UrbanCode Deploy server; see Importing user accounts from IBM UrbanCode Deploy to the blueprint design server.
4. Click Save.
From a Linux computer, install the agent components on the server. These components are included automatically in deployments that require agents.
1. Download and extract the installation files for the agent components. These files are available for download from the IBM Passport Advantage® website. See the IBM UrbanCode Deploy download document.
2. Set the system JRE to the JRE that is provided in the blueprint design server installation files. To temporarily set the JRE, use the following command:
```
export JAVA_HOME=installation_directory/ibm-ucd-patterns-install/web-install/media/server/java/jre
```
  For installation_directory, use the location of the blueprint design server installation files.
3. From the command line, run the installation program with this command:
```
./install-agent-packages.sh -s ucd_url -a token
```
  where:
  - ucd_url is the full URL of the IBM UrbanCode Deploy server, such as https://deployserver.example.org:8443
  - token is a token from the server
4. On the IBM UrbanCode Deploy server, verify that the agent components were created. The names of the components are ucd-agent-linux-ppc64, ucd-agent-linux-x86_64, and ucd-agent-win-x86_64.
5. On the IBM UrbanCode Deploy server, add these components to any teams that provision environments from the blueprint designer. Users must have access to these components to provision environments from the blueprint designer.

Feedback