GSD NETframe SOAP service migration from IIS to node

First step is to open `IIS Manager`. On the left panel `Connections` select the app that you would like to migrate.

In this example it is named xMATest. Next on the right panel named `Actions` click `Advanced Settings`.


Screenshot

Write down protocol and port from section Bindings. In following example protocol is http and port is 90.

Screenshot

Next proceed to path from section Physical Path. In the case it will be C:\..\xMATest. Next proceed to directory xMA and find file config.xml.

Screenshot

Open this file in text editor. Preserve the text editor opened.


Screenshot

Next proceed to the path where you have unzipped ma-web-service.

Screenshot

Run ma-web-service-win.exe two times. As a result of this action two configuration files should be created : netframe-config.json and web-service-config.json.


Screenshot

Sample web-service-config.json file: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
{
  "name": "RestAPI",
  "tmpDir": "./tmp",
  "uploadFileStoreTimeInSec": 900,
  "rasServerIP": "127.0.0.1",
  "databaseServerIP": "127.0.0.1",
  "databaseName": "testDB",
  "userName": "GSDWebService",
  "userPassword": "",
  "timeout": 900,
  "readTimeout": 30,
  "listeners": [
    {
      "type": "HttpListener",
      "enabled": true,
      "port": 8080
    },
    {
      "type": "HttpsListener",
      "enabled": false,
      "port": 8334,
      "serverKey": "cert/key.pem",
      "serverCert": "cert/cert.pem"
    },
    {
      "type": "Http2Listener",
      "enabled": false,
      "port": 8335,
      "serverKey": "cert/key.pem",
      "serverCert": "cert/cert.pem"
    }
  ],
  "clusterConfig": {
    "minWorkers": 1,
    "maxWorkers": 1,
    "workerTimeout": 600000,
    "maxPendingRequests": 100
  },
  "loggerConfig": {
    "severity": 0,
    "targetConfigs": [
      {
        "name": "console-target",
        "enabled": true
      },
      {
        "name": "file-target",
        "enabled": true,
        "logFileLocation": "log"
      }
    ],
    "truncate": true,
    "truncateSize": 500
  },
  "proxyConfig": {
    "proxyServerAddressWS": "ws://127.0.0.1:8081",
    "enabled": false
  }
}

Values of rasServerIP, databaseServerIP, databaseName, userPassword fields should be replaced by values from config.xml file according to following schema:

config.xml field web-service-config.json field
GsdRasServer rasServerIP
GsdDBServer databaseServerIP
GsdDB databaseName
GsdDBUser userName
GsdDBPassword userPassword

For example value localhost should be placed instead of 127.0.0.1:


Screenshot

Moreover, port of the second entry in field listeners in file web-service-config.json should be replaced by the port value from IIS Manager Advanced settings dialog window.


For example value 90 should be placed instead of 8334:

Screenshot

The last step is to run this service as a windows service according to following instruction: Instruction