Configure WebOffice Extensions Service (optional)

The configuration file of the WebOffice Extensions Service is located in <SynerGIS directory location>\GeoOffice\Bin\SynerGIS.WebOffice.Extensions.exe.config after installation.

 

In this file you can set values for the parameters IP-Adress, Port, MaxThreads and MaxWaitingConnnections. These parameters will overwrite the following default values.

 

icon_comment

If the SOE is running on an ArcGIS Server with version 10.9, and the WebOffice extensions is installed accordingly on its own server, the ServiceIPAddress parameter must be changed in this file in any case. Here the IP address of the extension server must be entered, the default value 127.0.0.1 does not work in this case.

 

Adapt WebOffice Extensions Service configuration (optional)

Optionally it may be adapted to custom requirements by setting new values for the parameters IP-Address, Port, MaxThreads and MaxWaitingConnections. In general, adaptations will be necessary only  if there is a divergence to the default settings below.

 

After the installation, the configuration file of the WebOffice Extensions Service are located in <VertiGIS Install path>\GeoOffice\Bin\SynerGIS.WebOffice.Extensions.Configuration.xml

 

icon_comment

Depending on your machine and installation, the SynerGIS directory can be installed, e.g. in C:\Program Files\VertiGIS or C:\Program Files x86\VertiGIS.

 

If the default settings do match your requirements, skip this step an restart the service like described below.

 

Attribute

Description

ServiceIPAddress

Enter the IP-address of the machine which runs the extensions service

icon_comment

By default in WebOffice 10.9 R4 the value: 127.0.0.1 is used.

ServicePort

The Port.

icon_comment

By default in WebOffice 10.9 R4 the value: 12000 is used.

Testing

This Parameter causes, that the configuration file is newly read out with each request (except Parameter ServiceIPaddress and ServicePort). This parameter should only be used for test purposes  (e.g. find out the best settings for the system). Specification of the value in Boolean.

icon_comment

By default in WebOffice 10.9 R4 the value: false is used.

Poolsize

Number of processes that can run simultaneously (ExtensionHost.exe).

Poolsize is strongly depending of the resources and the number of processors.

icon_comment

With 4 processors the poolsize 6 is most effective. With 6 processors the poolsize 12 is most effective. The best setting for this parameter can be detected by testing (see above)

By default in WebOffice 10.9 R4 the value: 3 is used.

MemoryLimit

Defines the max. size of the created process (.exe) within the usage of the Extension. If the process (.exe) gets bigger than the MemoryLimit, it will be destroyed.

CallLimit

Defines how often the process (.exe) can be executed, until it will be destroyed.

icon_comment

By default in WebOffice 10.9 R4 the value: 0 is used (no limitation).

LifeTimeLimit

Defines how long a process is allowed to run. After the defined time, the process (.exe) will be destroyed.

icon_comment

By default in WebOffice 10.9 R4 the value: 0 is used (no limitation).

OperationTimeout

Defines how long a process is allowed to run for the performance of a task. Value is given in minutes.

icon_comment

By default in WebOffice 10.9 R4 the value: 60 is used.

WaitingForHostTimeout

Defines how long a client is allowed to be in the waiting loop, until a process is available. If no process is available, the message: Server is busy will be displayed. The minimum value is 1 and this value is given in seconds.

icon_comment

By default in WebOffice 10.9 R4 the value: 60 is used.

MaxWaitingConnections

Defines the max. number of clients, which are allowed in the waiting loop. If the number gets overrun the message: Server is busy will be displayed.

icon_comment

By default in WebOffice 10.9 R4 the value: 100 is used.

ConnectToHostTimeout

Defines the maximum amount of time for connecting to extension host (sec.).

icon_comment

By default in WebOffice 10.9 R4 the value: 10 is used, minimum: 1.

Parameters of the WebOffice extensions service

 

Start WebOffice Extensions Service (optional)

 

The WebOffice Extensions Service should automatically start after the setup. If not, it has to be started manually after installation. Search for Services in the Start menu and open it.

 

Open Windows Services from the start menu

Open Windows Services from the start menu

 

Start WebOffice Extensions Service

Start WebOffice Extensions Service

 

icon_comment

It is not necessary to manually stop the WebOffice Extensions Service in case WebOffice extensions will be uninstalled.