Installing the server

Installing IBM® UrbanCode™ Release Version 6.2.2 involves using a command-line installation program. The interactive process is started by locating the installation program in the downloaded product image.

To start, you need to know the location of the product disk image that you are installing. You must also have administrator authority.

If there is a previous installation that was installed with IBM Installation Manager, you have the option to replace the installation directory and create a back-up copy.

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

The install program prompts you for various information, you can specify values or take the default value. To accept a default value or not provide a value for the prompt, press Enter without specifying any information. Default values are displayed in a bracket, for example: [Default: Y]. It does not matter if you enter a value in upper-case or lower-case.

These instructions are for installing a new server. To upgrade an existing server, see Upgrading the version 6.2.2 and later server.

  1. Download and extract the installation files for IBM UrbanCode Release. The installation image files are available for download from the IBM Passport Advantage® website.
    Do not extract the files in the product installation directory, instead extract into a different directory.
  2. Stop the server.
  3. Open a command-line window. From the command line, run the server installation program. The installation program is located in the urelease-install directory.
    • On Windows™, run the install-server.bat file.
    • On Linux™, run ./install-server.sh.
  4. Read the license agreements for the software package.
    Press Enter to show one page at a time, or type F and then press Enter to show the entire license at once.
  5. Type Y and press Enter to accept the license agreement.
    If you do not accept the license agreement, the installation process will end.
  6. Specify the location for the server installation directory.
    Type the fully-qualified path for the IBM UrbanCode Release server installation directory. The default value is C:\Program Files\IBM\UCRelease.
    Note: Do not use any shell expansions or abbreviations, such as the tilde character (~).

    If the directory is new, you are prompted to verify that you want to create the directory. Type y and press Enter to create the installation directory. The installation will not complete if you enter n.

  7. Type the host name to be used to access the product user interface using a web browser. The default is the host name of the system.
    • 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, specify a host name that is not tied to the physical computer. By specifying such a host name, you can expand the server to a high-availability system later.
  8. Specify if you want the user interface to always use a secure connection using SSL. The default is yes.
    If you select to use a secure connection using SSL, you must configure a certificate for the server.
  9. 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.
    • If you are installing multiple instances of IBM UrbanCode Release on the same computer, be sure to use a different port for each instance.
  10. Specify the HTTP port for the server.
    Enter a port number that the Web user interface uses to redirect unsecured HTTP requests. The default value is 8080
  11. Specify the public URL for users to access the server.
    The default is constructed from the previous hostname, SSL and host prompts. If you are installing a server in a high-availability cluster, specify the host name of the load balancer for the cluster.
  12. Specify the connection information for the license server.

    Enter the port and hostname of a Rational License Key server which contains the product licenses for IBM UrbanCode Release. Type the value in the format of port@hostname, for example: 2700@licenses.example.com. Alternatively, you can leave this field blank to begin a 60-day evaluation period.

    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: Creating a text file that specifies license servers. For more information about licensing, see Managing licenses.

    Note: If adding server to existing high-availability cluster already configured with the license server, leave this field blank.
  13. Specify the database type to be used by the IBM UrbanCode Release server.
    Valid values are derby, mysql, oracle, sqlserver, and db2. You are prompted for applicable information about the database depending on the type of database that you select.
    If you select derby, the installation program installs a new instance of an Apache Derby database. If you install the server as a node in a high-availability cluster, you cannot use Derby.
    Warning: Derby is for evaluation purposes only. Do not use Derby for a production environment.
  14. Specify the user name to log into the database.
    If you are creating database schema, this user must have permission to create tables in the database. The default is ibm_ucr.
  15. Specify the password associated with the user name to log into the database.
    The default is password.
  16. If you are installing on Windows, specify if you want to install the server as a Windows service.
    If you select yes, additional prompts to configure the service are given.
    1. Type a unique service name.
      The name must be unique on the system and must not contain spaces.
    2. Type the user account name to run the service. The default value is the local system account.
      The user name must include the domain path to run the service. You must prefix local accounts with a period, such as .\localsystem.
    3. Specify to start the service automatically after the installation completes and each time the computer is started. The default value is N.
      Type Y start the service automatically. Otherwise, you can start and stop the service manually.
  17. After the installation completes, press Return to exit the installation program.
After the installation is complete, you can start the server from the command line. You can then access the IBM UrbanCode Release user interface.