Skip to end of metadata
Go to start of metadata

Netigma Docker Installation

Description

Icon

This page describes the installation of Netigma with docker. If you prefer to install netigma with this way, you need to a running Netcad Base application image which is also can be installed using docker.

Page Content

Icon

1 - Prepare Configuration File

Required environment variables to build Netigma image are:

  • DC_BASE_APPHOST : It is the host address of base applications where Netigma connects them.
  • DC_NETIGMA_APPPORT : Netigma's port value which it operates. The default value is 80

 

The container is created witihin the command line, with docker run command as follows:

Icon
  • If the value of DC_NETIGMA_APPPORT is different from 80, the same port values must be used with the DC_NETGIS_APPPORT value and the port specified in the -p parameter.
  • Base services must be running at DC_BASE_APPHOST.

  • After the installation, database, that netigma conencts, is set within ParameterServer

 

For more information on docker run command; https://docs.docker.com/engine/reference/commandline/run/

2 - Running and Licence Validation

 After command operation, when you go to the adress that Netigma works (e.g. http://localhost:8080), first you'll be redirected to the AuthenticationServer's homepage that is one of the base applications. Then Netigma Licence Info page will open

On this page you can request your trial license by clicking the Register To Try link, and you can start using Netigma with the license code that comes to your e-mail address.

You will be redirected to the login page after the license activation process. Here, you can log in with the username and password of the base service that you've connected.



3 - Others

Advanced Settings

Other environment variables used by the Netigma image are listed below.

Environment VariablesDescriptionsDefault Value
DC_BASE_APPPORTThe port value to which the running base application to be connected80
DC_NETIGMA_APPNAMEIts value is Netigma's Application NameNetigma
DC_NETIGMA_DATABASE

Database info

Example Connection String
-
DC_BASEAPPS_POSTFIX

The postfixes/suffix that are going to be added to end of the base applications' names. For more info on base applications see here

e.g.: suppose that value is ABC, then ParameterServer adress will be like htpp://DC_BASE_APPHOST/ParameterServerABC

-
DC_WEBCONFIG_*

Environment variables that starts with DC_WEBCONFIG_ . e.g. DC_WEBCONFIG_LogManagerShowTrace, DC_WEBCONFIG_AuthCacheEnabled

These environment variables used for e.g. appSettings, that is in Netigma's web.config file. The setting value, after DC_WEBCONFIG_, the environment variable value is added to the web.config as the setting value.

-
DC_NETIGMA_LANGUAGEDisplay language of the Netigma appen-US

 

Using Existing Meta

 

To use your existing metafiles, you can import it into container using docker volume.

For example; you can import your metafile that are under C: \ Meta folder to Netigma with the -v parameter. Thus, changes you make within Netigma, will be reflected to the metafile on your computer.

-v C:\Meta:C:\inetpub\wwwroot\ModulData\Meta\

(warning) The application name and the metafile name must be the same. e.g. if metafile name is BELNET.config then DC_NETIGMA_APPNAME parameter value has to be BELNET.


Additional files and dashboard design files

Icon

Similar to Meta case, for Dashboard designs and additional files(Ekler) to be backed up and used on the host computer, volumes have to be created in the following destionation directories.

  • "C:\inetpub\wwwroot\ModulData\WebPart\UserData"
  • "C:\inetpub\wwwroot\Ekler" -> this folder container uploaded files using netigma
  • "C:\inetpub\wwwroot\SomeEmptyFolder"

Note: To create volume on windows containers, destination folder should be empty!