Web Front-End Installation Guide
Prerequisites
Operating System
.Net
.NET Core 2.1 Runtime & Hosting Bundle
JRE IBM Eclipse OpenJ9
Prior Hopex versions
Required roles
Desktop heap configuration
Configuration of SSL / TLS
Windows User(s) for MEGA HOPEX
Define Group permissions
Define MUST Licence Access
Define COM Access rights
MEGA HOPEX Setup
Choosing your setup type
Important Notice
Web Front-End Standalone Setup
Advanced Setup
Choice Screen
Advanced Parameters
UAS Certificate Management
HOPEX Web Application GraphQL
Completing Installation
Define “Windows User for MEGA HOPEX” files Access Rights
Tune IIS
Configure Web Content expiration
What's next?
Testing the Installation
Testing MEGA HOPEX (Web Front-End)
More required configuration
Word, Excel and PDF exports
Reports (MS Word)
Required options configuration
Allowing the use of verbose logs and activation
Troubleshooting
Check that the Site Service Provider is running
Restarting Internet Information Services
Referencing a New Environment
Disabling Data Execution Prevention
Loosening Internet Explorer Security Settings
Manage http 503 error
Cluster Deployment – Installation Guide
Prerequisites
Operating system
Tweaks
Tweak 1: Users
Tweak 2: « hosts » file
Server Windows 2016
Installing .Net 4.7
Windows users for MEGA
Define the group permissions
Define the COM rights
Create folders
Give rights on the proper folder
Web/Application Servers
RDBMS Server
Install MEGA on the Web Servers
Install MEGA on the MWAS Application Servers
Install MEGA on the SSP Application Servers
Finish the installation
Create share folders
License share
Environment share
MegaSite share
Configure the license
Update the Desktop Heap
Install SQL Server native client
Centralize the MegaSite
Managing the RDBMS setup
Instance and databases
Configure the default connection string
Creating an environment
Creating a repository
Configure the mega account
Provide a password
Create assignments
Configure the services
Declare the SSP nodes
Test the web client
IIS Tuning
Application pools recycling
Manage expiration of HTTP response headers
Diagnostic Tools
Latency test with hrping
“RDBMS Diagnostic” Tool
Activation and deployment of stored procedures for SQL Server
Annex
The log files
Restart the web application
Automatic restart with a Mega tool
Configure SMTP
HOPEX Web Front-End Architecture Overview
Deployment Types
Standalone Deployment
Horizontal scaling Deployment
Vertical scaling Deployment
Vertical scaling Deployment (detailed view)
Common deployment requirements
Web Client
Application Server
File Server
Database Server
Communication
Between Web Client and Web server (Web Application Server)
Between Environment SSP or MIK and Database server (SQL Server)
Between Environment SSP or MIK and mail server
Between Environment SSP or MIK and file server (file access, license access)
Between Environment SSP and LDAP Server
Inside
Administration tools
Anti-virus Configuration
Authentication
Certificate
Cluster, scalability, load balancing
Data access
Data storage
Document management
Error and trace logfiles
Full search and indexing
Licensing
Mail system
Multi-language
Physical backup
Redo logs and activity tracking
Regular administration tasks
Reporting
Rest API
Security
Services and running processes
Supervision
System caches
Technical documentation
FAQs
What about HTML browsers other than Edge Chromium, Firefox and Chrome?
Are both 64-bit and 32-bit version 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?
Are SQL Server 2012 and SQL Server 2014 still supported?
What is web storage for HTML browsers?
What is supported for Azure?
What is Mozilla Firefox ESR?
Are IE 9.0/10/11 still supported?
Are there requirements or recommendations regarding security policies (GPOs)?
How to configure HTTPS for Front-end?
It is possible to use a Must licence that is not located on the SSP Application Server?
Can the HOPEX Web Front-End run on a web server other 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?
Are there supervision tools?
How to Migrate to HOPEX V4
Main steps to migrate data to HOPEX V4
Prepare upgrade of data
Check license with your sales representative
Check metamodel, locks, workspaces and workflows
Verify that Windows Front-End is no longer used for runtime
Verify that Oracle storage is no longer used for runtime
Verify that GBMS storage is no longer used for runtime
Identify Solution packs used
Verify technology of web desktops
Decide 'Definition of path of MetaAssociation'
Decide how to manage questionnaires
Review use of the profile 'Enterprise Architect'
Review authentication mode
Decide to keep web settings
Upgrade data to HOPEX V4
Check data upgrade pre-requisites
Upgrade environment (SQL Server storage)
Update stored procedures with SQL Server storage
Perform a physical backup
Complete upgrade of data
Activate standard mode for questionnaires
Set a value for 'Definition of path of MetaAssociation'
Re-import solutions packs
Rebuild full search indexes
Review command line parameters
Restore web settings
Custom files in Mega_usr folder
Check upgraded data
First control of migration
Check data modelling consistency
Other checking indications
Appendix
Conversion details
Utilities details
FAQs
I 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 run a specific conversion or utility?
How to Install a Hotfix
Foreword
Hotfix
Upgrading HOPEX programs
Upgrading Web Front-end
Upgrading HOPEX Data
FAQs
After hotfix update the version of GraphQL installed from HOPEX Store is updated.
After hotfix update the file web.config of HOPEX is updated.
After hotfix update, UAS is enabled again.
How to Install a CP
Foreword
Corrective Pack
Identification of version
Archive configuration file
Upgrading HOPEX programs
Upgrading Web Front-end
Pre-install
Procedure
Upgrading HOPEX Data
Pre-upgrade
Procedure
Post-installation and data upgrade
FAQs
What is the meaning of the actions below?
How can I get the MSP file of the Corrective Pack?
After CP update the version of GraphQL does not match the version installed with the master!
How to know the version of HOPEX GraphQL installed?
How to update HOPEX GraphQL?
Where to get the last version of HOPEX GraphQL?
When to update HOPEX GraphQL with latest version?
After CP update the version of GraphQL installed from HOPEX Store is updated.
After CP update the file web.config of HOPEX is updated.
After CP update, UAS is enabled again.
Is it possible to disable UAS component again in HOPEX V4.0?
Questionnaire Builder - Installation & Migration
Introduction
Benefits of the New Builder
Questionnaire Builder Installation
Questionnaire Templates Compatibility
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
Questionnaires 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
Activating the New Questionnaire Builder
RDBMS Repository Installation Guide
Summary
Generalities
Supported Versions of RDBMS
Unsupported HOPEX Features in RDBMS Storage
Expected Advantages
Licensing
Infrastructure Requirements
RDBMS Client
Network Capability to Database Server
File Server and RDBMS local cache
Architecture Model
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
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?
Must License Installation Guide
Foreword
Must licence utility
User Interface
Select server path window
User management window
Select HOPEX installation window
Installation procedures
Communicating with MEGA Sales Administration
Choosing a machine to host the Must licence folder
Creating a Must licence folder
Sending the UNC address of the licence folder
Installing a Must licence file
Configuring licence folder in the HOPEX installation (direct reference)
Configuring licence folder in the shared configuration folder (indirect reference)
Uninstalling the Must licence
Resetting the configuration files
Converting licence
Configure file permissions
Configuration and monitoring procedures
Configuring the command line (/RO, /RW, /HV, /HC)
Specifying a default licence
Declaring users
Adding a user to a licence
Removing a user from a licence
Configuring possible users of products
Setting a user as a possible user of a product
Removing a user as a possible user of a product
Cleaning up licence tokens
Instant monitoring of licence connections
Web Monitoring Console
Configuring licensing modes and user types
Configuration of main users with concurrent mode (floating mode)
Check .Must licence
Configure command line
Configuration of main users with dedicated mode
Check .Must licence
Configure command line
Configuration of main users with shared mode
Check .Must licence
Configure command line
Configuration for viewer users
Configure command line
Configuration for contributor users
Configure command line
Inside
Licence deployment model
Licence execution
Windows Front-End
Web Front-End
File access
FAQs and Troubleshooting
How can I use the Web licensing console?
Do I have to configure possible users?
How can I secure configuration of the HOPEX Must licence?
How can I prevent the dynamic declaration of possible users?
How can I get a log of licence connections?
What is the Router.ini file?
How can I get the assignment of users to licences?
How can I get the assignment of possible users to product?
When adding a user, I get an error 'Bad format with user 'XX'!
How can I get the list of logins of users?
I do not know the names of the logins. Why can't the utility provide a list of existing login?
How can I set possible users for a selection of users?
Can I mix shared and dedicated modes?
Is my licence shared or dedicated?
Error message 1
Where is the latest licence folder used saved (Windows Front-end)?
How can I check that an HOPEX installation is part of a cluster?
HOPEX Unified Authentication Service
Unified Authentication Service Overview
Configuring UAS Options
Server Option Description
Server global options
Authentication options
Cookie options
Event options
Logging trace options
Token Signature options
Identity Provider Option Description
HOPEX provider
IIS Windows provider
SAML2 provider
OpenID Connect (OIDC)
Google provider
Microsoft provider
Cross-Origin Resource Sharing Option Description
Simple requests
Preflighted requests
Use within browsers
Client Option Description
HOPEX Custom (options in Extended view only)
UAS api Endpoints
Authorization/Authentication
Token
UserInfo
Discovery Endpoint
Logout Endpoint
Token Revocation
Introspection Endpoint
Access token validation endpoint
Identity Token Validation Endpoint
CSP Endpoint
Establishing an SSL connection
Creating a certificate request from IIS
Completing the certificate request
Binding IIS with SSL certificate
Exporting certificate to the local disk
Installing HOPEX Signing Certificate (Manually)
Configuring UAS hopex by options
Local Configuration
Defining authentication options
Cluster Configuration
Configuring your data component type
Configuring your SQL Server Data component type
Configuring Hopex Web options
Generating Machine Key
Configure client using UAS
Standalone Mode
Anonymous environment mode
SAML2 ADFS Server Configuration
Windows Authentication in cluster mode with UAS
OKTA Configuration
Configuring OKTA
Configuring UAS with OKTA
Terminology
Client
User
Scope
Identity scopes
Resource scopes
Authentication/Token Request
Identity Token
Access Token
Troubleshooting
General
Get information about configuration
Redirect Server name to Full Qualified Domain name
Client configuration in Windows Authentication mode
Filtering Windows group
Filtering Windows group by number
Filtering Windows group by name
Web Front-End Installation Guide
Troubleshooting