1. Prerequisites
1.1. Review release notes of HOPEX Aquila
The release notes are available via a web site on MEGA Community.
Direct URL is https://releasenotes.saas.mega.com/RNA/RnView
First, select the Edition (both Aquila / November 2023 and Aquila SP1 /January 2024) and click Search to get search results. Then you can refine the search results by using filters.
|
Filter
|
Indication
|
|
Product
|
Check each of the products you use
You can also select All products
|
|
Nature
|
Check Changes, Deprecated, Removed
|
1.2. Check metamodel, workspaces and workflows
In the source version, for each environment:
|
Check
|
Detail
|
|
Check that version of environment is aligned with version of programs
|
Run HOPEX.exe and check that no message is displayed such as 'The versions of HOPEX and the MetaModel are not aligned (HOPEX=X.XX.XXX.XXXX - MetaModel=Y.YY.YYYY.YYYY)…'
|
|
Check that environment compiles without error
|
Run Windows Administration Console (administration.exe) and compile the environment. If the environment compilation generates a log entry in the HOPEX error log, you should fix such errors before migrating your data
|
|
Check that no private workspace (ex-transactions) persists
|
In Windows Administration Console (administration.exe), check workspaces. If a private workspace persists, dispatch or delete it.
|
|
Check that each workflow is completed
|
Certain workflows (regarding Application and Software Technology) are removed with HOPEX Aquila. Therefore, it will not be possible to resume them in Aquila.
|
|
Password of the login 'System'
|
Check that the password of the login 'System' is known or set to empty before migration.
This is very important since it will be requested to login with 'System'.
|
1.3. Backup data in SQL Server (production)
Perform SQL backups (.BAK files) for:
• SystemDb
• Data repository
• HAS configuration database
Example for an environment named Standard and instance port 5000
• Standard_SystemDb
• Standard_MasterData
• Standard_HAS_5000
1.4. Backup additional files
1.4.1. Backup main configuration files (production)
|
Level
|
Detail
|
|
Installation
|
Files: megasite.ini.generated and MegaModule.json.generated
Default location: C:\ProgramData\MEGA\Hopex Application Server\<instance>\.shadowFiles\hopex.core\<version>\Cfg
|
|
Environment
|
File: Megaenv.ini
Default location: C:\ProgramData\MEGA\Hopex Application Server\<instance>\Repos
|
Reminder for HOPEX V4.0:
For the installation, there is a file megasite.ini located by default in C:\Program Files (x86)\MEGA\HOPEX V4\Cfg
1.4.2. Backup customization module (production)
In HOPEX Aquila, customizations are packaged in a module has.custom.
By default, it is a file HOPEX Application Server Customization-XX.haspkg located by default in C:\ProgramData\MEGA\Hopex Application Server\<instance>\Modules\has.custom.
Reminder for HOPEX V4.0:
For the installation, there can be a folder mega_usr located by default
• Installation: C:\Program Files (x86)\MEGA\HOPEX V4\Mega_usr
• Environment: <environment folder>\Mega_usr
It will be necessary to transform this folder to a customization module (has.custom).
See online documentation for HOPEX Aquila V6.0, MODULES > Customization Lifecycle Management.
1.4.3. Backup user web settings for an instance (HOPEX V4.0)
This section applies only if source version is HOPEX V4.0.
Web settings are user related settings. They contain information that can be considered as useful (tiles displayed in homepage, widgets displayed in page dashboard…).
Even if such information will not be available in HOPEX Aquila as in HOPEX V4.0, it is recommended to save it.
Archive (file copy) the file MegaSettings-*.ini on the server hosting the source installation.
With HOPEX V4.0, such files are saved in the folder:
%ProgramData%\MEGA\HOPEX V4\ClusterRoot\UserSettings
1.5. Identify key configuration items
This applies to production.
1.5.1. Identify HOPEX products used (production)
HOPEX administrator should be aware of the HOPEX products used.
Otherwise, you can identify them from the HOPEX license used.
It is a .Must file.
There is no default location but you can identify the license folder from the file megasite.ini.generated saved previously. It contains the path of the license:
[Must Licence]
Path=<license folder>
Browse this folder, edit the file .Must.
You can get the list of products and their codes in the section [MEGAComponentInfo]:
[MEGAComponentInfo]
(LAN) HOPEX MainUser=30 ; 0
(MTS2) HOPEX Power Studio= 1 ; 0
(HBPA) HOPEX Business Process Analysis=20 ; 0
(HITA) HOPEX IT Architecture V2=10 ; 0
1.5.2. Identify authentication used (production)
HOPEX administrator should be aware of the authentication mode used.
Several authentication modes are available up to HOPEX V5.0.
|
Authentication mode
|
Check in HOPEX V5.0
|
Supported in Aquila
|
|
OpenID
|
HAS Console, browse Modules > Authentication > Identify providers > Open ID
Active is checked
|
Yes
|
|
SAML2
|
HAS Console, browse Modules > Authentication > Identify providers > SAML2
Active is checked
|
Yes
|
|
Windows (IIS)
|
HAS Console, browse Modules > Authentication > Identify providers > Windows
Active is checked
|
Yes
|
|
HOPEX (MEGA)
|
HAS Console, browse Modules > Authentication > Identify providers > HOPEX
Active is checked
|
Yes
|
|
LDAP
|
Installation options
Installation > User Management > LDAP
Authentication mode is set to 'LDAP'
|
No
|
For HOPEX V4.0, see Identify authentication used (HOPEX V4.0).
1.5.3. Identify modules used (production)
HOPEX administrator should be aware of the HOPEX products used.
Otherwise, to make you can take a screenshot of the page Cluster status in HAS Console (menu Cluster > Cluster status).
You can also identify them from the folder structure.
Browse module folder located by default in C:\ProgramData\MEGA\Hopex Application Server\<instance>\Modules.
For each module used, the is a subfolder with the version.
You can build a table such as:
|
Example if additional module
|
Version
|
|
has.custom
|
15.2.0+13
|
|
hopex360
|
15.7.0+6617
|
|
sample.datatypes
|
15.6.12+6579
|
For HOPEX V4.0, see Identify solution pack used (HOPEX V4.0).
If Archimate is used in HOPEX V4.0, note that module 'Archimate V3.1' should be installed.
1.5.4. Identify profiles used (production)
HOPEX administrator should be aware of the profiles used in HOPEX.
Otherwise, you can use the following query in HOPEX.
Connect with HOPEX Administrator or HOPEX Customizer to run the query with the wider possible vision.
|
Select [Profile] Into @PL1 Where [Profile Assignment]
Select [Profile] Into @PL2 Where [Super Profile] in @PL1
Select [Profile] From @PL1 Or @PL2
|