HCL Domino Volt Installation, Configuration & New Features

Copyright © 2021 HCL Technologies Limited | www.hcltech.com
“Installation & Configuration,
Application Demo”
Speaker
Hemant Naik
Abhaysingh Shirke
TECHNICAL SPECIALIST

Copyright © 2021 HCL Technologies Limited | www.hcltechsw.com
About Us
Speaker – Hemant Naik
Senior Technical Lead
HCL Software & Digital
Solutions
Organizer - Vinayak Tavargeri
Senior Manager
HCL Software & Digital Solutions
vtavargeri@pnp-hcl.com
Technical Panelist - Rajendran
Jayavel
Senior Technical Architect
Technical Panelist - Shrikant
Jamkhandi
Group Technical Specialist
Technical Panelist – Ranjit Rai
Senior Technical Architect
Technical Panelist – Rajib Manna
ND/Sametime/SCN Consultant
Speaker – Abhaysingh Shirke
Senior Technical Lead
HCL Software & Digital
Solutions

Agenda
HCL Domino Volt Overview
Architecture & Components
System Requirement
Domino pre-configuration, Volt Installation and Configuration
HCL Domino Volt 1.0.1 and 1.0.2 Key Features
Some upcoming features
Application demo
Troubleshooting
References
Q&A

HCL Domino Volt Overview
4
 HCL Domino Volt is a web-based application builder running on the Domino
server
 Provides low-code app building capabilities for business users
 Provides simple workflow capabilities through document stages
 Implemented via Java OSGi bundles installed into Domino web engine
 All data is stored in documents in Domino databases.
 File uploads reside temporarily in default “temp” directory on server file-system

Copyright © 2021 HCL Technologies Limited | www.hcltechsw.com 5
Common Code (OSGi Bundles)
Web Builder UI
(existing)
Web Runtime UIs
(existing)
Form fill/update
Responses
Charts
Utilities
App (Re)Generator
MyApp.ntf
Forms
Views
application-compiled.xml
aux files (.css, .js, .png)
Static Builder files
Submission CRUD,
validation, and
workflow
App Definition
CRUD
“Deploy”
Static runtime files
Other Domino
“Channels”
Domino DAS (REST API’s)
Domino AppDev Pack
Domino Clients
Integrations
Compiled
generated
runtime files
Data
CRUD
application.xml
Browser
Browser
VoltApp.ntf
Generic
“template” for all
apps
Contains “building
blocks”
User/group lookups
MyApp.nsf
Forms
Views
Submissions + attachments
Runtime ACL’s
application-deployed.xml
aux files (.css, .js, .png)
Deployed
generated
runtime files
VoltBuilder.nsf
Holds app.xml definitions and metadata
deploy
compile
derived
from
1
2
3
4
VoltConfig.nsf
Product config settings
Preview{uid}.nsf
File resources used for preview
1.5
“Preview”

Supported Platforms:
 HCL Domino 11.0.0 64 bit or higher. Use HCL Domino 11.0.1 FP2 for best results
Supported Operating System:
Docker based container image for HCL Domino Volt starting with Domino V11.0.1
System Requirement for Domino :
https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0073794

Pre-configuration
7
 What components we need:
• HCL Domino Server 11.0.0 or greater.
• No Additional Component Required.
 What is needed on the Domino Server:
• Domino must be upgraded to V11 and above prior to installing Domino
Volt.
• Session-based authentication (SAML, SSO, or Single Server) must be
enabled.
• HTTP methods GET, DELETE, HEAD, POST, and PUT must be
enabled.
See Configuring the server for more information.
• Domino SMTP routing must be enabled and properly configured.
• The server ID file must not be password protected.
Reference: https://help.hcltechsw.com/domino_volt/1.0.2/install_overview.html

Domino Volt Configuration Before Installation
8
Server document configurations to change Session-based authentication
 Session authentication is enabled in the server document
under Internet Protocols > Domino Web Engine tab.
 If you are not using Internet Site documents, ensure that Load Internet configurations from ServerInternet
Sites documents is Disabled on the Basics tab.

Domino Volt Configuration Before Installation Continued…..
9
Internet site document configurations to change Session-based authentication
 If you are using Internet Site documents, ensure that Load Internet configurations from ServerInternet Sites
documents is Enabled on the Basics tab.
 Create an Internet site document in the Domino directory under Web->Add Internet site.
 Fill out the Descriptive Name, Organization, and other fields on the Basics tab & enable the session
authentication on the Domino Web Engine tab.

10
 Enable HTTP options method on the Domino Web Server the required options to be enabled are
GET,POST,PUT,DELETE,HEAD
 If the session authentication is Enabled in the server document to enable HTTP options set the below
server notes.ini to enable http options.
HTTPEnableMethods=GET,POST,PUT,DELETE,HEAD
 If you are using Internet Site documents, to enable the HTTP options for the HCL Domino Volt web server.
1. From the Domino Administrator client, click Configuration > Web > Internet Sites.
2. Double click to edit the Internet Site. On the Configuration tab, enable the methods GET, DELETE, HEAD,
POST, and PUT.

11
Continue…..
3. Create a Server group “Volt Authors” with group type “Access Control List only”

Installation Process - Windows
12
 Extract the hcl.domino.volt-1.0.2.9.zip file.
 Start the command prompt with “Run As Administrator”
 Switch to the extracted directory and from the windows folder run install.bat to install Domino volt.
INSTALLATION of Domino VOLT completes.
Restart the Domino server.

Installation Process - Linux
13
You need to have root privilege to install the HCL Domino Volt. Run ./install.sh from the HCL Domino Volt
extracted directory as shown below. Note, you need to change the permission of the install.sh file to the root user
“chmod 755 install”

Installation Process - Linux
14
Type “Y” to the ‘Proceed with installation?’ to install the Volt.
INSTALLATION of Domino VOLT completes.
Restart the Domino server

Installation Process - Docker Container
15
* The following are prerequisites to deploy a new Volt server on Docker:
 Install and correctly configure Docker.
 Volt Docker image has to be loaded on the Docker machine.
 If you are adding the new server to an existing Domino domain, register the server and take the server.id file to
the Docker machine.

Installation Process - Docker container Continued…..
16
To deploy a new Volt server on Docker, complete the steps in the following sections..
 Creating the Docker volume to store the data directory
Create a Docker volume. The Docker volume is a persistent location to hold the Domino data directory.
 Creating a temporary Docker container for remote server setup
docker run --rm --name dominosetup -v notesdata:/local/notesdata --hostname mydocdomino.hclpnp.com -p 8585:8585 -p 1352:1352 volt-
docker:V1101FP2-1.0.2.9 --setup

17
Creating a temporary Docker container for remote server setup continued..
 Use remote server setup to configure the Domino volt server.
 You need to copy the server.id file to the Docker volume by taking the container ID from another terminal with
docker ps command to the know the temporary container ID.
docker cp /home/notes/server.id 64aaa204b82:/local/notesdata

18
Creating a temporary Docker container for remote server setup continued..
 Choose the server.id and continue with the server setup and finish it.
 Creating a Docker container for Volt -> Running Domino Volt container in Interactive mode
docker run -it --name domino-volt -v notesdata:/local/notesdata --hostname mydocdomino.hclpnp.com --cap-add=SYS_PTRACE -p 1352
-p 443:443 volt-docker:V1101FP2-1.0.2.9
 Completing the Domino Volt server Installation.

Domino Volt Configuration
19
 Open Domino Admin Client and you can see Volt folder within Data directory, few Volt Templates and
databases (VoltConfig & VoltBuilder) created as Shown
 If in case the databases are not created, you can use the domino
command line to create the database from the Volt templates.

Domino Volt Configuration Continued…..
20
 Set the ini by issuing the command  set config Cluster_Admin_On=1
Issue the command
CL Copy volt/VoltConfig.ntf volt/VoltConfig.nsf
CL Copy volt/VoltBuilder.ntf volt/VoltBuilder.nsf
 In some scenarios, an AccessDeniedException or an AccessControlException occurs.
To prevent these exceptions, please add the following permission instructions to your java.policy file:
grant codeBase "file:/groovy/shell" {
permission java.security.AllPermission;
};
The java.policy location is:
Windows: [Domino_PROGRAM]jvmlibsecurityjava.policy
Linux: [Domino_PROGRAM]/notes/latest/linux/jvm/lib/security/java.policy
Restart Domino server and verify Volt installation. Run the following console command:
tell http osgi ss dleap
Note: If output does not include this line “ACTIVE dleap_[version]”, do not proceed. Recheck all preceding configuration steps.

Verify VoltBuilder.nsf
 The HCL Domino Volt Builder database is used to store Volt application designs and for other processing.
 From the Notes/Admin Client, open the Volt Builder database on the server (volt/VoltBuilder.nsf). Verify the database
ACL.
Suggested ACLs for VoltBuilder.nsf:
Volt Authors should have Editor access with delete privileges. Use the group name you created on the server.
Optional: Assign [VoltAppsManager] role to at least one administrator. Users in this role will be able to view and edit all
Volt applications.

Default access should be Reader.
Anonymous should be NO ACCESS.
Continue…..

Verify VoltConfig.nsf
 The HCL Domino Volt Configuration database is used to
manage configuration information specific for your
environment.
 HCL Domino Volt is capable of operating absent of any
enabled settings except the Server URI.
A. From the Notes/Admin Client, open the Volt Config
database on the server (volt/VoltConfig.nsf)
B. From the All Settings view, select and edit the setting
serverURI.

Set the Setting Value to match the appropriate URI for your HCL Domino Volt server.
An example value https://domino-volt.acme.com/volt-apps. Be sure to specify https if you use SSL configured on the
server.
 Ensure the setting is Enabled.
 Click Done to save and close the Setting document,

Suggested ACLs for VoltConfig.nsf:
Default access should be No Access.
Anonymous should be NO ACCESS.

Ready to use Domino Volt….
Log in to Volt
Once you’ve completed configuration, issue command
“restart task http” at the server console.
The absolute URL depends on your server host name
and whether you have enabled https on your server.
The relative URL is /volt-apps/secure/org/ide/manager.html
Full URL example: https://domino-volt.acme.com/volt-
apps/secure/org/ide/manager.html
Now launch a browser and visit the Volt Manager page.
Login as an user who is part of Volt Authors group, or
as a user with equivalent privileges.

Domino Volt 1.0.1 and 1.0.2 Key Features
27
Volt 1.0.1
 Anonymous Access
 Direct Access to Domino Data
 Out-of-the Box Directory Services
 Dynamic Role Assignments
 Application upgrade
 Improved File UI in Text Widget
 New JavaScript Editor
 PDF Document Integration
 Service Catalog
Volt 1.0.2
 Properties in side panel instead of modal dialog
 Name picker widget
 Sortable columns
 Optional full text index
 Include an attachment with a workflow email
 Application history
 Custom themes
 Unread marks disabled

Domino Volt 1.0.1 Key Features
28
Features Description
Anonymous Access
Extend the value of Domino Volt to those outside of your organization by building apps which can be used
without authenticating against your directory.
Direct Access to
Domino Data
Provides Domino Volt designers with a simplified way to integrate data from Domino views and documents into
their apps.
Out-of-the Box
Directory Services
Lookup information about people in the directory.
Dynamic Role
Assignments
Build apps where users are dynamically assigned to roles. This feature works with the new out-of-the-box
directory services.
Application Upgrade
Update an app already in production with edits and modifications. This updates the app in place, so the URL
used to access the app and data collected so far stays intact.
Improved File UI in Text
Widget
Easily add and manage files and images used in your Text items.
New JavaScript Editor
The new editor highlights JavaScript syntax and provides prebuilt code snippets and an object selector for fast
code completion, increasing designers’ productivity.
PDF Document
Integration
Add fillable PDF templates to your app for PDF document creation. Store the resulting PDF locally or with the
submission record.
Service Catalog Define and catalog service definitions which can be used by Domino Volt app designers.

Domino Volt 1.0.2 Key Features
29
Properties in side panel
instead of modal dialog
Many properties are now in the side panel instead of a modal dialog. Provides much smoother interface for
working to Developers.
Name picker widget New field type in Palette to lookup names from Domino directory.
Sortable columns Ability to select sortable columns in “View Data” page.
Optional full text index Enable Full Text index which is optional.
Include an attachment
with a workflow email
Attachment can be attached with workflow emails.
Application history Check application history with details like what was the action, who acted and when.
Custom themes Add additional custom themes on server so developers can pick them when creating new volt app.
Unread marks disabled Unread marks is disabled for new applications to improve performance.

Some Upcoming Features
30
App Pages
Non-Form Pages, no workflow stages, add display/data items, data grid, HTML fragments, use rules and
services, includes JS API functions.
Data Grid
Display data from a Form, select source and fields to display, set sort and filer options, can be added to App
page or Form page.
Navigation Move from any page in app to any other page without using Javascript.
Volt Link
Provides integration with databases, SAP, Salesforce, ServiceNow, Excel, PDF, ODATA, REST, SOAP and
much more.
Create, Update and Delete
Domino Data
Full CRUD (Create Read Update Delete) between Volt and Domino databases.
Run Agents Run agents residing in Domino database.
Role Based Rules Set rules that will be based on roles.
Rich Text Item on Palette Add rich text field on Form.

Application Demo
31

Troubleshooting (Some known issues)
32
 Unable to open Volt URL after configuration: When opening "volt-apps" URL on the browser, it get stuck with "Loading the
Manager…“ message.
 Error "HCLDomino] was unexpected at this time" while installing Domino Volt on Windows.
 "Failed to Validate" error when deploying Volt App
 Error message: WARNING CLFAD0251W: Requesting user authentication
Problem: When you log in to Volt, you may see above error message in server console.
Workaround: Add following line to "/{domino-data}/domino/workspace/.config/rcpinstall.properties" and restart HTTP task.
com.ibm.domino.xsp.bridge.http.manager.level=SEVERE
 Domino installers remove Volt
Problem: Domino installers remove Volt. For example, if you upgrade from Domino 11.0.0 to 11.0.1, it removes Volt bundles
from “/{domino-program}/osgi/volt” folder.
Workaround: Reinstall Volt after you upgrade Domino. Be sure to stop Domino server before you reinstall Volt. You may
leave “/{domino-data}/volt” directory in place for upgrade.

Troubleshooting (Tips)
33
 Server side errors are logged in “/[Domino_DATA]/domino/workspace/logs”
 Client side errors sometimes refer to a server side log message. For example:
 You should always gather the server side logs when reporting a problem.
 If the problem is application-specific, you should also send a .volt or .xls file.
 Verbose logging can be useful in some circumstances.
https://help.hcltechsw.com/domino_volt/1.0.2/troubleshooting.html

Troubleshooting (Tips)
34
 For troubleshooting issues, the following log level settings can be enabled in
“[Domino_DATA]dominoworkspace.configrcpinstall.properties”:
com.ibm.form.level=FINE
com.ibm.form.nitro.level=FINEST
com.ibm.form.builder.level=FINEST
com.ibm.hrl.level=FINEST
com.ibm.freedom.level=FINEST
com.hcl.nitro.level=FINEST
dleap.level=FINEST
 Don’t leave verbose logging enabled in production as it will impact performance.

References
35
 Domino Volt 1.0.2 Documentation:
https://help.hcltechsw.com/domino_volt/1.0.2/welcome.html
 System Requirement for Domino:
 Installing Domino Volt:
https://help.hcltechsw.com/domino_volt/1.0.2/installing.html
 Sandbox:
https://volt.myhclsandbox.com/volt-apps/secure/org/ide/manager.html
 Fix list:
 Troubleshooting:
https://help.hcltechsw.com/domino_volt/1.0.2/troubleshooting.html
 Domino Volt Wiki:
https://hclwiki.atlassian.net/wiki/spaces/HDV/overview
 Domino Volt Forum:
https://hclpnpsupport.hcltech.com/community?id=community_forum&sys_id=411628061b35489083cb86e9cd4bcb00

KEYWORD KEYWORD
Thank You !!
Questions, Answers & Feedback

$10 BILLION | 159,000+ IDEAPRENEURS | 50 COUNTRIES

HCL Domino Volt Installation, Configuration & New Features

Recomendados

Recomendados

Más contenido relacionado

La actualidad más candente

La actualidad más candente (20)

Similar a HCL Domino Volt Installation, Configuration & New Features

Similar a HCL Domino Volt Installation, Configuration & New Features (20)

Último

Último (20)

HCL Domino Volt Installation, Configuration & New Features