Creating Virtual Hosts for Oracle

Application Server and WebSphere

6.0

November 2006

JD Edwards EnterpriseOne Tools 8.96 Collaborative Portal Installation

Copyright 2006, Oracle. All rights reserved.
The Programs (which include both the software and documentation) contain proprietary information; they
are provided under a license agreement containing restrictions on use and disclosure and are also
protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering,
disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability
with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems
in the documentation, please report them to us in writing. This document is not warranted to be error-free.
Except as may be expressly permitted in your license agreement for these Programs, no part of these
Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for
any purpose.
If the Programs are delivered to the United States Government or anyone licensing or using the Programs
on behalf of the United States Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS
Programs, software, databases, and related documentation and technical data delivered to U.S.
Government customers are commercial computer software or commercial technical data pursuant to
the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such,
use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and
technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license
agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial
Computer Software--Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood
City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently
dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,
redundancy and other measures to ensure the safe use of such applications if the Programs are used for
such purposes, and we disclaim liability for any damages caused by such use of the Programs.
The Programs may provide links to Web sites and access to content, products, and services from third
parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites.
You bear all risks associated with the use of such content. If you choose to purchase any products or
services from a third party, the relationship is directly between you and the third party. Oracle is not
responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the
agreement with the third party, including delivery of products or services and warranty obligations related
to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you
may incur from dealing with any third party.
Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective owners.
Open Source Disclosure
Oracle takes no responsibility for its use or distribution of any open source or shareware software or
documentation and disclaims any and all liability or damages resulting from use of said software or
documentation. The following open source software may be used in Oracle's PeopleSoft products and
the following disclaimers are provided.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
Copyright (c) 1999-2000 The Apache Software Foundation. All rights reserved. THIS SOFTWARE IS
PROVIDED AS IS AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE
FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.

Table of Contents
Creating Virtual Hosts

Why a Virtual Host? ....................................................................................... 1

Virtual Host for Oracle Application Server ...................................................... 2
Virtual Host for WebSphere 6.0 ..................................................................... 9

Creating Virtual Hosts

Creating Virtual Hosts

This chapter discusses:

Why a Virtual Host?

VH for Oracle Application Server

VH for WebSphere 6.0

Why a Virtual Host?

Often times the physical server name is not intuitive to end users, and it might be better to create a virtual
host name that is easier for users to remember and navigate to. In general there is two steps to enable
virtual hosts aliases for making an easier URL direct to a physical server.
1. Modify the J2EE application server and or HTTP Server
2. Add network navigation (DNS/hosts) knowledge for end client workstations to be able to locate
the server.
This document covers the necessary steps to create a virtual host alias for both the Oracle Application
Server and the WebSphere 6.0 J2EE application servers. For the purpose of this document, a virtual
host will be added so the server can be resolved at http://webtest where webtest is the name of the
virtual host.
See Also

11/27/06

Creating Virtual Hosts

Virtual Host for Oracle Application Server

Assuming the Oracle Application Server has already been installed and EnterpriseOne HTML server
has already been installed, configured and able to sign on for the standard web server. Also before
beginning, make sure that from the web server, you are able to resolve the virtual host name by
pinging the name from a command line.

To create a new Virtual Host for Oracle Application Server

1. Through a browser, start the Enterprise Manager console for the OAS instance the
EnterpriseOne Oracle HTML Server has been installed to.
http://machine_name:1810/
The browser should prompt for the ias_admin user ID and password.

2. If installing to a portal infrastructure, select the instance to administer there should be two to
choose from: infra and portal. Select the instance for the OraHome the E1 OJAS was installed
to.

11/27/06

Creating Virtual Hosts

3. Once in the EM click the link for the HTTP Server to begin administrator.

4. In the HTTP Server configuration, select the Virtual Hosts tab

11/27/06

Creating Virtual Hosts

5. Select the Create button from the Virtual Hosts page. It will launch a wizard to guide you through
creating a virtual host.

6. Click next on the first step to begin configuration.

7. On the General tab, the defaults are acceptable, but can be changed for specific directory root,
index and email for the administrator. Make sure the VH Type is set to name-based. Click the
Next button.

11/27/06

Creating Virtual Hosts

8. Enter the physical name of the web server into the Server Name field. Enter the name of the
virtual host name into the Server Alias field. Click the Next button.

9. For the VH Ports, select Listen only on the main server default ports and click the Next button.

11/27/06

Creating Virtual Hosts

10. Defaults are acceptable on the Error Log step. Location and level can changed if desired.

11. Clicking Next on the last step will configure the Virtual Host alias. Review all the settings and
proceed if acceptable.

11/27/06

Creating Virtual Hosts

12. OAS should report that the configuration changes have been successfully saved and that the
HTTP Server requires restarting. Click the Yes button to restart the HTTP Server.

13. Click Ok on the HTTP Server restart message.

14. The new alias should now appear in the Virtual Host alias list. And the configuration is complete.

11/27/06

Creating Virtual Hosts

15. To test the configuration, launch a new web browser and enter the virtual host alias as the URL.
Make sure that the sign on page returns, and E1 login and sign out works.
http://webtest:81/jde

11/27/06

Creating Virtual Hosts

Virtual Host for WebSphere Application Server

6.0
Assuming the WebSphere Application Server has already been installed and EnterpriseOne HTML
server has already been installed, configured and able to sign on for the standard web server. Also
before beginning, make sure that from the web server, you are able to resolve the virtual host name
by pinging the name from a command line.

To create a new Virtual Host for WebSphere Application Server 6.0

1. Make sure that the Application Server server1 has already been started.
2. Start a web browser Mozilla / Internet Explorer
3. Change the URL to go to http://<machine name>:<port>/admin
http://localhost:9060/admin
Note: If the port number is unknown and the default port is not working, check the file
/opt/WebSphere/AppServer/profiles/AppSrv01/logs/portdef.props for key WC_adminhost.
That
should list the assigned admin port number

4. Sign in with any value for the user ID

11/27/06

Creating Virtual Hosts

5. Navigate the left hand menu to Environment -> Virtual Hosts

6. Locate the virtual host for the E1 HTML Application Server to add the virtual host alias to, for
example VH_JS_81. Select the link for the VH.

10

11/27/06

Creating Virtual Hosts

7. Select the Host Aliases link on the right side of the pane.

8. There should be at least one entry in the list already. Click the New button to add a new entry for
the virtual host.

11

11/27/06

Creating Virtual Hosts

9. Enter the virtual host name and port number and click the OK button. For our example, enter
webtest and port 81.

10. The WebSphere configuration will require saving. Click the Save link at the top of the virtual host
alias list.

12

11/27/06

Creating Virtual Hosts

11. Click the Save button on the confirmation screen.

12. Whenever there is an install of a new enterprise applications, or create new virtual hosts, the Web
Server plugin must be regenerated. If the WebSphere install is on a single machine, the plugin can be
generate from the Web Administrative console. However, if it is a multiple machine configuration, the
plugin might need to be generated manually.
On the WebSphere Administrative consoles left hand navigation pane, navigate to and select
Servers->WebServers
13. Place a check mark next to the webserver definition to regenerate the plugin for and click the
Generate Plug-in button above it.

13

11/27/06

Creating Virtual Hosts

14. The Plugin file (plugin-cfg.xml) will be regenerated in place at

C:\WebSphere\AppServer\profiles\AppSrv01\config\cells\WebServerNode01Cell\nodes\webserve
r1_node\servers\webserver1
15. Once the plugin has been regenerated, be sure to bounce the JAS instance.
16. The final step is an HTTP Server configuration set. Locate the HTTP Server installation
configuration file. Open the httpd.conf file in a text editor.
C:\WebSphere\IHS\conf\http.conf
17. Add the following lines to the bottom of the configuration file.
NameVirtualHost webtest:80
<VirtualHost webtest:80>
Alias /jde/ "C:/WebSphere/AppServer/profiles/AppSrv01/installedApps/WebServer
Node01Cell/EA_JS_81.ear/webclient.war/"
</VirtualHost>
Where WebServer is the name of your server and 81 is the http port defined during the
EnterpriseOne HTML Server installation.
18. Save the file and restart the HTTP Server.

14

11/27/06