4 Configuring Oracle HTTP Server in a Collocated Domain
Note:
-
Perform the configuration steps in this section only if you selected Collocated HTTP Server (Managed through WebLogic server) in the Installation Type screen. If you selected Standalone HTTP Server (Managed independently of WebLogic server), see Configuring Oracle HTTP Server in a Standalone Domain.
-
For information about Oracle HTTP Server domain configuration options, see About Oracle HTTP Server.
If you have not created the Oracle Fusion Middleware Infrastructure domain, you can create it at the same time as Oracle HTTP Server. For instructions, see Configuring the Oracle Fusion Middleware Infrastructure Domain in Installing and Configuring the Oracle Fusion Middleware Infrastructure. However, in Selecting Advanced Configurations, ensure that you select System Components too.
Stopping the Administration Server
Before starting the configuration wizard, it is important to shut down the Administration Server. This prevents any configuration locks, saves, or activations from occurring during the configuration of the domain.
To stop the Administration Server, go to the DOMAIN_HOME
/bin
directory.
-
On UNIX operating systems:
./stopWebLogic.sh
-
On Windows operating systems:
stopWebLogic.cmd
You may be prompted for the login credentials of the Administrator user you provided when you configured the Oracle Fusion Middleware Infrastructure domain.
Starting the Configuration Wizard
Start the Configuration Wizard to begin configuring a domain.
To start the Configuration Wizard:
Navigating the Configuration Wizard Screens to Extend the Domain
Use the Configuration Wizard to extend an existing Infrastructure domain with an Oracle HTTP Server instance.
Note:
When you are adding an Oracle HTTP Server instance to an existing domain, verify that the ports you are assigning to any new components are available. The Configuration Wizard does not perform automatic port allocation.
The following sections step through the Configuration Wizard:
Selecting the Domain Type and Domain Home Location
You must specify the domain to be updated with Oracle HTTP Server.
To specify the Domain type and Domain home directory:
- On the Configuration Type screen, select Update an existing domain.
- In the Domain Location field, select the Domain home location specified while configuring the Infrastructure domain.
For more information about this screen, see Configuration Type in Creating WebLogic Domains Using the Configuration Wizard.
Selecting the Configuration Template for Oracle HTTP Server
Use the Templates screen to select the template you require.
On the Templates screen, select one of the following templates:
-
For a Full-JRF configuration, select
Oracle HTTP Server (Collocated) - 14.1.2.0.0 [ohs]
. -
For a Restricted-JRF configuration, select
Selecting this template automatically selects the following as dependencies:Oracle HTTP Server (Restricted JRF) - 14.1.2.0.0 [ohs]
.-
Oracle Enterprise Manager-Restricted JRF
-
Oracle Restricted JRF
-
WebLogic Coherence Cluster Extension
-
If you are unsure what operational mode you want, see About Full-JRF and Restricted-JRF Modes for an overview of both modes.
For more information about this screen, see Templates in Creating WebLogic Domains Using the Configuration WizardSpecifying the Domain Mode and JDK
Use the Domain Mode and JDK screen to specify the domain mode and Java Development Kit (JDK) for your production environment.
On the Domain Mode and JDK screen:
-
Select Production in the Domain Mode field.
Note:
As of WebLogic Server 14.1.2.0.0, when you select Production mode, WebLogic Server automatically sets some of the security configurations of Secured Production to more secure values. However, there are certain security configurations (such as SSL/TLS) that require manual configuration. See Using Secured Production Mode in Administering Security for Oracle WebLogic Server.
The port configuration in Oracle HTTP Server should be consistent with the port configuration in WebLogic Server. For example, if the SSL ports are enabled and Listen ports (non-SSL) are disabled in Oracle HTTP Server, then the SSL ports should also be enabled in WebLogic Server.
If you want to disable the more secure default settings, then you may select Disable Secure Mode. This will enable the non-SSL listen ports.
If you want to retain the more secure default settings of Secured Production mode in general, but want to change which ports (listen ports, SSL listen ports, or administration ports) will be enabled by default in your domain, then you may:- Leave Disable Secure Mode unselected, and
- Change the default port selections under Enable or Disable Default Ports for Your Domain
For more information, see Understand How Domain Mode Affects the Default Security Configuration in Securing a Production Environment for Oracle WebLogic Server.
-
Select the Oracle HotSpot JDK in the JDK field.
Specifying the Database Configuration Type
Use the Database Configuration type screen to specify details about the database and database schema.
On the Database Configuration type screen, all fields are pre-populated, because you already configured the domain to reference the Fusion Middleware schemas that are required for the Infrastructure domain. Verify and ensure that credentials in all the fields are the same that you have provided while configuring Oracle Fusion Middleware Infrastructure.
Verify the database connection information, then select Get RCU Configuration. The following output in the Connection Result Log indicates that the operation succeeded:
Connecting to the database server...OK Retrieving schema data from database server...OK Binding local schema components with retrieved data...OK Successfully Done.
For more information about the schema installed when RCU is run, see Understanding the Service Table Schema in Creating Schemas with the Repository Creation Utility.
For more information about this screen, see Database Configuration Type in Creating WebLogic Domains Using the Configuration Wizard.
Note:
The following JDBC-related tasks are required for Full-JRF mode only; for Restricted-JRF mode, you can skip them.Specifying JDBC Component Schema Information
Use the JDBC Component Schema screen to verify or specify details about the database schemas.
Verify that the values populated on the JDBC Component Schema screen are correct for all schemas. If you selected RCU Data on the previous screen, the schema table should already be populated appropriately.
For an Autonomous Transaction Processing database (both Autonomous Transaction Processing-Dedicated (ATP-D) and Autonomous Transaction Processing Shared (ATP-S)), specify the connection credentials using only the Connection URL String option, and enter the connect string in the following format:
@TNS_alias?TNS_ADMIN=<path of the wallet files, ojdbc.properties, and tnsnames.ora>
In the connect string, you must pass TNS_alias
as the
database service name found in tnsnames.ora
, and
TNS_ADMIN
property to the location of the wallet files,
ojdbc.properties
, and tnsnames.ora
.
Example connect string for Autonomous Transaction Processing-Dedicated (ATP-D) database:
@dbname_tp?TNS_ADMIN=/users/test/wallet_dbname/
Example connect string for Autonomous Transaction Processing Shared (ATP-S) database:
@dbname_tp?TNS_ADMIN=/users/test/wallet_dbname/
For high availability environments, see the following sections in High Availability Guide for additional information on configuring data sources for Oracle RAC databases:
See JDBC Component Schema in Creating WebLogic Domains Using the Configuration Wizard for more details about this screen.
Testing the JDBC Connections
Use the JDBC Component Schema Test screen to test the data source connections.
A green check mark in the Status column indicates a successful test. If you encounter any issues, see the error message in the Connection Result Log section of the screen, fix the problem, then try to test the connection again.
By default, the schema password for each schema component is the password you specified while creating your schemas.
For more information about this screen, see JDBC Component Schema Test in Creating WebLogic Domains Using the Configuration Wizard.
Selecting Advanced Configuration
Use the Advanced Configuration screen to complete the domain configuration.
On the Advanced Configuration screen, select:
-
System Components
Specifying the Oracle HTTP Server Details
Use the OHS Server screen to configure the Oracle HTTP Server instance in the domain.
In the Listen Address field, specify the IP address of the host on which the Oracle HTTP Server instance will reside. Do not use localhost
. See Specifying the Listen Address in Creating WebLogic Domains Using
the Configuration Wizard.
All of the remaining fields are pre-populated, but you can change the values as required. For example, verify that the default port numbers are not used by other services.
Note:
If you change the admin host from default IP address127.0.0.1
to any other IP address, you must
ensure the following:
- Set
ServerName
directive inadmin.conf
to the host name or domain name that maps to the IP address that you have chosen. - Create an SSL certificate with a common name matching the host
name or domain name set up using the
ServerName
directive.
For more information, see Configuring SSL for Admin Port in the OHS Admin Guide.
For more information about this screen, see OHS Server in Creating WebLogic Domains Using the Configuration Wizard .
Assigning System Components to Machines
Use the Assign System Components to Machines screen to assign Oracle HTTP Server system components to the machine that you defined when you configured the initial Fusion Middleware Infrastructure domain.
On the Assign System Components to Machines screen:
-
In the Machine list box, select the machine (for example,
infra_machine_1
) to which you want to assign the Oracle HTTP Server instance. -
Assign the Oracle HTTP Server instance to the selected machine in one of the following ways:
-
Double-click
ohs1
in the System Components list box. -
Select the
ohs1
in the System Components list box and click the right arrow.
-
You can associate an Oracle HTTP Server machine to an existing machine or create a new machine. You typically create additional machines when you are planning to scale out the topology to multiple host computers. For more information, see Scaling Out a Topology (Machine Scale Out) in High Availability Guide.
Reviewing Your Configuration Specifications and Configuring the Domain
The Configuration Summary screen has detailed configuration information for the domain you are about to extend.
Review each item on the screen and verify that the information is correct. To make any changes, go back to a screen by clicking the Back button or selecting the screen in the navigation pane. Domain update does not start until you click Update.
For more information about this screen, see Configuration Summary in Creating WebLogic Domains Using the Configuration Wizard.
Writing Down Your Domain Home and Administration Server URL
The End of Configuration screen shows information about the domain you just configured.
Make a note of the following items because you need them later:
-
Domain Location
-
Administration Server URL
You need the domain location to access scripts that start Node Manager and Administration Server, and you need the URL to access the Administration Server.
Click Finish to dismiss the Configuration Wizard.
Starting the Servers
After configuration is complete, start Node Manager, then the WebLogic Administration Server and Managed Servers.
Note:
Depending on your existing security settings, you may need to perform additional configuration before you can start and manage a domain with secured production mode enabled. Specifically, you will need to add additional parameters when starting the Administration and Managed Servers. For more information, see Using Secured Production Mode Administering Security for Oracle WebLogic Server.
For more information on additional tools you can use to manage your domain, see Overview of Oracle Fusion Middleware Administration Tools in Administering Oracle Fusion Middleware.
Starting Node Manager
-
-
(UNIX) Go to the
DOMAIN_HOME/bin
directory. - (Windows) Go to the
DOMAIN_HOME\bin
directory.
-
-
Enter the following command:
-
(UNIX) Using
nohup
andnm.out
as an example output file:nohup ./startNodeManager.sh >
LOG_DIR
/nm.out&where
LOG_DIR
is the location of directory in which you want to store the log files. -
(Windows)
startNodeManager.cmd
Note:
On Windows operating systems, Oracle recommends that you configure Node Manager to run as a startup service. This allows Node Manager to start up automatically each time the system is restarted.
See Running Node Manager as a Startup Service in Administering Node Manager for Oracle WebLogic Server.
-
Starting the Administration Server
The procedures in this section describe how to start the Administration Server using the WLST command line or a script. You can also use the Oracle Fusion Middleware Control and the Oracle WebLogic Server Remote Console. See Starting and Stopping Administration and Managed Servers and Node Manager in Administering Oracle Fusion Middleware.
Note:
When using secured production mode, you must provide additional parameters to start the Administration Server. See Connecting to the Administration Server using WLST in Administering Security for Oracle WebLogic Server.
- (Optional) When using Production Mode, you can create a boot.properties file before starting the Administration Server and provide necessary permissions. This file can be created to bypass the need to provide a username and password when starting the Administration Server. For more information, see Creating a Boot Identity File for an Administration Server in Administering Server Startup and Shutdown for Oracle WebLogic Server.
-
Go to the
DOMAIN_HOME
/bin
directory. -
Enter the following command:
-
(UNIX)
./startWebLogic.sh
-
(Windows)
startWebLogic.cmd
If you selected Production Mode on the Domain Mode and JDK screen when you created the domain, and you did not create the optional boot.propeties file, you see a prompt for the Administrator user login credentials as provided on the Administrator Account screen.
-
- Open a browser and verify that the Administration Server is up
and running. The default port values will vary depening on how you
conifigured your domain. The Enable SSL Listen Port is enabled by default,
but the default values may change. For a list of default values, see Port Numbers by Product and
Component.
https://<Host_Name>:<port>
- Verify that all servers in the domain have unique port values. From the WebLogic Remote Console, you can review the Local Administration Port Override fields for each managed server and verify that each has a unique value. If one or more ports is using the same value, then you must change them before starting the managed servers. For more information about changing port values, see Connect to an Administration Server in the Oracle WebLogic Remote Console.
Note:
The WebLogic Server Administration Console has been removed. For comparable functionality, you should use the WebLogic Remote Console. For more information, see Oracle WebLogic Remote Console.Starting the Oracle HTTP Server Instance
To start the Oracle HTTP Server instance from Fusion Middleware Control:
-
Sign in to Fusion Middleware Control:
http://administration_server_host:administration_server_port/em
The Administration Server host and port number were provided in Writing Down Your Domain Home and Administration Server URL.
The login credentials were provided on the Administrator Account screen while installing.
-
Click HTTP Server in the navigation panel on the left side.
-
Select the Oracle HTTP Server instance you want to start (for example,
ohs1
) and click Start Up from the top panel.
-
On UNIX
-
Go to the
DOMAIN_HOME
/bin
directory. -
Modify
JAVA_OPTIONS
, if the domain is in the secure mode. See Understand How Domain Mode Affects the Default Security Configuration.Note:
You must perform this step only if the domain is in secure production mode. -
Run the following command:
./startComponent.sh
system_component_name
where
system_component_name
is the Oracle HTTP Server system component name you provided while configuring the domain.For example:
./startComponent.sh ohs1
-
-
On Windows
-
Go to the
DOMAIN_HOME
\bin
directory. -
Run the following command:
startComponent.cmd
system_component_name
where
system_component_name
is the Oracle HTTP Server system component name you provided while configuring the domain.For example:
startComponent.cmd ohs1
-
For more information about managing Oracle HTTP Server using Oracle Enterprise Manager Fusion Middleware Control, see Manage Oracle HTTP Server in Administering Oracle Fusion Middleware with Fusion Middleware Control.
For other tools and instructions, see Starting Oracle HTTP Server Instances in Administering Oracle HTTP Server.