Installing the server

Installing the server involves running IBM® Installation Manager and specifying configuration information for the server.

Before you begin

About this task

These instructions are for installing a new server. To upgrade an existing server, see Upgrading IBM UrbanCode Release.

Procedure

  1. Start the launchpad program.
    • If you are installing from a DVD and autorun is enabled on your computer, the launchpad program starts automatically when you insert the Setup DVD. Otherwise, run the launchpad.exe command on Microsoft Windows or the launchpad.sh command on Linux. The commands are in the root directory of the DVD.
    • If you are installing from a downloaded disk image, open a command line, change to the directory where you extracted the disk images, and then enter UCR\disk1\launchpad.exe on Microsoft Windows or UCR/disk1/launchpad.sh on Linux.
    The launchpad program starts. This program installs IBM UrbanCode Release. IBM UrbanCode Release requires IBM Installation Manager, so if you do not have it installed, you must install it now. You can install both products at the same time.
  2. In the launchpad, click Install IBM UrbanCode Release 6.0. IBM Installation Manager opens.
  3. On the first page of the Install Packages wizard, select the appropriate version of the product and of IBM Installation Manager if necessary, and click Next.
  4. On the Licenses page, read and accept the license agreements for the selected products. If you agree to the terms of all of the license agreements, click I accept the terms in the license agreement and then click Next.
  5. Type the path for the Shared Resources Directory, or accept the default path. This folder contains resources that can be shared by multiple products.
    Note: You cannot change the shared resources directory unless you uninstall all packages.
  6. If you are installing IBM Installation Manager, specify where to install it, as shown in the following figure.
    Specifying the shared resources directory and the location for IBM Installation Manager
  7. Click Next.
  8. On the next page, either select an existing package group or a new package group.
    • If you are installing into an existing package group, select the package group in the table and then click Next.
    • If you are installing into a new package group, specify the installation directory for the package group and then click Next.
  9. On the next page of the wizard, ensure that correct products are selected and then click Next.
  10. On the next page, specify the instance of Apache Tomcat on which to deploy IBM UrbanCode Release. Apache Tomcat is the only supported application server.
    • To install a new instance of Apache Tomcat, click Install Apache Tomcat 7 and specify the following information.
      Note: Do not select this option if the system has a previous installation of UrbanCode uRelease; in this case, see Upgrading IBM UrbanCode Release.
      Use secure SSL connections
      Select this check box to use secure connections.
      Host name or IP address of the server
      Specify the IP address of the computer to which you are installing the server.
      Unsecured access port
      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.
      Secure access port
      The default value is 8443. This parameter specifies the install.server.web.ip= property in the installed.properties file. If you are installing IBM UrbanCode Deploy and IBM UrbanCode Release, be sure to use a different port for each product.
    • To install IBM UrbanCode Release into an existing server, click Use an existing server and specify the following information:
      bin directory location
      Specify the location of the bin folder for the application server, such as /usr/share/tomcat6/bin.
      WAR file location
      Specify the folder that contains the WAR files, such as /var/lib/tomcat6/webapps.
      Context root
      Specify the context root of the application from the previous installation. In most cases, the context root is the name of the WAR file, excluding the .war extension.

      Alternatively, you can specify ROOT to make the application available at the base URL for the application server. In this case, the URL for the IBM UrbanCode Release server might change. For example, if the previous URL was https://myserver.mycompany.com:8443/urelease, the new URL is https://myserver.mycompany.com:8443.

    • To upgrade from UrbanCode uRelease version 4, click Upgrade an existing installation of UrbanCode uRelease version 4 and see Upgrading the server from version 4 to version 5 or 6.
  11. Click Next.
  12. On the licensing settings page, in the License server elements field, specify the port and host name for the license server, such as 27000@localhost and then click Next. For more complicated license server scenarios, see the following document: http://pic.dhe.ibm.com/infocenter/rational/v0r0m0/index.jsp?topic=/com.ibm.rational.license.doc/topics/r_specify_lic_servers.html
  13. On the database setup page, clear the Use settings from existing installation check box and specify the following parameters. Not all parameters apply to each type of database.
    Database type
    Specify the type of database. If you select derby, IBM Installation Manager 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.
    Warning: Derby is for evaluation purposes only; do not use Derby on a production server.
    Database user name
    Specify the user name for the database.
    Database password
    Specify the password for the database.
    Database driver class
    Specify the class name of the database driver. This field does not apply if you are installing a new instance of Derby.
    Database driver JAR location
    Specify the folder that contains the JAR file for the driver class. This field does not apply if you are installing a new instance of Derby.
    Complete database connection string
    Specify the complete connection string for the database, such as the following string:
    jdbc:oracle:thin@localhost:1521:ORCL:
    This field does not apply if you are installing a new instance of Derby.
  14. Click Next.
  15. Click Install. If a java.lang.OutOfMemoryError message is displayed during the installation process, increase the heap size of the Java™ Virtual Machine (JVM) used by IBM Installation Manager. Add the -Xmx1024M option to the IBMIM.ini file, which is located in the /eclipse folder in the directory where you installed IBM Installation Manager.

What to do next

Start the application server. If you installed an instance of Tomcat 7 along with the server, you can start the server by running the file server.startup on Linux or server.startup.bat on Windows. This file is in the server folder of the server installation folder.

After the server starts, you can access IBM UrbanCode Release at the following URL: http://host:port, where host:port is the host name and port of the server.

The initial credentials are the following values:
  • User ID: admin
  • Password: admin

Feedback