Installing the server in interactive mode
In interactive mode, you install the server by typing configuration information on the command line.
- If installing in a production environment, make sure that you have a license server with available licenses. See License management for more information.
- Ensure that the system that you are installing the server on meets the system requirements. See System requirements and performance considerations.
- Ensure that a supported version of a Java™ Runtime Environment (JRE) or Java Development Kit (JDK) is installed on the computer on which you are
installing IBM UrbanCode Deploy.
For more information, see System Requirements for IBM UrbanCode Deploy.
Supported JREs are included with the installation files.Important: Beginning in version 6.2.2, the IBM UrbanCode Deploy server and agent relays require a Java Runtime Environment (JRE) or Java Development Kit (JDK) version 11.Important:For best results, download and use the latest available version of the IBM Java Runtime Environment (JRE) for the IBM UrbanCode Deploy server and agent relays. An IBM JRE is available as a separate download. See the IBM developer kits page to get the latest version. Install the IBM JRE according to the documentation on the page. Be sure to set the JAVA_HOME system variable to the location of the IBM JRE. If you are updating or changing the JRE to the latest version, see Changing or updating the JRE of servers, Changing or updating the JRE of agents, and Updating the JRE location for agent relays for instructions. For documentation on the IBM JRE, see IBM SDK, Java Technology Edition.
- If you are installing the server to be compliant with Federal Information Processing Standards (FIPS), the computer must use a supported version of an IBM JRE or JDK.
- If you are installing the server in a production environment, install and configure the server database before you install the server. See Installing the server database. If you are not installing in a production environment, you can install an instance of Apache Derby during the installation steps. You can migrate the database to a different database system later, as described in Migrating the server database.
- If you are using a database other than Apache Derby for the server, place the JAR file for the database driver in the lib/ext folder of the installation program.
- If you are installing the server on AIX® platform, the unzip program is required.
- Make sure that your networks and firewalls allow communication on the required ports. See Firewall and communication configuration.
- To install and run the server on Linux™ as a non-root user, create a user to use when you install and run the server. Also, ensure that the user has read and write permission to the folder to which you are installing the server.
- Ensure that there is no limit on the maximum memory size and virtual memory size.
For example, on most Linux systems, you can run the
ulimit -m
andulimit -v
commands and ensure that both return the valueunlimited
. To find out how to remove the limit on the maximum memory size and virtual memory size, see the documentation for the operating system.
- Configure the high-availability cluster; see Setting up high-availability clusters.
- Ensure that the system on which you are installing the new server has a connection to the cluster network storage and that the system can connect to the database that the cluster is using.
- Each server in the cluster must run the same version of IBM UrbanCode Deploy.
Install the server in interactive mode:
If you install the server as a node in high-availability cluster, the installer loads the existing encryption keystore that is in the shared storage folder by using the default settings. If the default password is incorrect, you are prompted for the password. If after three attempts you do not enter the correct password, the installation process stops. If the keystore has more than one alias, you are prompted to specify an alias.
If you selected mutual authentication, set up the authentication. See Configuring mutual authentication.
- To specify a default agent, click General Settings, clear the Use Agent Tag For Integration check box. Then, select an agent in the Agent for Version Imports list. Then, at the bottom of the page, click Save. and under
- To specify a default agent tag, click General Settings, clear the Use Agent Tag For Integration check box. Then, select an agent tag in the Agent Tag for version imports list. Then, at the bottom of the page, click Save. If no tags are listed, add a tag to one or more agents on the server. and under
If you see "Out of memory" errors, increase the amount of memory that is available to the IBM UrbanCode Deploy service. See Increasing the amount of memory that is available to the server.
[echo] waiting for db to start - 6 seconds remaining
[echo] waiting for db to start - 3 seconds remaining
[echo] Could not start database
[echo] Stopping embedded database ...
[java] Tue Feb 04 09:11:25 EST 2014 : Could not connect
to Derby Network Server on host localhost, port 11377:
Connection refused
If
you see this error, you must change the default security settings for the Java installation on the server:- Open the Java security policy file in a text editor. If you are using a Java Runtime Environment (JRE), this file is at the location JAVA_HOME/lib/security/java.policy, where JAVA_HOME is the base folder of the Java installation. If you are using a Java Development Kit (JDK), the file is at the location JAVA_HOME/jre/lib/security/java.policy.
- In the java.policy file, in the section that is labeled
// default permissions granted to all domains
, within thegrant{}
block, add the following code:permission java.net.SocketPermission "localhost:11377", "listen";
- Run the installation program again.