Installing the blueprint design server in silent mode

In silent mode, you install the blueprint design server by specifying configuration information in command-line arguments. This installation includes the cloud discovery service.

Before you begin

Ensure that your account has the required permissions:
- If you install the blueprint design server on a Linux operating system, root access is required. The operating system must have the most recent package updates. For more information, see Installing and Managing Software in the Red Hat Enterprise Linux customer portal.
- If you install the blueprint design server on a Windows operating system, your account must be a member of the Administrators group.
Make sure that your system meets the system requirements. See System requirements and performance considerations.
Make sure that your networks and firewalls allow communication on the required ports. See Firewall and communication configuration.
Make sure that you have a license server with available IBM UrbanCode Deploy licenses and the connection information for that license server.
Install an engine. You can install the blueprint design server and engine on the same computer or on different computers. See Installing engines. If you install the engine and blueprint design server on the same computer, you must install the same version of each program.
Install or upgrade the IBM UrbanCode Deploy server.
Create an authorization token on the IBM UrbanCode Deploy server. You must have this token to retrieve information about components from the server.
Configure a database for the blueprint design server. See Installing the blueprint design server database.
If you are using a database other than Apache Derby, download the JDBC JAR file for the database.
If you install the blueprint designer on a Linux operating system, install the following prerequisite packages:
- gcc
- python-devel

Procedure

Download and extract the installation files for the blueprint design server. These files are available for download from the IBM Passport Advantage® website. If you are installing on Windows, extract the installation files to a folder that does not have a space in the path. See the IBM UrbanCode Deploy download document.
If you are using a database other than Apache Derby, place the JAR file for the database driver in the installation directory. On Linux, place it in the installation_directory/ibm-ucd-patterns-install/web-install/media/server/opt/tomcat/lib folder, and on Windows, place it in the installation_directory\media\server\opt\tomcat\lib folder.
Read the license agreement. On Linux, it is in this folder: installation_directory/ibm-ucd-patterns-install/web-install/media/server/licenses/. On Windows, it is in this folder: installation_directory\media\server\licenses
From the command line, change the working directory. On Linux, change to the installation_directory/ibm-ucd-patterns-install/web-install/ folder, and on Windows, change to the installation_directory folder.

From the command line, run the installation command. This command must be on a single line.

On Linux, run the following command:
```
./install.sh -l options
```
On Windows, run the following command:
```
./install.bat -l options
```

Note: The -l option in this command indicates that you read and accepted the license agreement.

For options, include all the following arguments:

Argument	Default value	Required or optional	Description
`-f install_directory`	On Linux, /opt/ibm-ucd-patterns, and on Windows, C:\Program Files\ibm-ucd-patterns	Optional	Specify the directory to install the blueprint design server in.
`-i server_hostname`	The host name of the current system	Required	Specify the public IP address or host name that other systems, such as the IBM UrbanCode Deploy server, use to access this system.
`-o ucd_server`	`https://localhost:8443`	Optional for Linux, not applicable for Windows	Specify the full URL of the IBM UrbanCode Deploy server, including the port number. Note: Do not include a slash at the end of this URL.
`-t token`	None	Optional for Linux, not applicable for Windows	Specify the authorization token for the connection to IBM UrbanCode Deploy.
`-e cloud_discovery`	`http://localhost:7575`	Required	Specify the URI to the cloud discovery service, which is URL of the blueprint design server with the default port 7575, such as `http://blueprint_design_server.myserver.com:7575` .
`-d db_type`	`derby`	Required	Specify the type of database to use. For production systems, specify `mysql`, `oracle`, or `sqlserver`. For evaluation systems, you can also specify `derby` to have the installer create a database for you.
`-a db_url`	`jdbc:mysql://localhost:3306/ibm_ucdp`	Required if you are not using a Derby database	Specify the URL of the database. If you followed the instructions in Installing a MySQL database for the blueprint design server, the database connection URL is `jdbc:mysql://hostname:3306/ibm_ucdp` , where `hostname` is the host name or IP address of the database server. If you are using the MySQL database on an engine, specify `jdbc:mysql://engine.example.org:3306/ibm_ucdp` , where `engine.example.org` is the host name or IP address of the engine.
`-v db_user`	`ibm_ucdp`	Required if you are not using a Derby database	Specify the user name for the database.
`-q db_password`	`password`	Required if you are not using a Derby database	Specify the password for the database.
`-m mysql_driver`	`com.mysql.jdbc.Driver`	Required if you are not using a Derby database	If you are using a MySQL, Oracle, or Microsoft SQL Server database, specify the class name of the MySQL driver. If you are using Derby, omit this argument.
`-r rcl_string`	None	Required for Linux, not applicable for Windows	Specify the connection information for the license server. You can specify the port and host name or IP address for the license server, such as `27000@RCLServer.example.com`. To avoid problems when a license server is not available, you can specify multiple license servers. In this case, separate each address with colons on Linux and UNIX or semicolons on Windows, as in the following example: `27000@RCLServer.example.com;27000@backupRCLServer.example.com` . For more complicated license server scenarios, see this document: http://www-01.ibm.com/support/knowledgecenter/SSSTWP_8.1.4/com.ibm.rational.license.doc/topics/r_specify_lic_servers.html. For more information about setting up a Rational® Common Licensing server and applying licenses, see the Rational Common Licensing help: http://www-01.ibm.com/support/knowledgecenter/SSSTWP_8.1.4/com.ibm.rational.license.doc/helpindex_RCL.html. For more information about licensing, see License management.

For example, the following Linux command installs the blueprint design server, installs a Derby database for the blueprint design server to use, and connects to the server:

./install.sh -l 
-i designserver.example.com
-o https://deployserver.example.org:8443 
-t ABCDE12345 
-e http://engine.myserver.com:7575 
-d derby 
-r 27000@RCLServer.example.com

The following Windows command installs the blueprint design server and installs a Derby database for the blueprint design server to use:

./install.bat -l 
-i designserver.example.com
-e http://engine.myserver.com:7575 
-d derby

These examples are split onto separate lines for clarity, but the command must be entered on a single line. To use another database, you must specify the information for the existing database. Be sure to place the place the JAR file for the database driver in the installation directory. The following example for Linux uses a MySQL database:

./install.sh -l 
-i designserver.example.com
-o https://deployserver.example.org:8443 
-t ABCDE12345 
-e http://engine.myserver.com:7575 
-d mysql 
-a jdbc:mysql://localhost:3306/ibm_ucdp
-v ibm_ucdp
-q password
-m com.mysql.jdbc.Driver
-r 27000@RCLServer.example.com

If you omit a required argument, the installation program prompts for the value, which means that the silent installation becomes interactive.

Configure the cloud discovery service. See Configuring the cloud discovery service.
Start the cloud discovery service. See Starting the blueprint designer, cloud discovery service, and engine.
If you installed the blueprint design server on the same computer that you installed the engine, restart the Heat services:
1. ```
service openstack-heat-engine start
```
2. ```
service openstack-heat-api start
```
3. ```
service openstack-heat-api-cfn start
```
4. ```
service openstack-heat-api-cloudwatch start
```
If you installed a Keystone server when you installed the engine, start it by running the following command:
```
service openstack-keystone start
```
Start the blueprint design server:
- On Linux, run the following command:
```
server_installation_directory/bin/server start
```
  Use the location of the blueprint design server installation for server_installation_directory. The default installation directory is /opt/ibm-ucd-patterns. By default, the command looks like the following code:
```
/opt/ibm-ucd-patterns/bin/server start
```
- On Windows, run the following command:
```
C:\server_installation_directory\bin\start_server
```
  Use the location of the blueprint design server installation for server_installation_directory. The default installation directory is C:\Program Files\ibm-ucd-patterns. By default, the command looks like the following code:
```
"C:\Program Files\ibm-ucd-patterns\bin\start_server"
```
Optional: On Windows, connect the blueprint design server to the server. See Connecting the blueprint design server to the server.
Change the local Git server password. See Changing the local Git server password.
Provide the IBM UrbanCode Deploy server with files that install an agent on the cloud instances that you provision. Follow these steps on a Linux computer to 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.

Results

You can access the blueprint design server by opening the following URL in a web browser: https://hostname:port/landscaper , where hostname is the host name of the blueprint design server and port is the HTTP port that you specified when you installed the blueprint design server. The default administrator user name is ucdpadmin, and the default password is ucdpadmin .

What to do next

If you did not connect the blueprint design server to the IBM UrbanCode Deploy server during the installation, connect it now. See Connecting the blueprint design server to the server.
Connect to a cloud. See Overview of integrations.

Feedback