Upgrade, Reconfigure, or Back Up ARD Hub

This article covers upgrading, uninstallation, reinstallation, database back-up and restore, and the configuration of port, proxy, and memory allocation for ARD Hub.
ard31
The Docker-based installation script
ard.sh
also handles upgrades, uninstallation, reinstallation, and the configuration of port, ssl proxy, and memory allocation. For information about the basic installation procedure, see Install ARD Hub Using a Docker Container.
If you are planning on upgrading ARD Hub to 3.1, first upgrade the desktop client to 3.0.5 or better.
This article covers the following advanced maintenance topics:
2
Advanced Installation Example
You can combine several options of the
ard.sh
script into one command. For example, to run the installer, change the port, and increase the heap size to 8 GB, you would execute the script with the following options:
./ard.sh --hostname myserver.example.org --port 1234 --jvm-heap-max-size 8192
Upgrade ARD Hub (Docker)
The installation script also handles upgrades for the Docker installation.
  1. Download the new installation package from the Customer Support Site, and unpack the archive
  2. Execute the new installer script with the options of your choice.
    ./ard.sh --hostname myserver.example.org
    The script detects that you have another version installed and prompts you with "Do you wish to upgrade from version x to y?"
  3. Respond Yes to continue or No to cancel.
    If you respond yes, the script backs up your previous configuration in the folder
    .ard/.backup
    and upgrades ARD Hub to the new version.
Upgrade ARD Hub (Manual)
If you installed ARD Hub manually, follow these steps to upgrade:
  1. Download the new installation package from the Customer Support Site, and unpack the archive.
  2. Remove the old .war files at
    TOMCAT_HOME/webapps/ard#*.war
    from your installation. The Tomcat server removes the associated directories automatically.
  3. Shut down the Tomcat server.
  4. Copy the contents of the downloaded
    hub_install_dir/war/
    directory to your
    TOMCAT_HOME/webapps/
    directory.
  5. Restart the Tomcat server.
Install ARD Hub Silently
When you run the installation script, it prompts you asking whether you want to proceed. To continue, you need to enter Y or N (yes or no) manually. To bypass this prompt and install ARD Hub silently, create a custom response file and pass the relevant answers to the shell script.
  1. Create a plain text file response.txt containing the letter Y on the first line.
  2. Save the file in the same directory as the installer script.
  3. Run the installer script with an input redirect from the response file:
    ./ard.sh --hostname myserver.com --port 8080 --jvm-heap-max-size 8192 --offline < ./response.txt
If the script prompts for more questions, include each custom answer in that response file, each on its own line, and rerun.
Configure a Reverse Proxy
Configuring a reverse proxy is useful if you want to use a secure HTTPS connection, or, if you do not want to use the port number in the ARD Hub URL.
The reverse proxy works for either HTTP or HTTPS. You could enable it for HTTP to try out a reverse proxy configuration without needing to obtain a security certificate. You can disable the reverse proxy again at any time.
  1. Enable the Proxy for HTTP:
    ./ard.sh --proxy-enable
    The script detects if you have the same version of ARD Hub already installed. In this case, it asks you whether you want to reinstall.
  2. Respond Yes to continue or No to cancel.
    If you respond Yes, the script updates the configuration to include the proxy settings. You find a backup of your previous settings in the folder
    .ard/.backup
    .
  3. Verify that a file
    .ard/conf/proxy.toml
    was created and that the file contains the new proxy config.
Now you can access the web interface by using the domain only (
http://myserver.example.org
), instead of the whole socket (
http://myserver.example.org:8080
).
Alternatively, you can also configure an SSL proxy.
  1. Get an SSL certificate from your certification authority.
  2. Copy the two certificate files to the
    .ard/cert
    folder and rename them as follows:
    • hub.crt
    • hub.key
  3. Enable the secure reverse proxy.
    ./ard.sh --proxy-ssl-enable
To disable the reverse proxy (and access the web interface with the specified port again), execute the following command.
./ard.sh --proxy-disable
Reconfigure the Port
To use a different port, execute the following command:
./ard.sh --port
new_number
Increase Memory Allocation
If you have issues with the memory usage of your server, increase the heap size. Allocating more memory becomes especially important before using the migration feature. The default Tomcat server heap size is 1.5 GB (1536 MB). If you migrate flows of large size or number, increase the heap size, for example, to 8 GB (8192 MB).
To increase the memory allocation, execute the following command:
./ard.sh --jvm-heap-max-size 8192
Reinstall ARD Hub
If your ARD Hub Docker installation worked previously, and you changed settings and it stopped working, try reinstalling it before calling Support. The reinstall command recreates the Docker containers and configuration, but it keeps your data. The command also keeps a backup of your previous configuration config in the folder
.ard/.backup
.
To reinstall ARD Hub, execute the following command:
./ard.sh --reinstall
Uninstall ARD Hub
ARD Hub includes the MySQL database that contains all your ARD flows at
.ard/storage/mysql
. If you execute the uninstall command, it removes all ARD Hub docker containers, configuration files, and all the flows in the storage. The command prompts to make archive the data as a backup.
To delete your ARD Hub installation, execute the following command:
./ard.sh --uninstall
If you responded Yes to archive the data, the command archives configuration files and database data in /var/ard/application-data/archive in a folder with a name such as
hub-archive_TIMESTAMP
.
Command Summary ard.sh
Run
./ard.sh --help
on the Linux command line to see all commands supported by the ARD Hub installer.
Installation command usage:
./ard.sh
OPTIONS
The installation command supports the following options:
  • --hostname
    server-domain-name
    Defines the fully qualified domain name of the host server (FQDN).
  • --port
    server-port
    Defines a custom port for the Host server port. The default is 8080.
  • --jvm-heap-max-size
    max-size-in-mb
    Specifies the maximum heap size for the Tomcat server in megabytes.
  • --offline
    Enables offline installation mode using pre-downloaded Docker files that you have copied into your docker registry.
  • --reinstall
    Re-installs the current version of ARD Hub.
  • --get-files
    Downloads the Docker images and installation files without installing ARD Hub.
  • --uninstall
    Uninstalls ARD Hub (including volumes, network, config). Make a backup of your data before uninstalling!
  • --proxy-enable
    Enables reverse proxy with HTTP for ARD Hub.
  • --proxy-ssl-enable
    Enables reverse proxy with HTTPS for ARD Hub.
  • --proxy-disable
    Disables reverse proxy for the Hub stack.
  • --version
    Shows the version of this installer script and quits.
  • --help
    Shows information about supported installer commands and quits.
Back Up ARD Hub Databases
Databases are stored in volumes. ARD does not perform any automatic database backups, so set up a backup schedule manually.
Your database is stored in
/var/ard/application-data/storage/mysql
. In this folder, there are two subfolders,
ARDFlowStorage
and
keycloak
, which store data for FlowStorage and Keycloak, respectively. A full backup does not only include the databases, but also the configurations and passwords.
Regularly back up the whole
/var/ard/application-data
folder. If there is a crash, having a backup of the whole folder makes it easier to recover an ARD Hub installation
Use ARD 2.10 Hub Database in ARD Hub 3.0 Installation
To use ARD Hub 2.10 databases in ARD Hub 3.0 installations, transfer the old
/var/ard/application-data
folder to the new machine, and install ARD Hub again. The installation script recognizes the data, including the database, and starts using it.
Restore Database From Back-Up
  1. Back up your old
    /var/ard/application-data
    folder.
  2. Uninstall ARD Hub. Uninstalling deletes all the data and configurations.
  3. Copy your backed-up
    /var/ard/application-data
    back to its old location.
  4. Re-Install ARD Hub. The Hub recognized the data, including the database, and starts using it.
Switch to an External FlowStorage Database
You can switch to an external FlowStorage database that is not the one in your volume.
  1. Install ARD Hub.
  2. Stop the ARD Hub container using the following command:
    docker container stop
    containerId
  3. Go to the
    /var/ard/application-data/.ard/conf
    folder and edit the
    settings.properties
    file.
  4. Change the following fields so they point to your database location:
    flow_storage.database.type=mysql flow_storage.database.host=f865402a-db flow_storage.database.port=3306 flow_storage.database.name=ARDFlowStorage flow_storage.database.user=root flow_storage.database.password=
    my_database_password
    flow_storage.database.tenant=ARDFlowStorage
  5. Save the
    settings.properties
    file.
  6. Start the ARD Hub container using the following command:
    docker container start
    containerId