Installing the server in interactive mode

In interactive mode, you install the server by typing configuration information on the command line.

Before you begin

About this task

The properties that are set during installation are recorded in the file server_install/conf/server/installed.properties on the server.

Procedure

  1. Download and extract the installation files for IBM UrbanCode Deploy. These files are available for download from the IBM Passport Advantage® website. See the IBM UrbanCode Deploy download document.
  2. If you are using a database other than Apache Derby, place the JAR file for the database in the lib/ext folder of the installation files.
  3. From the command line, run the installer program.
    • On Windows, run the install-server.bat file.
    • On Linux, run the install-server.sh file.
    • To install a FIPS-compliant server, add the switch -fips to the command, such as install-server.sh -fips .
      Note: If you install a FIPS-compliant server, cloud provisioning is not available.
    Depending on your system settings, you might need to run this file as an administrator.
  4. Read the license agreements for the software package. Press Enter to show one page at a time, or press F and then press Enter to show the entire license at once.
  5. If you agree to the terms of all of the license agreements, press Y and then press Enter.
  6. Specify the following information as the installation program prompts you. Accept the default values (displayed within brackets) by pressing Enter. If two options are given, such as [Y/n], the capitalized option is the default value.
    Enter the directory where the IBM UrbanCode Deploy server should be installed.
    Specify the installation directory for the server. The default server installation directory is /opt/ibm-ucd/server on Linux and C:\Program Files\ibm-ucd\server on Windows.
    Note: Do not use any shell expansions or abbreviations, such as the tilde character (~).
    The specified directory does not exist. Do you want to create it?
    Press Y to create the installation directory.
    Please enter the home directory of the JRE/JDK used to run the server.
    Specify the location of the JRE or JDK for the server.
    What host name will users access the web UI at?
    If you are installing a stand-alone server, specify the host name of the computer that hosts the server. If you are installing a stand-alone server in a production environment, consider using a host name that is not tied to the physical computer, so you can expand the server to a high-availability system later. If you are installing a server in a cluster, specify the host name of the load balancer for the cluster.
    Do you want the Web UI to always use secure connections using SSL?
    Press Y to use secure connections to the server.
    Enter the port on which the Web UI should listen for secure HTTPS requests.
    Specify the HTTPS port for the server. The default value is 8443. If you are installing IBM UrbanCode Deploy and IBM UrbanCode Release, be sure to use a different port for each product.
    Enter the port on which the Web UI should redirect unsecured HTTP requests.
    Specify the HTTP port for the server. The default value is 8080.If you are installing IBM UrbanCode Deploy and IBM UrbanCode Release, be sure to use a different port for each product.
    Enter the port to use for agent communication.
    Specify the port that agents use to contact the server. The default value is 7918.
    Do you want the Server and Agent communication to require mutual authentication?
    If you use mutual authentication, you must manually exchange a key between the server and each agent. For more information about this option, see Configuring mutual authentication.
    Enter the RCL server path(s).
    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://pic.dhe.ibm.com/infocenter/rational/v0r0m0/index.jsp?topic=/com.ibm.rational.license.doc/topics/r_specify_lic_servers.html

    For more information about licensing, see Managing licenses.

    Create database schema
    In most cases, press Y to create new schema definitions in the database. However, if you have a pre-populated database, such as if you are adding a server to a cluster, press N.
    Enter the database type to use.
    Specify the type of database. If you select derby, the installation program installs a new instance of Apache Derby for the server to use. Depending on the type of database you select, new fields appear for information about the database. Valid values are derby, mysql, oracle, sqlserver, postgres, and db2.
    Warning: Derby is for evaluation purposes only; do not use Derby on a production server.
    If you specify a type other than derby, specify the following database-related parameters:
    Enter the database driver.
    Specify the class name of the database driver.
    Please place the jar file containing the driver for your database inside the lib/ext directory in the IBM UrbanCode Deploy installer.
    Verify that you have placed the JAR file for the database driver in the lib/ext folder of the installation program and then press Enter.
    Enter the database connection string, including hostname, port, and SID.
    Specify the complete connection string for the database, such as the following string:
    jdbc:db2://localhost:50000/ibm_ucd
    Enter the database schema name.
    Specify the name of the database schema to create or use. This field is required on Windows if the user has the database administrator role. This field applies only to Oracle databases.
    Enter the database username.
    Specify the user name for the database. If you are creating the database schema, this user must have permission to create tables in the database.
    Enter the database password.
    Specify the password for the database.
  7. If you are installing on Windows, the installation program asks you the following additional questions after a pause:
    Do you want to install the Server as Windows service?
    Press Y to install the server as a Windows service.
    Enter a unique service name. No spaces allowed.
    Specify a name for the Windows service. The name must be unique on the system and must not contain spaces.
    Enter the user account name including domain path to run the service
    Specify the user account with which to run the service, including the domain path. Prefix local accounts with a period, such as .\localsystem.
    Do you want to start the service automatically?
    Press Y to start the server automatically. Otherwise, you can start and stop the server manually. See Running the server.
    User account password
    Specify the password for the user account.

Results

The installation program installs the server.

What to do next

To start the server, see Running the server.
If you are using Derby, you might see the following error in the results of the installation program:
[echo]     waiting for db to start - 6 seconds remaining
[echo]     waiting for db to start - 3 seconds remaining
[echo] Could not start database
[echo] Stopping embedded database ...
[java] Tue Feb 04 09:11:25 EST 2014 : Could not connect 
  to Derby Network Server on host localhost, port 11377: 
  Connection refused
If you see this error, you must change the default security settings for the Java installation on the server:
  1. Open the Java security policy file in a text editor. If you are using a Java Runtime Environment (JRE), this file is at the location JAVA_HOME/lib/security/java.policy, where JAVA_HOME is the base folder of the Java installation. If you are using a Java Development Kit (JDK), the file is at the location JAVA_HOME/jre/lib/security/java.policy.
  2. In the java.policy file, in the section that is labeled // default permissions granted to all domains, within the grant{} block, add the following code:
    permission java.net.SocketPermission "localhost:11377", "listen";
  3. Run the installation program again.
When you run the server for the first time, you might see an error message that says that no agent or tag is configured to import new component versions. To make this error go away, you must specify a default agent or agent tag to use when importing component versions. You can override this default setting when you create a component. Follow these steps to specify a default agent or agent tag:
  • To specify a default agent, click System > System Settings and under General Settings, clear the Use Agent Tag For Integration check box. Then, select an agent in the Agent for Version Imports list. Then, at the bottom of the page, click Save.
  • To specify a default agent tag, click System > System Settings and under General Settings, clear the Use Agent Tag For Integration check box. Then, select an agent tag in the Agent Tag for version imports list. Then, at the bottom of the page, click Save. If no tags are listed add a tag to one or more agents on the server.

Feedback