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.
-
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.
-
Stop the server.
-
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.
-
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.
-
Type Y and press Enter to accept the license
agreement.
If you do not accept the license agreement, the installation process will end.
-
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.
-
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.
-
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.
-
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.
-
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
-
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.
-
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.
-
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.
-
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
.
-
Specify the password associated with the user name to log into the database.
The default is password
.
-
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.
-
Type a unique service name.
The name must be unique on the system and must not contain spaces.
-
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.
-
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.
-
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.