The server provides services such as the user interface
used to configure application deployments, the work flow engine, the
security service, and the artifact repository, among others. Installing
the server involves specifying configuration information for the server,
such as the ports that the server uses.
Before you begin
If you are installing the server in a production environment,
install and configure the database before you install the server.
See
Installing the database. If you are not installing
in a production environment, you can install an instance of Apache
Derby during the installation steps.
Note: If you are installing on AIX®, the unzip program
is required.
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
- 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.
- 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.
- From the command line, run the installer
program. On Windows, run
the install-server.bat file. On Linux, run the install-server.sh file. Depending on your system settings, you might need to run this
file as an administrator.
- 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.
- If you agree to the terms of all of the license
agreements, press Y and then press Enter.
- 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.
- 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 JD for the server.
- What host name will users access the web UI at?
- Specify the host name for the server.
- 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.
- 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.
- 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 elect to 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
- 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.
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:oracle:thin@localhost:1521:ORCL:
- 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.
- Enter the database password.
- Specify the password for the database.
- 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.