3. Getting Ready for Customization
Before starting any customization, you must first:
1. Install the HOPEX Application Server customization module.
2. Launch the Environment automatic update.
3. Get NuGet packages.
3.1. Installing HAS Customization module
You can install the HOPEX Application Server customization module:
• Online
In the HAS Console, add the HOPEX Application Server customization module.
In the HAS Console, add the HOPEX Application Server customization module.
• Offline
Download the latest version of HOPEX Application Server customization module from the store https://store.mega.com/modules/details/has.custom.
Download the latest version of HOPEX Application Server customization module from the store https://store.mega.com/modules/details/has.custom.
3.1.1. Online mode
To install HAS Customization module online:
1. Connect to HOPEX Application Server – Console.
2. Select Modules > Module List.
3. In Add new tab, search for HOPEX Application Server customization module.
4. Upload the required version.
5. Click Apply to confirm installation.
6. A message indicates when the environment automatic will be launched (in 10 minutes).
 |
Make sure to perform this operation when users are not connected or notify them (from Administration Desktop).
|
If needed, you can:
- launch the update immediately: click Start now.
- perform the update manually later: click Cancel.
To manually update the environment: in HAS Console > Cluster menu, in Modules tab, hover the mouse over the HOPEX Core Back-End module then click More > Start Easy Update.
The HOPEX Application Server customization module (the has.custom package) is added to the Installed list.
3.1.2. Offline mode
To install HAS Customization module offline:
1. Access HOPEX Store: https://store.mega.com/modules/details/has.custom.
2. Download the required version of HOPEX Application Server customization module.
3. Store it in a location where the offline server will be able to access it.
4. Connect to HOPEX Application Server - Console.
5. Select Modules > Module List.
6. In Add new tab, click Upload from file.
7. Click Choose File, select the file and click Install.
8. A message indicates when the environment automatic will be launched (in 10 minutes).
|
|
Make sure to perform this operation when users are not connected or notify them (from Administration Desktop).
|
If needed, you can:
- launch the update immediately: click Start now.
- perform the update manually later: click Cancel.
To manually update the environment: in HAS Console > Cluster menu, in Modules tab, hover the mouse over the HOPEX Core Back-End module then click More > Start Easy Update.
The HOPEX Application Server customization module (the has.custom package) is added to the Installed list.
3.2. Getting NuGet package
Prerequisite:
Ensure you have the pre-requisite installed:
You are in a Development mode server. Download and install .NET Core SDK as described in the HAS Installation guide > Installing the prerequisite software documentation.
To import the NuGet Package into the server:
1. Connect to the server in RDP.
2. Go to the HAS installation folder.
3. Find the has.custom folder.
E.g.: C:\ProgramData\HOPEX Application Server\5000\.shadowFiles\has.custom\15.2.0
4. Read the HOW-TO-BUILD.md file.
3.2.1. Online mode
With a user that have enough privilege:
1. Launch a PowerShell script windows.
2. Launch the “1 - Online- install nuget package.ps1” script.
When successful you will have a message such as:
Tool 'hopex.applicationserver.tool' was successfully updated from version '15.5.0.69' to version '15.5.0.79'
If this is not the first time you launch the command, existing version will be updated if needed.
In case a more recent version exists, you might get an error message. In that case edit the PowerShell script.
You are now ready to start your customization and package them.