My Oracle Support Banner

Multi-user Environment DISA Deploy Guide (Doc ID 2259966.1)

Last updated on APRIL 03, 2024

Applies to:

Siebel CRM - Version 16.10 [IP2016] and later
Information in this document applies to any platform.


Desktop Integration Siebel Agent (DISA) provide background service for Siebel application by listen to a local port. But on multi-user environments, because of system limitation, DISA instance for different users cannot share the same port, which requires unique port number for each user on the same machine. For that DISA and Siebel server can use a file to maintain the user-port map, instead of using file and system preferences.

This deployment include two parts, configuration on Siebel server side, and the DISA installation, which should be deployed on both server and Agent machine.

This implementation is a workaround for the fact that for any application, local port is a kind of exclusive resource on a physical or virtual machine. For multi-user environments such as Citrix, this is challenge for applications who need to serve over a local port as DISA, as multiple application instance from different users will conflict on that port resource.

Citrix has a solution for such Applications called "Citrix Virtual Loopback" which will virtualize the local port resource to avoid such conflict without extra configuration, but unfortunately this functionality is not compatible with Java 8 applications like DISA this feature has been implemented in order to provide a workaround so customers can start to deploy DISA on Citrix environment.

An Enhancement Request BUG:33866502 - ALTERNATIVE WAY TO CONFIGURE DISA VIA DYNAMIC PORT ASSIGNMENT INSTEAD OF STATIC has been logged for dynamic port assignment without the required to maintain the Windows User to Port and Siebel User to Port files mentioned below. To track the status of a BUG, please refer to Document Siebel: Tracking Bugs(Doc ID 2078803.1).


This feature required the following minimal versions:

Desktop Integration Siebel Agent 2.17.4 and higher

Siebel Innovation Pack 2016 PatchSet 12 and higher.



To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document
 1) Prepare Port List
 1.1) Windows User to Port (For DISA)
 1.2) Siebel User ID to Port (For Siebel Server)
 DISA Side Configuration (On Agent Machine)
 1) Install DISA
 2) Configure DISA
 Install Patch for Siebel Server
 1) Add System Preference
 FAQ about DISA and Multi User Environment feature
 1) Question: Is there any way to change this configuration and DISA dynamically assign the ports?
 2) Question: Can a Siebel User uses both a Virtual workstation or a physical workstation?
 3) Question: Can different Siebel Users use the same physical workstation?

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.