Before you begin
The ID that you use to install the
product must be able to make changes to the host environment. The tools required by all installation
scenarios include the following items:
- Docker installed on the host system.
Note: If you use Docker for Windows, make sure Docker is
using Linux-type containers. IBM UrbanCode Velocity does not support Windows-type containers.
- Internet connection. During installation, files and container images are retrieved from remote
locations. If you are unable to access the internet during installation, you can download the files
beforehand and perform an offline installation. IBM UrbanCode Velocity supports the following browsers: Chrome, Firefox, and Edge.
Note: The installation files used for
offline installation are not the same as those used for internet-connected installation. Ensure that
you download the right file for you installation environment.
In addition to the requirements for all installation scenarios, the following items are required
for Docker Compose systems:
- Docker Compose version 17.09.0-ce, build afdb6d4 and later
- CPU with 4+ cores.
- 8GB RAM
- 8GB storage
- If you are using offline installation, you need 4GB free in your /tmp or
\temp directory.
- If you are installing the product on Red Hat Enterprise Linux, you need RHEL 7 or later.
Get a key. The key enables you to complete installation.
Visit the UrbanCode Velocity
web portal to obtain your key. After completing the form, you can copy the access key. Store
the key in a readily-available location; you use it during installation.
Note: Make sure that you
select a key for the product version that you want to install. Keys for the Standard Edition do not
work with the Community Edition and vice-versa.
About this task
The installation instructions describe installing the product on all supported operating systems.
The downloaded executable file steps you through the installation process and sets your installation
parameters.
Note: IBM UrbanCode Velocity is also available as a hosted service. In this case, IBM hosts the server for you. For more
information, see the
IBM Marketplace.
What to do next
Access the IBM UrbanCode Velocity Web UI. The URL is https://hostname:port, where hostname
and port are the values that you set during installation. The initial user name is
admin and the default password is admin.
Installation properties are stored in the
[installation_folder]/docker-compose/.env file. You can edit the properties
appropriate for your environment. The
env file contains a description for all
installation properties, including the following properties:
- Access_Key
- The product access key obtained earlier.
- NGINX_HOST
- The domain of the URL the users will use to access Velocity. The value is usually the hostname
of the virtual machine where Docker Compose is running.
To complete installation, replace the supplied SSL public certificate and private key with your
own copies. You can use OpenSSL to generate your own key with a command similar to the following
example:
openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certifcate.pem
Place your self-generated key and certificate in the
[velocity-install-folder/product_version_number/conf/ssl folder.
After you purchase the product, you receive a permanent access key, and a license key.