blob: 3f74e41084c402e7ed52710b0357e1ae7064b2fc [file] [log] [blame]
<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<section xmlns="http://docbook.org/ns/docbook" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://docbook.org/ns/docbook ../../../applications/content/dtd/docbook.xsd">
<section>
<title>OFBiz SeleniumXml Introduction with HTTPS</title>
<para>How to setup in firefox browser?</para>
<para> The problem for https is that the selenium­RC 1.0 and later will be runs in a separate profile automatically when the Selenium test is
opening a new session for the Firefox browser the browser will need a security certificate every time. When this occurs the browser
displays security pop up, and these pop up cannot be closed using Selenium­RC . So how to solve this? </para>
<para> Create a separate Firefox profile for your tests ( adding a https certificate or install some add­ons) </para>
<section>
<title>For Ubuntu Linux : </title>
<para>
<orderedlist>
<listitem>
<para>Make sure all your Firefox instances are closed .</para>
</listitem>
<listitem>
<para>Open a new Terminal and type the command firefox -p -no-remote in the terminal then press enter. The pop up window will
appear.</para>
</listitem>
</orderedlist>
</para>
<!--screenshot>
<graphic fileref="/images/seleniums/profile1.png" width="300" height="300"></graphic>
<caption>
<para>
Clicking on “Create Profile” to Create the new profile using the dialog , enter new profile name , choose folder to store your new profile and then click finish.
</para>
</caption>
</screenshot-->
<!--screenshot>
<graphic fileref="/images/seleniums/profile3.png" width="400"></graphic>
<caption-->
<para>After that click “Start Firefox” and configure settings based on suggestion below </para>
<section>
<title>warrning*</title>
<para> Be sure to put your profile in a new folder separate from the default!!! </para>
<para> The Firefox profile manager tool will delete all files in a folder if you delete a profile, regardless of whether they are
profile files or not. </para>
</section>
<!--/caption>
</screenshot-->
</section>
<section>
<title>- Suggested settings for your Selenium Profile</title>
<para>From “View\Toolbars” tab, uncheck “Bookmarks Toolbar” </para>
<para>Right click from toolbar and click “Customize” </para>
<para>Remove “Google search” by dragging it to the “Customize Toolbar” window </para>
<para>From the “Customize Toolbar” window, click “Use Small Icons” check box then hit “Done”</para>
<para>Click “Edit\Preferences” then set the following:</para>
<section>
<title>“Main” tab</title>
<para>
<orderedlist>
<listitem>
<para>set Home Page to “about:blank”</para>
</listitem>
<listitem>
<para>uncheck “Show the Downloads..” option</para>
</listitem>
</orderedlist>
</para>
</section>
<section>
<title>“Tabs” tab</title>
<para>
<orderedlist>
<listitem>
<para>Select “a new window” for new pages</para>
</listitem>
<listitem>
<para>Uncheck all warning options</para>
</listitem>
</orderedlist>
</para>
</section>
<section>
<title>“Content” tab</title>
<para>uncheck “Block pop-up” windows option</para>
</section>
<section>
<title> “Privacy” tab</title>
<para>uncheck all “History” options</para>
</section>
<section>
<title>“Security” tab</title>
<para>
<orderedlist>
<listitem>
<para>uncheck all “Security” options</para>
</listitem>
<listitem>
<para>click “Settings” and uncheck all warning options</para>
</listitem>
</orderedlist>
</para>
</section>
<section>
<title>“Advanced” tab</title>
<para>
<orderedlist>
<listitem>
<para>Uncheck “autoscrolling” option from “General” tab</para>
</listitem>
<listitem>
<para>uncheck “warn me …” and “Search Engines”option from “Update” tab </para>
</listitem>
</orderedlist>
</para>
</section>
<!--listitem>1.From “Tools\Add-ons” install the following:
<para>- Firebug: allows you to edit, debug, and monitor CSS, HTML, and JavaScript on your application under test</para>
<para>- Selenium IDE: allows you to record, edit, and debug Selenium tests</para>
<para>- ScreenGrab: saves entire webpages as images. </para>
</listitem>
<listitem>1.From the address bar type “about:config” and add the following by right-click anywhere on the page and selecting “new”
<para>- extensions.update.notifyUser (type=boolean; value=false)</para>
<para>- extensions.newAddons (type=boolean; value=false) </para>
</listitem>
</orderedlist-->
</section>
</section>
<section>
<title/>
<para/>
<!--para>
Set certificate for your firefox profile type and enter <ulink type="http" url="https://localhost:8443/"></ulink>
(* An url you want to get certificate.) then add an exception
</para>
<screenshot>
<graphic fileref="/images/seleniums/profile2.png" width="400"></graphic>
</screenshot-->
</section>
<section>
<title/>
<para>
<orderedlist>
<listitem>
<para>At the file “seleniumXml.properties”.</para>
</listitem>
<listitem>
<para>Change browser=*firefox</para>
</listitem>
<listitem>
<para>To browser=*firefox /usr/lib/firefox-3.0.8/firefox</para>
</listitem>
</orderedlist>
</para>
<para>(*** firefox path)</para>
</section>
<section>
<title/>
<para>
<orderedlist>
<listitem>
<para>At the file “runSeleniumServer.sh” </para>
</listitem>
<listitem>
<para>"$JAVA" -jar ../../framework/testtools/lib/selenium-server.jar </para>
</listitem>
<listitem>
<para>firefoxProfileTemplate "put path to the profile dir" </para>
</listitem>
<listitem>
<para>trustAllSSLCertificates -singleWindow -timeout 240 </para>
</listitem>
</orderedlist>
</para>
</section>
<section>
<title>Note : Please follows the link</title>
<para><!--ulink> http://cwiki.apache.org/confluence/display/OFBIZ/Ant+Script+to+build+new+ofbiz+self+cert </ulink--></para>
<para> if your found the problem “ofbiz.org cert is expired causes peer not authenticated“. </para>
</section>
</section>