Skip to content

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](img/node-service.png)


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