Installing the server

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

Before you begin

Download and extract the files for IBM UrbanCode Release to a directory that contains no spaces or double-byte characters. These files are available for download from the IBM Passport Advantage® website. See the IBM UrbanCode Release download document.
If you are installing the server in a production environment, a supporting database is required. Whether you install a database or use an existing installation of a database, you need the connection information for the database when you install the IBM UrbanCode Release server. If you are not installing in a production environment, you can install an instance of Apache Derby, which is bundled with the product, when you install the IBM UrbanCode Release server. For production environments, see the appropriate topic for your database to determine what connection information is required for the installation procedure.
Install a Rational® Common Licensing server. See the following link: http://pic.dhe.ibm.com/infocenter/rational/v0r0m0/topic/com.ibm.rational.license.doc/topics/c_managing_lic.html.

About this task

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

Procedure

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 window and change to the directory where you extracted the disk images. 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.
In the launchpad, click Install IBM UrbanCode Release 6.0. IBM Installation Manager opens.
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.
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.
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.
If you are installing IBM Installation Manager, specify where to install it, as shown in the following figure.
Click Next.
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.
On the next page of the wizard, ensure that correct products are selected and then click Next.
On the next page, select the default language for the server and then click Next. After installation, each user can select a language; see Setting the language for the server.
Optional: To set up a mail server for sending notifications, specify the information for an SMTP server and then click Next. For more information about the properties on this page, see Configuring email notifications for deployments.
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
  
  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.
  
  Unsecured access port
  
  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.
  
  Secure access port
  
  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. This parameter specifies the install.server.web.https.port property in the installed.properties file.
  
  Shutdown port
  
  Specify the port to send shutdown requests to. The default is 8005.
  
  Note: Typically, IBM UrbanCode Release places the server.properties file in the UCRelease folder. Previous versions placed this file in a folder in your home directory. If the .urbancode folder (version 4.x) or .ibm folder (version 5.x) exists, the server.properties file found there is used. To use the version in the UCRelease folder, delete or rename the .urbancode folder or .ibm folder. In addition, if you want to install multiple Tomcat instances on the same system, you must delete or rename the folder.
- 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.example.com:8443/urelease, the new URL is https://myserver.example.com:8443.
  
  Note: When you use an existing Tomcat instance, an .IBM folder is created in your home directory if it does not already exist, and the server.properties file is placed there. In this case, the UCRelase directory is used as a placeholder. Because all Tomcat instances would point to the same server.properties file, do not use this option if you want to install multiple Tomcat instances on the same system.
- 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.
Click Next.
On the licensing settings page, in the License server elements field, specify the port and host name for the license server and then click Next. 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
Optional: On the mail settings page, specify the information for the SMTP server and then click Next.
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 are displayed 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 file 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. For example, a DB2 connection string looks like the following example:
```
jdbc:db2://mydatabase.example.com:50000/ibm_ucr
```
An Oracle database string looks like the following example:
```
jdbc:oracle:thin@mydatabase.example.com:1521:ORCL:
```
This field does not apply if you are installing a new instance of Derby.
Click Next.
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 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. If you are using Tomcat, the default port for nonsecure connections is 8080.

The initial credentials are the following values:

User ID: admin
Password: admin

Feedback