Goals To install, configure, and test the Siebel Web Server Extension Time 20 – 25 minutes
Instructions:
In this practice, you will install, configure, and test the Siebel Web Server Extension (SWSE). The Siebel Web Server Extension consists of an executable (a .dll file in this case, as you are working in a Windows environment), a configuration file for that executable, and a set of virtual directories that invoke that executable whenever a <swe> tag is encountered in the underlying HTML document.
1. Install the Siebel Web Server Extension:
a. Using Windows Explorer, navigate to
D:\labs\8.1_Install\Installers\Server\Siebel_Web_Server_Extension.
b. Double-click setup.exe. The setup program should be run on the machine hosting the Web server.
c. Use the parameters below to perform the installation, clicking Next each time to proceed through the installation. This copies all of the SWSE files to the installation directory, but performs no configuration.
Parameter Value Purpose
Directory Name D:\OUWebServer\SWEApp Location to place installed files.
Language(s) enu - English (American) Which language-specific files to install.
Program Folder Siebel Enterprise Server Configuration 8.1
Directory in Windows Start menu.
d. Once installation completes after a few minutes, the Siebel Web Server Extension Configuration Tool starts automatically.
2. Explore the installation prior to running the Configuration Tool:
Navigate away from the Configuration Tool, leaving it open.
Oracle Internal & Or acle Academy Use Only
c. Examine the configuration file generated when you created the SWSE logical profile during your Siebel Enterprise Server installation. The data in this file, as well as the configuration information you supply when applying the logical profile, will be used to replace the template eapps.cfg file:
i. Use Notepad to open D:\OUses\gtwysrvr\ADMIN\Webserver\eapps.cfg.
ii. Examine the file. Notice that the AnonUserName is GUESTERM; the value you entered when configuring the SWSE logical profile.
iii. Close eapps.cfg, not saving any changes.
iv. Right-click eapps_virdirs.bat and select Edit. This batch file is executed to generate the virtual directories that will be used by the various applications. Many customers edit this file to, for example, reduce the number of virtual directories created in the Web server, rename the application, or remove the language suffix from the application.
v. Close eapps_virdirs.bat, not saving any changes.
d. Select Start > Programs > Administrative Tools > Internet Information Services (IIS) Manager to open Microsoft’s Internet Information Services Manager. This is the third-party Web server used in this class.
e. In the left pane, if necessary expand your <machine name>, and then expand Web Sites and then Default Web Site.
f. Confirm that there are no virtual directories of the form <application>_<language code> (for example, callcenter_enu) for the default Web site.
g. Minimize Internet Information Services (IIS) Manager.
3. Return to the Siebel Web Server Extension Configuration Tool and complete the configuration using the parameters below, clicking Next each time to proceed through the configuration:
Parameter Value Purpose
Action Apply an SWSE
Logical Profile
Creates virtual directories on Web server and copies eapps.cfg and other support files to SWSE install directory.
Load Balancer Single Siebel Server If load balancing is selected, balances sessions for
enterprises with multiple Application Object Managers of the same type.
Siebel Server Host
Name <machine name> If load balancing is not selected, the single Server’s name will be written into eapps.cfg.
Siebel Server Connection Broker Port Number
2321 If load balancing is not selected, the single Server’s connection broker port will be written into eapps.cfg.
Siebel Web Server Extension Logical Profile Location
D:\OUses\gtwysrvr\
ADMIN\Webserver
The location of the logical profile that will be applied to generate eapps.cfg and the virtual directories.
4. Click Next twice and then Yes to execute the configuration. Note that a command window opens to run the eapps_virdir.bat batch file; do not proceed until the window closes and configuration is complete. This should take 1-2 minutes.
5. Click OK in the Execution Successful dialog box, and then Finish in the installer.
6. If necessary, click Next then Finish to exit the After Intallation dialog box.
Oracle Internal & Or acle Academy Use Only
Lesson 5: Installing the Siebel Web Server Extension
7. Verify the installation:
a. Open D:\OUWebServer\SWEApp\bin\eapps.cfg and verify that the connect strings for the applications now include the server name and connection broker port you entered; for example, //edpsr56p1:2321.
b. Return to Internet Information Services (IIS) Manager, select Default Web Site in the left pane, and then select Action > Refresh. Confirm that there are now many virtual directories of the form <application>_<language code>.
c. Close all open applications and files.
d. If necessary, start the Siebel Server service:
i. Select Start > Programs > Administrative Tools > Services.
ii. Scroll down to locate Siebel Server [OUEnt_OUSrvr].
iii. If its status is not Started, right-click Siebel Server [OUEnt_OUSrvr] and select Start.
iv. Right-click the task bar at the bottom of the window and select Task Manager.
v. Click the Performance tab.
vi. Wait until CPU usage drops below 50% for several seconds. The Siebel Server service may take several minutes to start.
vii. Minimize the Task Manager and the Services dialog box.
e. Select Start > Programs > Internet Explorer.
f. Enter an address of http://localhost/callcenter_enu and click Go. If the installation is successful, a Siebel Call Center login screen should appear:
Oracle Internal & Or acle Academy Use Only
g. Log in using:
User ID SADMIN
Password SADMIN
Click the arrow to log in.
Note: If you cannot log in or the login fails, please refer to the troubleshooting steps below.
h. If necessary, dismiss the various information boxes:
Note: Due to the configurations necessary to relax the security constraints of the classroom machines, you will probably not see these warnings in an Oracle classroom.
i. When asked whether to install the ActiveX controls, click Install.
ii. Click AutoFix in the Browser Health Check.
iii. Click Run in the Browser Health Check.
i. Add the additional license keys.
i. Use Notepad to open D:\Labs\8.1_Install\SIAKeys.txt and copy the second key.
ii. In the Siebel application, click the Site Map icon near the top of the screen.
iii. Click the Administration - Application link.
iv. Under Administration - Application, click License Keys.
Note: In future practices, this navigation may be abbreviated as, “Navigate to
Administration - Application > License Keys.” Note the lack of a mention of the Site Map icon.
v. Click New.
vi. Paste the key in the Key Value field and step off the record. If you receive an “Invalid Key” error, try re-copying and re-pasting the key.
vii. Step off the record to save it.
viii. Repeat these steps for the other keys in SIAkeys.txt.
ix. Close SIAkeys.txt.
8. Throughout the course, you will be using the Administration - Server Configuration and Administration - Server Management screens. Set your user preferences to make these tabs visible when you log in.
i. From the application-level (blue) menu, select Tools > User Preferences.
ii. Select Tab Layout from the drop-down list just to the right of Expense Reports.
Oracle Internal & Or acle Academy Use Only
Lesson 5: Installing the Siebel Web Server Extension
iii. Select the Hide checkbox next to item 8 (Administration - Product).
iv. Scroll down and deselect the Hide checkbox next to items 55 and 56.
b. In the Siebel application, select File > Log Out from the application-level (blue) menu.
c. Close Internet Explorer.
Troubleshooting (Optional Reading Practice)
Most people performing installations first realize that there is a problem with their installation at this point; they have installed the Siebel Gateway Name Server, Siebel Server, and Siebel Web Server Extension, yet they cannot bring up their login screen or cannot log in. Here are some debugging tips to help resolve a failed installation:
• You start the browser, enter the address for your virtual directory (for example, http://<machine name>/callcenter_enu) and receive the message:
“The server you are trying to access is either busy or experiencing problems.”
This indicates that the Web server is correctly routing requests to the server, but the server is unable to process them.
o Is the Siebel Server service running? If not, try restarting it. If it stops again, check the logs in D:\OUses\siebsrvr\log to try to determine which component is failing, and why. Larger, more recent logs are most likely to contain the pertinent information.
o Did you remember to enable to Application Object Manager’s component group? Check to make sure the appropriate AOM log file exists and contains data; for example,
SCCObjMgr_enu.log. If the logs are not there, it is likely you did not enable the AOM. You will either have to re-configure the Siebel Server (run the Configuration Tool to remove it, and then run it again to recreate it), or use the Siebel Developer Web client to enable the AOM on the server.
o Did you correctly configure the database connection information? Try testing the ODBC connection manually in the ODBC Data Source Administrator to make sure it is correctly configured.
o Has the database been correctly populated with Siebel tables and seed data? Perform the confirmation steps from the database configuration practice to ensure the database has been correctly configured.
o Did you install a license key in the database? Use the Developer Web client to add license keys to the database. Note that this requires installing the Developer Web client, which is covered in a later practice.
o Are the correct users added to both the database and the application? You used SADMIN and
Oracle Internal & Or acle Academy Use Only
Solutions 5-1 Installing the Siebel Web Server Extension
Answers
2.b.ii. Verify that t_swseapps.cfg contains configuration settings for many applications (for example, callcenter_$(DeployedLanuage)). What is the default value for AnonUserName (near the top of the file)?
$(EmplLoginUserName). This indicates that the generated eapps.cfg will use the employee login user name, which you entered as GUESTERM when you configured the SWSE logical profile.
Oracle Internal & Or acle Academy Use Only
Lesson 6: Installing the Siebel Developer or Mobile Web Client