This section covers the steps needed to properly install the Data model mapper GUI. It is an Angular Web portal based on Nebular/Ngx-admin framework that can be installed in the following ways:
The following sections describe each installation method in detail.
Build Angular application and deploy compiled folder on a Web Server.
In order to install Data model mapper GUI the followings must be correctly installed and configured:
| Framework | Version | Licence |
|---|---|---|
| NodeJS with NPM | >=14.15 | MIT |
| Apache or Nginx Web server | 2.4.43 / 1.18.0 | Apache License v.2.0 / 2-clause BSD |
Execute the following commands to create the dist folder.
frontend/ folder:cd frontend
npm install
npm run build:prod
dist folderMove the files in dist subfolder to a new folder on the Web server document root (e.g. /var/www/html for Apache and /usr/share/nginx/html for Nginx.
Once the dist folder files are deployed and the server has started, modify the
fields of config.json configuration file, located in dist/assets/ folder.
(These modifications can be made also in frontend/src/assets/config.json file before building the Application, as described in the section above).
system.dmmGuiUrl: with endpoint (host:port) where the dashboard is running (depends on Web server configuration or if running with Docker on different published port). "dmmGuiUrl": "http://localhost:12345/data-model-mapper-gui",
system.detailedErrors: the supported value are true or false. If true, it enables detailed error on error dialog. "detailedErrors": true,
data_model_mapper.default_mapper_url: The default url called in order to obtain mapper list. "default_mapper_url": "http://localhost:5500/api/mapper",
i18n.locale: with locale ( en allowed as default) enabling internazionalization on Dashboard pages. },
"i18n": {
"locale": "en",
"languages": ["it","en"]
}
}
In the Service Catalogue translations are available directly for the following parts:
Page Labels are available in
frontend/src/assets/data/i18n/LOCALE.json
Where LOCALE is one of the configured languages in
frontend/src/assets/config.json file :
"i18n": {
"locale": "en",
"languages": ["it","en"]
}
Copy, paste and rename “en.json” file with the selected language (e.g. “el”) and translate each property value. Ex:
"welcome": "Welcome to Data model mapper GUI!"
To
"welcome": "Καλωσορίσατε στο γραφικό περιβάλλον χρήσης χαρτογράφησης μοντέλου δεδομένων!"
by respecting upper/low cases, Ex:
"error": "Error"
to
"error": "λάθος",
Data model mapper can be run as Docker container (based on Nginx image), by using the provided docker-compose.yml file.
You must install of course:
The provided docker-compose.yml file has also directives to mount the provided nginx.conf file, needed to correctly handle deep-linking on deployed Dashboard Angular application.
It contains also the mount to the src/assets/config.json file, which allows to configure the Dashboard as described in the Deployment and Configuration section.
frontend folder and build an image :docker build . -t data-model-mapper-gui
Ensure you modified config.json file properly, as described in the section above.
Run the docker-compose file with:
docker-compose up
The containers will be automatically started and attached to the created network.
The Data model mapper GUI is available to the endpoint according to installation mode (Web server or Docker).
Open your favourite browser and point to that endpoint.
Go to Data model mapper usage manual section to learn how to use the Data model mapper GUI.