Adding the Virtual Directory for Siebel CRM Composer

To add the virtual directory, perform the following tasks:

1. "Editing the new_virdirs Script"

   Edit the new_virdirs script to include the virtual directory name required for Siebel CRM Composer (the Siebel Web Tools application).

2. "Running the new_virdirs Script"

   Run the new_virdirs script and specify the language for which you want to create a virtual directory.

Perform these tasks on each Web server where you install Siebel Web Server Extension (SWSE) and on which you require the virtual directory. These tasks also update the eapps.cfg file for the SWSE to add language-specific application sections. Perform these tasks only once so that multiple sections are not added to the file.

Note: Perform these tasks only if it is required for your installation case. For more information, see "About Setting Up Siebel CRM Composer".

This task is a step in "Process of Setting Up Siebel CRM Composer".

Editing the new_virdirs Script

You edit the new_virdirs script to specify the virtual directory name that Siebel CRM Composer (the Siebel Web Tools application) requires. The virtual directory name is also used for the application section in the eapps.cfg file. You can run an edited script on additional Web servers, as necessary.

To edit the new_virdirs script 

1. Stop the Web server.

2. Back up the eapps.cfg file, the eapps_sia.cfg file, and the Web server configuration file, such as obj.conf, http.conf, or magnus.conf, as appropriate for your browser.

3. Navigate to SWSE_HOME/config.

   In this directory, SWSE_HOME is the SWSE installation location. (Use the backslash for Microsoft Windows; use the forward slash for UNIX or Linux.)

4. Back up the existing new_virdirs script as follows:

   • On Microsoft Windows, the name of the script is new_virdirs.bat.

   • On UNIX or Linux, the name of the script is new_virdirs.sh.

5. Using an appropriate text editor, such as Notepad on Microsoft Windows, open new_virdirs.bat or new_virdirs.sh.

   
   

   Note: When you edit the script, do not enter any special characters, such as tabs.

   
   

6. Add the elements for the Siebel Web Tools application to an existing entry in this file as follows so the file creates a new virtual directory and new eapps.cfg file section for the application:

   %JAVA_HOME%\java -jar %ORACLE_HOME%\config\new_virdirs.jar
   {webtools} {SWToolsObjMgr} %LANG
   

   In this entry, webtools is the name of the virtual directory, and SWToolsObjMgr is the name of the corresponding Application Object Manager without the corresponding language code. (The language-specific items are created when you run the script.)

7. Save the new_virdirs script.

   Next, run the new_virdirs script to add the virtual directory for the specified language. For more information, see "Running the new_virdirs Script".

Running the new_virdirs Script

You run the new_virdirs script to add the virtual directory for the specified language that Siebel CRM Composer (the Siebel Web Tools application) uses. Perform this task after you perform the task to edit the new_virdirs script. For more information, see "Editing the new_virdirs Script".

Note: If running the new_virdirs script does not create the required virtual directory, then you must restore the files on the Web server from the backup files that you created in Step 2.

To run the new_virdirs script 

1. Navigate to SWSE_HOME/config.

   In this directory, SWSE_HOME is the SWSE installation location. (Use the backslash for Microsoft Windows; use the forward slash for UNIX or Linux.)

2. Open a command window or shell window and run a command as follows:

   • On Microsoft Windows, run a command like the following command:

     new_virdirs.bat ENU
     

   • On UNIX or Linux operating systems, run a command like the following command:

     ./new_virdirs.sh ENU webserverlocation
     

     In this command, webserverlocation is the installation location of the Web server instance.

3. Specify the anonymous user for Siebel CRM Composer by adding parameters like the following parameters to the eapps.cfg file:

   AnonUserName = guestusername
   AnonPassword = guestuserpassword
   

   Specify the anonymous user name and password in each language-specific application section.

   
   

   Note: Add values similar to the values defined for other applications. In most cases, the AnonPassword value represents an encrypted value. To specify a different password, first encrypt the password by using the encryptstring utility. For more information, see Siebel Security Guide.

   
   

4. Restart the Web server.

5. Start a browser and start the Siebel Web Tools application by entering an appropriate URL, such as the following URL:

   http://server_name/webtools_enu
   

   In this command, server_name is the name of your server.