WINDOWS FRONT-END INSTALLATION GUIDE HOPEX V2R1
Summary
Installation on stand-alone machine
General Steps
Installing on the Windows client
Post installation tests
Common configuration
Checking the HOPEX License
Creating a shared configuration folder
Copying the installation program on a network folder
Building an installation command line
Installing a test environment
Post installation scenarios
Installation on multiple machines
General Steps
Installing on the Windows client
Post installation tests
Installation in CITRIX/TSE Deployment
General Steps
Creating an installation package
Deploying a package on the server farm
Publishing the application
Post installation tests
Upgrading HOPEX Programs
Perform a backup of key configuration files
Upgrade command line
Removing HOPEX Programs
General recommendations
Unstallation command line
Uninstalling SQL Server Native client
FAQs
Why is it necessary to install a Visual C++ Redistributable package?
How to get the package Visual C++ Redistributable for Visual Studio 2015?
Why is it necessary to tinstall a Visual C++ Redistributable package?
How to track an installation error?
How to disable SMB 2.0?
How can I create a HOPEX Environment in RDBMS Storage (Oracle, SQL Server)?
After upgrade of a HOPEX installation from version X to version Y, when a user Z runs HOPEX, the version is version X (and not version Y)!
Appendix
Recommended file permissions for the HOPEX installation
Reading table
Permissions for the license folder (Must license)
Permissions for the license folder (ELF license)
Permissions for the shared configuration folder
Permissions for HOPEX installation folders (%programfiles(x86)%)
Permissions for HOPEX installation folders (%programfiles%)
Permissions for HOPEX Environment folders
Example of command lines for HOPEX Web Front-End
List of program features displayed in the setup wizard
Embedded Internet Explorer
Complete list of installation features
Web Front-End Single-Server Installation Guide HOPEX V2R1 EN
Contents
Prerequisites
Operating System
.Net
Visual C++ Redistributable for Visual Studio 2015
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
Web Front-End Standalone Setup
Advanced Setup
Choice Screen
Advanced Parameters
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
URL Rewrite
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
Web Front-End Architecture Overview HOPEX V2R1
Summary
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 (Oracle, 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
Cluster, scalability and 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
Security
Services and running processes
Supervision
System caches
Technical documentation
FAQs
What about HTML browsers other than Edge, IE, Chrome, Firefox and Safari?
Is SQL Server 2017 supported?
What is web storage for HTML browsers?
What is supported for Azure?
What is Mozilla Firefox ESR?
What is the list of minor restrictions for Edge / IE / Chrome / Firefox / Safari?
Is IE 9.0 still supported?
Is Internet Explorer 10 still supported?
Is Internet Explorer 11 still supported?
Is Windows Server 2008 R2 still supported?
Is Oracle Database Server 11 still supported?
Are SQL Server 2008/2008 R2/SQL Server 2012 still supported?
Are there requirements or recommendations regarding security policies (GPOs)?
How to configure HTTPS?
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?
What is the HOPEX2 folder?
Are there supervision tools?
Windows Front-End Architecture Overview HOPEX V2R1
Summary
Typical deployments
Standard Deployment
Citrix/TSE Deployment
Deployment requirements
Windows Client
File Server
Citrix Client/Remote Desktop Client
Application Server (Citrix Server/Terminal Server)
Database server
Communication
Between MIK and File Server (file access, license access)
Between Citrix client and Citrix Server
Between Citrix web client and Citrix Server
Between Remote Desktop Client and Remote Desktop Services
Between Remote Desktop Web Client and Remote Desktop Services
Between MIK and Database server (Oracle, SQL Server)
Between MIK and mail server
Between MIK and Document server (file access)
Between MIK and LDAP Server
Inside
Administration tools
Anti-virus Configuration
Authentication
Cluster, scalability and load balancing
Data access
Data storage
Document management
Error and trace logfiles
Licensing
Mail system
Multi-language
Physical backup
Specific recommendations
Redo logs and activity tracking
Regular administration tasks
Reporting
Security
Services and running processes
Supervision
System caches
Technical documentation
FAQs
Is Windows 7.0 SP1 (64-bit) still supported?
Is Windows 8.0 (64-bit) still supported?
Is Windows 8.1 (64-bit) still supported?
Is Windows Server 2008 (64-bit) still supported?
Is Windows Server 2008 R2 still supported?
Is Internet Explorer 10 still supported?
Is Internet Explorer 11 still supported?
Is Citrix XenApp 6.x (6.0, 6.5) still supported?
Is Oracle Database Server 11 still supported?
Is SQL Server 2008/2008 R2 still supported?
Is remote execution still possible?
Is .NET Framework required to install Windows Front-end?
Why is SMB 2.0 not supported for GBMS storage?
Can HOPEX Windows front-end run on Microsoft App-V?
Is GBMS storage recommended?
Glossary
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
Oracle support
Oracle Database Requirements
Encoding
User privileges
Defining a HOPEX Oracle Connection
Creating an Environment
Creating a Repository
HOPEX Private Workspaces Cleanup
Installing the procedure
HOPEX Historical Data Cleanup
Before cleaning Historical Data
Installing the procedure
Batching Cleanup procedures for Oracle
Maintenance tasks
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
ORACLE Case: From Test Environment to Production
The Chosen Method: Using the Data Pump Tool
How about HOPEX Then?
The Actual Export – Re-Import Phase
The Export
The Import
Finalization: Switching in HOPEX from Test to Production
What if…
Advice
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 an Oracle/SQL server?
Is it possible to consult the data from an Oracle/SQL Server?
Is it possible to update the data from an Oracle/SQL Server?
MUST LICENSE INSTALLATION GUIDE HOPEX V2R1 EN
Summary
Foreword
Must license 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 license folder
Creating a Must license folder
Sending the UNC address of the license folder
Installing a Must license file
Configuring the license folder in the HOPEX installation (direct reference)
Configuring the license folder in the shared configuration folder (indirect reference)
Uninstalling the Must license
Resetting the configuration files
Converting licence
Configure file permissions
Configuration and monitoring procedures
Configuring the command line (/RO /RW code)
Specifying a default licence
Declaring users
Adding a user to a license
Removing a user from a license
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 license tokens
Instant monitoring of license connections
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
License deployment model
License 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 license?
How can I prevent the dynamic declaration of possible users?
How can I get a log of license connections?
What is the Router.ini file?
How can I get the assignment of users to licenses?
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 license shared or dedicated?
Error message 1
Where is the latest license folder used saved?
How can I check that an HOPEX installation is part of a cluster?
A message is displayed like You are not allowed to launch HOPEX V2R1 with your license file “xxxx.must”. It must be upgraded for this version. Please contact your sales representative to obtain a valid license file.
How to migrate to HOPEX V2R1
Main steps to migrate data to HOPEX V2R1
Prepare upgrade of data
Check metamodel, locks, workspaces and workflows
Decide format of report templates (MS Word)
Identify Solution packs used
Management of login assignments
Decide 'Definition of path of MetaAssociation'
Check license with your sales representative
Review use of the profile 'Enterprise Architect'
Review authentication mode
Decide to keep web settings
Upgrade data from HOPEX V1R3 or HOPEX V2
Check data upgrade pre-requisites
Upgrade environment with Oracle or SQL Server storage
Upgrade environment with GBMS Storage
Update stored procedures with Oracle or SQL Server storage
Complete upgrade of data
Re-import solutions packs
Set a value for 'Definition of path of MetaAssociation'
Review command line parameters
Check format of report templates (MS Word)
Convert custom report templates (MS Word) to format RTF
Configure MS Word generation mode for each HOPEX environment
Restore web settings
Check upgraded data
First control of migration
Check data modelling consistency
Other checking indications
Appendix
Conversion details
Utilities details
FAQs
Warning 'You cannot access repository "XXX". Its internal structure is not up to date…
Warning 'Your environment and site are not of the same version. Your environment requires updating…'
Warning 'The version of the stored procedure XX is not OK…'
Warning 'To perform this action, the minimum version required for you environment is HOPEX V2R1 Update2…'
Warning 'Writing access diagram is not compiled…'
How to run a specific conversion or utility?
How to Install CP HOPEX V2 R1
Foreword
Corrective Pack
Identification of version
Upgrading HOPEX programs
Upgrading Web Front-end
Upgrading HOPEX Data
FAQs
What is the meaning of the actions below?
What is the procedure for GBMS storage?
How can I get the MSP file of the Corrective Pack?
How to Migrate Data from Oracle to SQL Server StorageHOPEX V2R1
PRE-REQUISITES
RECOMMENDATIONS
PROCEDURE
General process
Procedure
Check DATA
How to Install Update HOPEX V2R1 U3
Foreword
What is an update?
Upgrading HOPEX programs
Upgrading Web Front-end
Upgrading Windows Front-end
Upgrading HOPEX Data
Upgrade HOPEX environments
Procedure (GBMS storage):
Procedure (RDBMS storage: Oracle, SQL Server):
Check Upgraded Data
Appendix
Advanced deployment
Documentation of Changes
FAQs
Why is the menu 'Environment automatic update' is disabled?
What is the meaning of the actions?
After a specific update installation, I get the following warning: You cannot access repository "XX". Its internal structure is not up to date. Run the menu "Technical Conversion" to perform the upgrade?
I get a message 'MetaModel and/or technical data of your environment are not compiled (XXX is missing) .... Please contact your administrator to perform the translation/compilation of your environment.
When running the menu 'Conversions > System Repository Update, a warning says that workspaces exist.
Why are updates provided as .EXE files?
The SSP Service (mgwspp.exe) keeps re-starting and therefore loads other processes (mgwspro.exe...).
What is the purpose of the menu 'Conversions > System Repository Update > Simulate'?
How to Install Hotfix HOPEX V2R1 Update 3
Foreword
Hotfix
Upgrading HOPEX programs
Upgrading Web Front-end
Upgrading HOPEX Data
Upgrading HOPEX configuration
HOPEX Unified Authentication Service
Unified Authentication Service Overview
UAS Configuration
Configuring authentication options
Server Option Description
Server global options
Authentication options
Cookie options
Events options
Logging trace options
Token Signature options
Identity Provider Option Description
HOPEX provider
IIS Windows provider
SAML2 provider
Google provider
Microsoft provider
Salesforce provider
Custom provider
Cross-Origin Resource Sharing Option Description
Client Option Description
HOPEX Custom (options in Extended view only)
Endpoints
Authorization/Authentication
Token
UserInfo
Discovery Endpoint
Logout Endpoint
Token Revocation
Introspection Endpoint
Access token validation endpoint
Identity Token Validation Endpoint
CSP Endpoint
Establish an SSL connection
Creating a certificate request from IIS
Completing the certificate request
Binding IIS with SSL certificate
Exporting certificate to the local disk
Install HOPEX Signing Certificate (Manually)
Install the Hopex Identity Provider template
Configure 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
Configure UAS with OKTA
Terminology
Client
User
Scope
Identity scopes
Resource scopes
Authentication/Token Request
Identity Token
Access Token
Protocol specifications
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
UAS Tools
Purpose
Configuration
Configuration page
Getting Started
Identity Providers
CORS
Result page
Diagnostic
WINDOWS FRONT-END INSTALLATION GUIDE HOPEX V2R1
Diagnostic