Problem:
As of this writing, no correct, detailed instructions exist for integrating the WebSphere plugin in to Oracle iPlanet Web Server 7.
iPlanet, originally a Netscape product, was acquired by Sun and renamed SunOne Web Server, and later Java System Web Server. After Sun was acquired by Oracle, the product was renamed to Oracle iPlanet Web Server.
WebSphere refers to iPlanet by the older name, SunOne Web Server, and the native integration scripts do not work correctly, necessitating a manual configuration (see procedure below). Once configured, the pluging works as expected.
Procedure for Manually Configuring WebSphere plugin and iPlanet Web Server:
1. In iPlanet, create a new configuration
– Configurations tab
– “New” button
– Name: WASApp
– Server Name: Servername (iPlanetServer01)
– Document root: (Default)
– “Next” button
– Port: 80 (Default)
– IP Address: * (Default)
– “Next” button
– Java: (Check box) “Enabled” — CLEAR (not checked)
– CGI: (Radio select) “None”
– SHTML: (Check box) “Enabled” — CLEAR (not checked — default)
– “Next” button
– Select nodes (administration nodes): (select any node) “iPlanetServer01”, click “Add”
– “Next” button
– “Finish” button
(Configuration completed successfully)
– “Close” button
(Leave it “off” — NOT running)
2. Configure SSL
– Install SSL certificate (procedure TBD)
{
Procedure for self-signed certificate
– “Configurations” tab
– Click “WASApp” configuraration in list
– “Certificates” tab
– “Request” button
– Token: Internal (Eh?)
– Password: Null (Gray,, Eh?)
– “Next” button
– Server Name: (MUST USE FQDN) iPlanetServer01.Somedomain.com
– Organization: SomeCompany Name
– Organizational Unit: Business Unit
– Locality: (City) Dallas
– State: (Spell completely) Texas
– Country: United States (Selection box)
– “Next” button
– (Certificate Options)
– (Radio selection) “RSA”
– Keysize: 2048 (security policy — default)
– “Next” button
– (Certificate Type)
– (Radio selection) “Self-signed Certificate”
– Nickname: “cert-WASApp”
– validity period: 99 months (normal is 12 for verisign, 24 for geotrust)
– Listener: https-listener-1 (note: HTTPS)
– “Next” button
– “Finish” button
– ( Certificate created successfully )
– “Close” button
(The only way I figured out to make this thing work is to make one listener for cleartext HTTP on 80, and a second, HTTPS (SSL) on 443
}
– Configurations tab
– Click “WASApp” configuraration in list
– HTTP Listeners tab
– Click “New” button
– Name: https-listener-1
– Port: 443
– IP Address: * (Default)
– Server Name: iPlanetServer01 (Use FQDN)
– Default Virtual Server: WASApp
– “Next” button
– “Finish” button
– “Close” button
– (Add listener to virtual server)
– “Configurations” tab
– Click “WASApp” configuration hyperlink
– Click “WASApp” virtual server hyperlink
– Scroll down to “HTTP Listeners” section
– “Add” button (above list)
– In “Select Listeners”, make sure “httpS-listener-1” (Note: HTTPS) is selected
– “Add” button (lower-right)
– Scroll up to the top
– “Save” button (top-right)
– (Should indicate “General settings saved successfully”)
– (Redeploy)
– Click “Configurations” hyperlink (above “Virtual Servers” tab)
– Check the checbox next to “WASApp” configuration
– “Deploy” button (Above list)
– (Configuration Deployment window)
– “Deploy” button
– (If restart is required, select “now” and click “OK”)
– “Close” button
3. Validate deployment is working
– Click “Configurations” hyperlink (above “virtual servers” tab)
— or —
– “Configurations” tab (next to “Common tasks” tab)
– Click the check box next to “WASApp” configuration (checked)
– “Start” button (above-center list)
– In a browser, go to:
https://iPlanetServer01.somedomain.com
(Should get generic Oracle webpage)
– In Admin console, stop the configuration by checking the check box next to WASApp configuration, then click “Stop”
4. Install WebSphere Plugin
(Assumes iPlanet install folder is C:\Program Files\Oracle\WebServer7
– Server name: fully qualified domain name of server. In this case, iPlanetServer01.carreker.com (use FQDN on “real” server)
– Magnus file: C:\Program Files\Oracle\WebServer7\https-WASApp\config\magnus.conf
– Obj file: C:\Program Files\Oracle\WebServer7\https-WASApp\config\obj.conf
(Note: Default install folder for WebSphere is C:\Program Files\IBM\WebSphere\Plugins)
//NOTE: Skip this step. Automated configuration does not work
//********************************************
//5. IF reconfiguring iPlanet….
//- Open command prompt
//- go to Websphere/bin folder (cd /d “c:\program files\ibm\websphere\plugins\bin”)
//- Run the following command:
// configureSunOnePlugin.bat -plugin.home c:\progra~1\ibm\websphere\plugins -plugin.config.xml c:\progra~1\ibm\websphere\plugins\config\iPlanetServer01\plugin-cfg.xml -sunone.magnus.obj c:\progra~1\oracle\webserver7\https-WASApp\config\obj.conf -sunone.magnus.conf c:\progra~1\oracle\webserver7\https-WASApp\config\magnus.conf -WAS.webserver.name iPlanetServer01 -operating.system.arch 32
// ( fix:
// – NOTE: HELP INCORRECTLY labels -sunone.obj.conf — is really: -sunone.magnus.obj
// – Websphere program files folder
// – iPlanet program files folder
// – Server name: Use short name
// – architecture: 32 or 64
// )
//Sample Output:
// {
// WAS_PLUGIN_HOME = c:\progra~1\ibm\websphere\plugins
// INSTALL_ARCH = 32
// WEBSERVER_NAME = iPlanetServer01
// PLUGIN_CONFIG_XML = c:\progra~1\ibm\websphere\plugins\config\iPlanetServer01\plugin-cfg.xml
// SUNONE_MAGNUS_OBJ = c:\progra~1\oracle\webserver7\https-WASApp\config\obj.conf
// MAGNUS_CONFIG_FILE = c:\progra~1\oracle\webserver7\https-WASApp\config\magnus.conf
// Buildfile: c:\progra~1\ibm\websphere\plugins\properties\version\nif\config\install\99SBootStrapPluginsSunOne.ant
//
// bootstrapPluginsSunOne:
//
// Usage:
//
// BUILD SUCCESSFUL
// Total time: 1 second
// }
6. MANUAL configuration of iPlanet to use websphere plugin
(Note: Config directory is C:\Program Files\Oracle\WebServer7\https-WASApp\config)
(Note: Reference:
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/tins_manualWebIPL.html
)
– Edit config/magnus.conf
– (Should be blank except for comments — if not, comment out all lines)
– Add the following lines:
Init fn=”load-modules” funcs=”as_init,as_handler,as_term” shlib=”C:\\Progra~1\\IBM\\WebSphere\\Plugins\\bin\\ns41_http.dll”
Init fn=”as_init” bootstrap.properties=”C:\\Progra~1\\IBM\\WebSphere\\Plugins\\config\\iPlanetServer01\\plugin-cfg.xml”
(Fix the following:
– Eliminate space in “Program Files” by replacing with Progra~1
– Put in correct path for Websphere plugin DLL
– Put in correct path for Websphere server plugin config XML. Replace “iPlanetServer01″ with the correct FQDN entered during WAS plugin install
– MAKE SURE to replace \ with \\ (unix style) ALL C:\somedir\file1 == C:\\somedir\\file1 else you get c:somedirfile1
)
– Save
– Edit WASApp-obj.conf (IGNORE obj.conf)
– Add the following lines IMMEDIATELY BELOW: <object name=”default”>
(Note: Precedence depends on these lines being at the “top” of the <object> section)
Service fn=”as_handler”
AddLog fn=”as_term”
– Start the configuration (See above)
– Check: C:\Program Files\Oracle\WebServer7\https-WASApp\logs\errors for errors if any
– In magnus.conf, make sure \ == \\ (DOUBLE CHECK ALL \)