Home
Administering Volt
The following topics contain information for HCL Domino Volt admins.
HCL Link integration
HCL Link provides a platform for data and application integration.
HCL Link installation and administration
The following topics describe how to install and configure Link for use with Domino Volt.
Linux installation
The following topics describe how to install Link for use with Domino Volt.
Native installation

Administering Volt
The following topics contain information for HCL Domino Volt admins.
- Controlling who creates HCL Volt applications
  To configure who can create and delete applications, you need to modify the Access Control List (ACL) for VoltBuilder.nsf.
- Volt configuration settings
  Volt configuration settings are in VoltConfig.nsf in the volt folder of your Domino data directory (volt/VoltConfig.nsf). Use the Notes client or the Domino Administrator client to modify a configuration setting.
- Core Domino server configuration
  HCL Domino Volt is an add-on to the core HCL Domino server. Volt runs in the context of the Domino web server (HTTP process). Therefore, Volt is affected by the underlying Domino server configuration. This topic covers some of the core configuration settings that may affect Volt.
- Upgrading from prior releases
  Beginning with Volt 1.0.2, all Volt NSF files set the database property Don't Maintain Unread Marks as default, which should improve performance. NSF files created in prior versions of Volt are not changed.
- Adding a custom theme
- Volt Cleanup process
  Volt Cleanup primarily purges orphaned Builder attachments, orphaned application attachments, and old Preview databases. Prior to release 1.0.3, this process was done by the Volt Cleanup Agent.
- Enabling basic authentication for HCL Volt API requests
  If form-based authentication is enabled, you will see an HTML form for authentication instead of a pop-up window. This topic provides instructions on how to disable HTML form-based authentication for the HCL Volt server API URL paths and enable basic authentication.
- Securing your Volt deployment
- HCL Link integration
  HCL Link provides a platform for data and application integration.
  - HCL Link installation and administration
    The following topics describe how to install and configure Link for use with Domino Volt.
    - Windows installation
      The following topics describe how to install HCL Link on Windows.
    - Linux installation
      The following topics describe how to install Link for use with Domino Volt.
      - Link utility
        After extracting the HCL Link package, you can interact with the Link script to begin installation. Actual steps are provided in the Native and Docker installation sections.
      - Native installation
      - Docker installation
      - Troubleshooting
    - Configuring Link
    - Defining Link artifacts
      To use Link with Domino Volt, you must define connections to the resources you want to access, and then actions that define an operation that uses a connection.
  - Integrating Link with HCL Volt

Native installation

Dependencies

bash (Bourne Again SHell)

ksh (KornShell)

libnsl

GNU sed

Prerequisites

You must have a MongoDB Server.

Configuration

Configure HCL Link before running any installation commands. If you choose not to, you might need to re-install for your updated configuration to take effect.

Configure the following files before installation (use ‘native’ post-fixed versions):

hip-server-native.env
tx-rest-native.properties

To re-configure after installation, update those files, and run the install command. This overwrites the configuration files in the install directory.

Several directories are specified in the configuration files. If the user or group you install into lacks R/W access to these directories, a system admin needs to create them and then transfer ownership.

If you are installing as non-root (recommended), change the HIP_HTTPS_PORT specified in hip-server-native.env to a number above 1024. The standard Linux kernel prevents regular users from starting processes that bind to any port below 1024. Alternatively, you can use setcap to overcome this limitation:

Install Link before using setcap:

sudo setcap ‘cap_net_bind_service=+ep’ <link_package>/node-context/install/nodejs/bin/npm
sudo setcap ‘cap_net_bind_service=+ep’ <link_package>/node-context/install/nodejs/bin/node

Installation

Read the Link Utility documentation before following the installation steps. You may need to adjust commands according to your environment.

The commands listed in these steps are intended to demonstrate a quick-start scenario:

./Link configure --type native --integration oem
./Link install

Either start all components or continue to the Troubleshooting section for any errors:

./Link start