Adapt COM+ Applications |
  
|
Adapt COM+ Applications |
|
With the WebOffice extensions 10.2 setup all necessary COM+ applications will be generated. For each extension (plot, ePaper and export) there is one application.
Note: If the resources for your WebOffice extensions 10.2 (e.g. *.layout files, *.mrt files, SynPlotService.mxd, geo data, raster data in a raster catalog etc) reside on a network share, please ensure that it is accessible for the user of the pool identity of the respective COM+ component. This also affects files, that are used in the output of the plot or WebOffice ePaper report (e.g. images on a separate server).
Note: Please check also chapter Problems with COM+ Services for troubleshooting related to COM+ services.
Adapt COM+ applications (optional)
If necessary the COM+ applications can be altered in the Windows Component Services. Enter "Component Services" into the search field of the start menu.
Open Component Services from start menu
Navigate through Computers > My Computer > COM+ Applications where you find all installed WebOffice extensions 10.2.
Installed WebOffice plot in the Component Services
With a right click on one of the WebOffice extensions 10.2 under COM+ applications you can open the respective properties. Here you can change the following settings:
| • | Security: By default access checks are disabled and the application is running in context of the user. If access checks are enabled there must exist/must be configured a role with correspondent user. |
WebOffice plot Properties - Security
| o | Write permission for the temp directory of the respective user |
e.g. C:\Users\<username>\AppData\Local\Temp
e.g. C:\Users\<username>\AppData\Local\StimulsoftReportsCache
| o | Full control for C:\Windows\Temp |
| o | Read permission for the WebOffice and write permission for the ArcGIS output directory (e.g. C:\arcgisserver\directories\arcgisoutput or C:\Tomcat\webapps\<WebOffice application>\output) |
| o | Full control for the directories of the template |
e.g. C:\arcgisserver\directories\WebOfficePlotTemplates
e.g. C:\arcgisserver\directories\WebOfficeePaperTemplates
e.g. C:\arcgisserver\directories\WebOfficeExtract
| o | Read permission for the registry |
WebOffice plot Properties - Identity
Note: Using the WebOffice extensions supported from WebOffice 10.2 SP2, SynerGIS strongly recommends to configure a separate service user under 'Identity' / 'This user'. This user can be a local user or a domain user and doesn't need any administrative rights. The setting "System Account - Interactive user" only works while NOT restarting the server.
Note: In a distributed scenario you have to use a domain user.
Note: Consider the following points when configuring a specific user for the WebOffice extensions 10.2:
| • | The user should not be able to log-in interactively (this means that the user is not a member of the group "Remote Desktop Users") |
| • | The password should not expire |
| • | Be sure that this user is used EXCLUSIVELY in the pool identity context (Do NOT use this user to run ArcGIS 10.2 for Server or SynerGIS WebOffice Extensions Service) |
Note: When encountering problems regarding the COM+ applications, you may change the Windows group policies. See the following links for detailed information:
http://www-01.ibm.com/support/docview.wss?uid=swg21595409
| • | Activation: The application was designed as a server application. For every instance a dllhost.exe will be started. |
WebOffice plot Properties - Activation
| • | Advanced: If a large pool size is configured it is recommended to enable idle shutdown in order to release memory for other services. The default value for idle shutdown is 3 minutes. |
WebOffice plot Properties - Advanced
| • | Pooling & Recycling: |
| o | Application Pooling: In Pool Size, type the maximum number of application server processes that can run concurrently. The default number is 1, in which case the COM+ Application Pooling service is disabled. For every instance a dllhost.exe will be started. This value should be adapted by all means. |
| o | Memory Limit (KB): The maximum amount of process memory usage in kilobytes (KB) before the process is recycled. If the process's memory usage exceeds the specified number for longer than one minute, the process is recycled. The valid range is 0 KB through 1,048,576 KB. The default value is 0 KB. |
| o | Expiration Timeout (minutes): The number of minutes to wait for the release of all external references to objects in the process before the process is forcibly shut down. The valid range is 1 minute through 1440 minutes (24 hours). The default value is 15 minutes. This value is used only when it is already determined that a process will be recycled based on the other criteria. |
Note: It is recommended to set the Pool Size to '3', the memory limit to 300000 and the expiration timeout to 1 minute. In case the memory per instance exceeds this value it will be recycled after the expiration timeout.
WebOffice plot Properties - Pooling and Recycling
Navigate further to the components of a WebOffice extension and open the properties with a right click.
| • | Activation: |
| o | Enable Object Pooling: Object pooling is not supported by the extension services. However, if it is activated this can lead to unexpected results and/or long waiting time. |
| o | Enable Just In Time Activation: The just in time activation is the best option and is supported by the component. |
SynerGIS.WebOffice.Plotservice.PlotEngine properties