HOPEX Application Server (HAS) Architecture Overview
Foreword
What is HAS?
What is HOPEX Store?
Logical Application Architecture
HAS Server
HAS Modules
Module overview
System modules
Back-end modules
Front-end modules
HAS Instance Manager
Use case of Multiple HAS instance
Security
HAS Bundle
HAS Installer
Limited internet access?
Software Technology Stack
Overview
Web Client
IIS Web Server
HAS Web Application Server
Database SQL Server
Communications and Protocols
Overview
Detailed protocols and ports needed
List of ports
Communication flow for each port
Logical Infrastructure
Deployment overview
Deployment type: decision tree
Scaling the infrastructure
Cluster deployment
HAS server - Node role
Scaling HAS Server
Advanced availability cluster architecture
Sizing Physical Infrastructure
Disclaimer
Hardware sizing
Server configuration
For Production
Other server environments
How to calculate maximum simultaneous users
Multiple instances
Public vs Private Workspace
Making the right choice
SQL Server Databases
How many databases
Database size
Database options
User account and privileges
Native Account
Windows Account
Physical backup
Administrative tasks
Security
Windows Users and Groups
HAS Self-signed certificate
Running processes
Antivirus
Firewall
User Authentication
Data Access
Cookie security policy
Why Idsrv is always http only = false
How to enforce Same site Strict or Lax
File Server
Supervision and monitoring
Error and trace log files
Miscellaneous
Licensing
Full search and indexing
Mail system
Multi-language
Reporting
Preventing destabilization due to memory saturation
Calculation Rules
How to Disable the Option
Other Technical Documentation
Frequently Asked Questions (FAQ)
What about other HTML browsers?
Are both 64-bit and 32-bit versions of HTML browsers supported?
Is Edge Classic/Legacy supported?
What is HOPEX Classic deployment?
Are Windows Server 2012 and Windows Server 2012 R2 still supported?
Is SQL Server 2014 or 2017 still supported?
What is web storage for HTML browsers?
What is supported for Azure?
What is Mozilla Firefox ESR?
Are IE 9/10/11 still supported?
How to configure HTTPS?
It is possible to use a Must license that is not located on the HAS Server?
Is it possible to use another web server than IIS?
Can HOPEX solutions and products run on a mobile platform?
What are the web technologies used by HOPEX Platform?
What about other database servers?
HOPEX Application Server (HAS) Installation Guide
Foreword
Installation & Architecture
Step Overview
Major actions
Database installation
IIS Web Server installation
HAS Application Server installation
Different architecture installation scenario
Summary of my Installation
IIS Web Server
Adding SSL Certificate
Adding certificate on IIS Web Server
Adding certificate on IIS
Installing IIS
Installing URL Rewrite
Security: removing X-Powered-By header
Installing ARR
Configuring Sites
Configuring HTTP port 80
Configuring HTTPS port 443
Configuring Server Farm - ARR
Creating a Server farms
Configuring the Health Test
Configuring the proxy timeout
Configuring the URL Rewrite rule
Request Filtering
Configuring Logs files details and location
Locating IIS Logs
Enabling detailed logs for HTTP status code 502
Checking configuration (optional)
HOPEX Application Server (HAS) installation
Installing the prerequisite software
Configuring the file server
Downloading HAS Server installer
Getting your installation key
Installing HAS Instance Manager with the setup
First steps “online”
Go “offline”
Continue setup
Creating HAS Instance
First connection to HAS Console
Adding Must license to MegaSite.ini setting
Creating or referencing HOPEX environment
Creating a New “HOPEX environment”
Restoring an existing database
Referencing existing environment
Configuring the non-interactive desktop heap
Configuring Java Heap size (optional)
Windows User and access rights
Changing the user domain
Keeping Local system
Installing a DEV server
SSL Certificates configuration
Configuring public SSL Certificate (1)
Configuring HAS Cluster node SSL Certificate (2)
Adding certificate on the server
Creating and using a custom cluster SSL certificate
Creating a custom SSL certificate
Use the custom cluster certificate.
Disabling vulnerable cypher suites
Disabling vulnerable cypher suites with IIS Crypto
Disabling vulnerable cypher suites using script
SQL Server configuration
Character encoding
Database user
Database connection string
User grants
Cluster installation
Multiple HAS Server
Step A: Configure IIS
Step B: Install HAS Server 1
Step C: Install additional HAS Server 2
Step D: Join the cluster for each additional HAS Server
Step E: Adjust IIS configuration
Multiple IIS Server
Configuring the load balancer
Multiple SQL Server
Installation errors and tests
Testing URL DNS
Checking communication between servers
From IIS to HAS Servers
Servers to HAS Servers
Testing SSL Certificates
Testing public certificate
Testing self-signed HAS certificate
Testing HAS
Checking port 5000 is available
Checking running processes
Checking login page
Login to HAS Console
Testing Web HOPEX
Login to Web Front End
Testing Desktop client
Login to Administration.exe
Login to HOPEX.exe
Installation in multi-tenant scenarios
Multi-environments – Multi-instances
Configure IIS
Domain users
Multi-version scenario
Other installation topics
Using Server API
Publishing Static Website
Publish In HAS Instance
Publish In IIS
Post installation checklist
Uninstallation procedure
Removing IIS
Configuration removal
Prerequisite removal (optional)
Removing HOPEX applications
Uninstalling Application
Deleting files
Removing SSL Certificate
Uninstalling prerequisites (optional)
Removing RDBMS databases
FAQ
How to reset HAS Instance Manager API Key / password ?
What are the default user's login/password?
Do I need IIS Application pool?
Access rights to certificate at installation is no valid.
When should I restart HAS Instance or HAS Instance Manager?
Can I limit the role of a node in a cluster ?
How to Migrate to HOPEX Aquila 6.2
Summary
Prerequisites
Review release notes of HOPEX Aquila
Check metamodel, workspaces and workflows
Backup data in SQL Server (production)
Backup additional files
Backup main configuration files (production)
Backup customization module (production)
Identify key configuration items
Identify HOPEX products used (production)
Identify authentication used (production)
Identify modules used (production)
Identify profiles used (production)
Install Test Platform
Install HOPEX Aquila (development)
Initialize migration document (development)
Restore data in SQL Server (development)
Create a HAS Instance (development)
Complete HAS instance (development)
Deploy migration module (development)
Deploy customization module (development)
Deploy additional modules (development)
Customization of module hopex360
Update configuration (development)
Run Data Upgrade
Run automatic environment upgrade
Check logs and environment compilation
Backup migrated data
Post-migration
Review changes of HOPEX Aquila
Study adaptations to HOPEX Aquila
Test customizations and interfaces
Organize UAT session
Loop until migration is ready
FAQs
Why a customization module (has.custom)?
What is the list of system modules
Error Inconsistent format for MetaAttribute
Cannot find the option to enable data modification
Warning 'Run the menu 'Perform SQL conversion on the repository' to perform the upgrade
Warning 'Your environment requires an update for compatibility with your version of HOPEX…'
Warning 'Writing access diagram is not compiled. The diagram should be recompiled …'
How to set a HAS Instance as current in registry?
How to Upgrade a HOPEX Bundle
Foreword
HAS instance
HAS module
HAS bundle
Service Pack in HAS deployment
Upgrading a HOPEX bundle
Update of Instance Manager
Online procedure (internet access)
Offline procedure (no internet access)
FAQs
How to check that no user is connected to the HAS instance?
How to prevent that a user connects to the HAS instance during hotfix installation?
I did not install the version I wanted to. How to restore the previous version of the module?
How to verify that no workspace exists in read/write mode?
Error Something went wrong. Module X with version YY is older that the current version ZZ. Deployment is ignored!
Error: Module mode constraints do not match current server mode Production
How to create an offline package?
Unexpected login message 'You are not authorized to access this page'
Unexpected error 'The Sql Server Client could not be found. ODBC Driver 17 for SQL Server may not be installed'
Can I use the installer to update only the Instance manager
How to Migrate to Questionnaire Builder
Introduction
Questionnaire Template Migration Process
Compatibility Analysis Report
Not Compatible Questionnaire Templates
Compatible Questionnaire Templates
Question Types
Text
Vertical Radio
ComboList
Multiple Answer Type
Date
Number
Boolean
Multiple Values
Short
Duration
Object
OK/NO/NA
Aggregation Schemas
Percent
Signed Number
String
Question Group
Checkbox
Removed/Reviewed Features
Pictures in drop-down questions
Create HOPEX Object as answer to question
Questionnaire Layout
Questionnaire Template Presentation
Presentation Tools
Inherited Questions
Aggregation of Inherited Controls Steps
Inherited Test Steps
Meta Tests
Write Logical Expressions in the new Builder
Delegation
Questions Group Populated by Query
Questions with Link Answered Objects
Computed Questions
RDBMS Repository Installation Guide
Summary
Generalities
Unsupported HOPEX Features in RDBMS Storage
Expected Advantages
Licensing
Infrastructure Requirements
RDBMS Client
Network Capability to Database Server
Database Server
Server disk size
Number of connections opened by HOPEX on the RDBMS for each HOPEX workstation
HOPEX RDBMS Diagnostic Utility
Purpose
Running the RDBMS Diagnostic Utility
SQL Server support
SQL Server Requirements
Encoding
User management
Defining a HOPEX SQL Server Connection
Procedure with a native SQL account
Procedure when using Windows authentication
Creating an Environment
Prerequisite
Creating a new SystemDb database
Using an existing SystemDb database
Creating a Repository
Creating a new SQL Server database
Using an existing SQL Server database
HOPEX Private Workspaces Cleanup
Installing the procedure
HOPEX Historical Data Cleanup
Before cleaning Historical Data
Installing the procedure
Batching Cleanup procedures for SQL Server
Maintenance tasks
HOPEX RDBMS repositories specific administration actions
Migrating Your Data from One Storage Support to Another
Restoring a HOPEX environment from formatted data
Restoring an environment (SystemDb repository)
Restoring a data repository
Handling of HOPEX RDBMS repositories specific internal format
Vocabulary
Appendix - FAQs
Is it possible to share user repositories and the SystemDb repository through user's workgroups that do not share a file server?
Is it possible to have a user repository stored on a GBMS and a SystemDb repository stored on a SQL server?
Is it possible to consult the data from a SQL Server?
Is it possible to update the data from an SQL Server?
HOPEX Unified Authentication Service
Unified Authentication Service Overview
Configuring UAS Options
Configuring authentication options
Identity Provider Option Description
HOPEX provider
IIS Windows provider
SAML2 provider
OpenID Connect (OIDC) provider
Configuration Examples
OKTA Configuration with SAML2
Configuring OKTA application
Configuring UAS with OKTA
OKTA Configuration with OpenID Connect
Configuring OKTA application
Configuring UAS with OKTA
Pingfederate Configuration with SAML2
Configuring Pingfederate application
Configuring UAS with Pingfederate
Pingfederate Configuration with OpenID Connect
Configuring Pingfederate application with OpenID Connect
Configuring UAS with Pingfederate
Azure AD Configuration with SAML2
Configuring Azure AD application
Configuring UAS with Azure AD
Azure AD Configuration with OpenID Connect
Configuring Azure AD application
Configuring UAS with Azure AD
Terminology
Client
User
Scope
Identity scopes
Resource scopes
Authentication/Token Request
Identity Token
Access Token
MUST Licence Installation Guide
Foreword
Get a licence from Sales Administration
Choose a machine to host the licence folder
Create a licence folder
Get licence file
Install Must licence
Copy Must licence file
Configure file permissions
Specify licence folder during installation
Configuration and monitoring procedures
Must licence utility (Licensing.exe)
Set a default licence
Manage users using a license
Configure a user as a possible user of a product
Clean up licence tokens
Monitor licence use
Customizing the command line
Configure main users (/RW /RO)
Configure viewer profiles (/HV)
Configure contributor profiles (/HC)
Configure profiles for value packs
Inside
Licence check at login
Token requested at runtime
Files access
FAQs and Troubleshooting
Do I have to configure possible users?
Do I have to add each user in Licensing.exe?
How can I prevent the dynamic declaration of possible users?
Is my licence shared, concurrent or dedicated?
Error: The license file XX is not valid. The crypted path does not correspond to the license path file
Updating Virtual Reports
Introduction
Virtual Reports with Report Edition
Identifying the macro to edit
Updating the macro
Virtual reports without Report Edition
Updating the Property Page
Updating the macro
Finding my customized virtual reports
Finding Virtual reports with Report Edition
Finding Virtual reports without Report Edition
Updating Widgets based on a Tool
Finding Widgets based on a Tool
Updating the Property Page
Updating the Macro
Updating Widgets based on a Formatter
Updating Tiles based on a Tool
Finding Tiles based on a Tool
Updating the Property Page
Updating the Macro
12121212
Foreword
Logical Application Architecture
Software Technology Stack
Communications and Protocols
Logical Infrastructure
Sizing Physical Infrastructure
SQL Server Databases
Security
File Server
Supervision and monitoring
Error and trace log files
Miscellaneous
Other Technical Documentation
Frequently Asked Questions (FAQ)
HOPEX Application Server (HAS) Installation Guide
Foreword
IIS Web Server
HOPEX Application Server (HAS) installation
SSL Certificates configuration
SQL Server configuration
Cluster installation
Installation errors and tests
Installation in multi-tenant scenarios
Other installation topics
Post installation checklist
Uninstallation procedure
FAQ
How to Migrate to HOPEX Aquila 6.2
Summary
Prerequisites
Install Test Platform
Run Data Upgrade
Post-migration
FAQs
How to Upgrade a HOPEX Bundle
Foreword
Upgrading a HOPEX bundle
FAQs
How to Migrate to Questionnaire Builder
Introduction
Questionnaire Template Migration Process
Question Types
Removed/Reviewed Features
RDBMS Repository Installation Guide
Summary
Generalities
Infrastructure Requirements
HOPEX RDBMS Diagnostic Utility
SQL Server support
HOPEX RDBMS repositories specific administration actions
Vocabulary
Appendix - FAQs
HOPEX Unified Authentication Service
Unified Authentication Service Overview
Configuring UAS Options
Configuration Examples
Terminology
MUST Licence Installation Guide
Foreword
Get a licence from Sales Administration
Install Must licence
Configuration and monitoring procedures
Customizing the command line
Inside
FAQs and Troubleshooting
Updating Virtual Reports
Introduction
Virtual Reports with Report Edition
Virtual reports without Report Edition
Finding my customized virtual reports
Updating Widgets based on a Tool
Updating Widgets based on a Formatter
Updating Tiles based on a Tool