Desktop Integration Siebel Agent Guide > Installing Desktop Integration Siebel Agent > Deploying DISA on Multi-User Environments >

DISA Deployment Process on a Multi-User Environment

Perform the following tasks to deploy DISA on a multi-user environment:

1. Preparing the Port List
2. Configuring DISA on an Agent Machine
3. Installing Patch for Siebel Server

Preparing the Port List

The administrator assigns each agent a port number. Normally the range of port number is 1 to 65535, of which some numbers may be reserved. Choose valid port number and ensure that it does not conflict with other service on agents' machine. For agents who may have logged in to the same terminal server, each agent must have a unique port number to avoid conflict with that of others.

An agent will have in the following accounts in the two port lists where the agent's port number must be consistent in both the lists.

• Windows user account
• Siebel user account

Windows User to Port (For DISA)

• This file must be a text file; contain agent's window user names in uppercase; the port number assigned to the agent and connected with Equal to (=). Each record takes a single line as follows:

  <WINDOWS_USER_NAME>=<port number>

  NOTE:  In Windows, open a command line window and run the following command:

  echo %username%

• It will print the current user name, use this name in uppercase as the Windows user name in the list.

  >C:\Users\winuser1>echo %username%

  >winuser1

• Windows user name is case insensitive, but for consistency, the port list accepts only uppercase Windows user name. For example:

  WINUSER1=18445

  WINUSER2=18446

  WINUSER3=18447

  WINUSER4=18448

  WINUSER5=18449

  WINUSER6=18450

  ...

Siebel User ID to Port (For Siebel Server)

• This file must be a text file; contain the agent's Siebel user ID in uppercase; the port number assigned to the agent and connected with Equal to (=). Each record takes a single line as following:

  <SIEBEL_USER_ID>=<port number>

  NOTE:  In Siebel application, go to Administration - User view and then Employees view. The User ID filed value must be used as the Siebel user ID in uppercase.

• Siebel User ID accepts uppercase only. For example:

  SIEBELUSER1=18445

  SIEBELUSER2=18446

  SIEBELUSER3=18447

  SIEBELUSER4=18448

  SIEBELUSER5=18449

  SIEBELUSER6=18450

  ...

Configuring DISA on an Agent Machine

1. Install and configure DISA. Refer to Installing and Configuring DISA. For multi-user environment, users on the same machine can share one DISA installation.
2. Configure DISA for multi-user environment. Do the following:
   1. Open the <DISA_Install_Dir>\DesktopIntSiebelAgent folder.
   2. Open the onfig.properties file with a text editor and add the following line:

   portListPath=<path_to_port_list_file>

3. Replace the place holder <path_to_port_list_file> with the path that points to the Windows user to port file from the previous step. The path can point to a shared location.

   NOTE:  If the path contains a back slash (\), replace the single back slash with a forward slash (/) or a double back slash (\\).

   Every time DISA starts, it will try to find the port number with the current Windows user name, if no such record is found, DISA will use the port number that is specified in the config.properties file.

   To verify the change, set logLevel to 8 and restart DISA. In the newest DISA log file, you will see a log entry similar to this:

   2017-01-19 10:52:37.623:INFO:info: Start server @127.0.0.1:18443

   Check if the port number is correct.

   NOTE:  The portListPath property must be applied only to DISA for multiple-user environment agents. It is not recommended for regular environments.

Installing Patch for Siebel Server

Install the Siebel IP2016 patchset 12 on the Siebel server using the following instructions:

1. Add System Preference
   1. Log in to Siebel with administrative privileges.
   2. Go to Administration - Application, and then to System Preference.
   3. Add a new System Preference:

      Name: DISAPortListPath

      Value: The path to the Siebel user ID to port list file in previous steps.

      Make sure the path is accessible to the Siebel server machine. Bounce the server to make the change take effect.

      To verify the change, log in to a Siebel application with a Siebel User ID, from the list file. If DISA is running and configured, you will be able to use DISA functionalities. If DISA is not running, you will see the following message in the browser console:

   WebSocket connection to 'wss://localhost:18443/' failed:Error in connection establishment

   Check the wss://localhost:<port>, to see if the port number is correct in this message.