[IMP] iot: windows iot worldline exception
closes odoo/documentation#7741 Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
This commit is contained in:
parent
34e9ab6754
commit
4dc8875b42
@ -29,7 +29,7 @@ installation.
|
|||||||
- Windows computer (laptop, desktop, or server).
|
- Windows computer (laptop, desktop, or server).
|
||||||
- Odoo :abbr:`IoT (Internet of Things)` subscription. Refer to: :ref:`iot/iot-eligibility`.
|
- Odoo :abbr:`IoT (Internet of Things)` subscription. Refer to: :ref:`iot/iot-eligibility`.
|
||||||
|
|
||||||
Connect the Windows virtual Iot box to an Odoo database
|
Connect the Windows virtual IoT box to an Odoo database
|
||||||
=======================================================
|
=======================================================
|
||||||
|
|
||||||
The Windows virtual IoT box is simple to setup in just a few easy steps. Follow this process when
|
The Windows virtual IoT box is simple to setup in just a few easy steps. Follow this process when
|
||||||
@ -44,7 +44,7 @@ and setup the Odoo :file:`.exe` file. After the instructions screen, click :guil
|
|||||||
the installation and agree to the :abbr:`TOS (Terms of Service)`.
|
the installation and agree to the :abbr:`TOS (Terms of Service)`.
|
||||||
|
|
||||||
During the next step of the installation, select :guilabel:`Odoo IoT` from the :guilabel:`Select the
|
During the next step of the installation, select :guilabel:`Odoo IoT` from the :guilabel:`Select the
|
||||||
type of install` dropdown.
|
type of install` drop-down menu.
|
||||||
|
|
||||||
.. example::
|
.. example::
|
||||||
For reference, the following should be installed:
|
For reference, the following should be installed:
|
||||||
@ -68,13 +68,13 @@ To complete the installation, select the :guilabel:`Destination Folder` and clic
|
|||||||
the hard drive.
|
the hard drive.
|
||||||
|
|
||||||
.. warning::
|
.. warning::
|
||||||
Odoo's Windows virtual IoT software shouldn't be installed inside any of the Window's User's
|
Odoo's Windows virtual IoT software should not be installed inside any of the Window's User's
|
||||||
directories. Doing so won't allow for Nginx to initialize.
|
directories. Doing so will not allow for Nginx to initialize.
|
||||||
|
|
||||||
The installation may take a few minutes. When complete, click :guilabel:`Next` to continue.
|
The installation may take a few minutes. When complete, click :guilabel:`Next` to continue.
|
||||||
|
|
||||||
Ensure that the :guilabel:`Start Odoo` box is checked and click :guilabel:`Finish`. After
|
Ensure that the :guilabel:`Start Odoo` box is checked and click :guilabel:`Finish`. After
|
||||||
installation, the Odoo server will run and automatically open `http://localhost:8069` on your web
|
installation, the Odoo server will run and automatically open `http://localhost:8069` on a web
|
||||||
browser. The webpage should display the :abbr:`IoT (Internet of Things)` box homepage.
|
browser. The webpage should display the :abbr:`IoT (Internet of Things)` box homepage.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
@ -160,7 +160,7 @@ firewall program. Windows has their own firewall as do other virus protection pr
|
|||||||
Making an exception on Windows Defender
|
Making an exception on Windows Defender
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
It's possible to allow other devices to access the Windows virtual :abbr:`IoT (Internet of Things)`
|
It is possible to allow other devices to access the Windows virtual :abbr:`IoT (Internet of Things)`
|
||||||
box while keeping the firewall on. This is done by creating a rule on *Windows Defender* and
|
box while keeping the firewall on. This is done by creating a rule on *Windows Defender* and
|
||||||
allowing communication through port `8069`. The following process describes the steps to take in
|
allowing communication through port `8069`. The following process describes the steps to take in
|
||||||
order to make this exception.
|
order to make this exception.
|
||||||
@ -196,6 +196,111 @@ add a brief description in the :guilabel:`Description` field. Click :guilabel:`F
|
|||||||
the :guilabel:`Rule Configuration` wizard. Now, the new rule is active and devices can connect to
|
the :guilabel:`Rule Configuration` wizard. Now, the new rule is active and devices can connect to
|
||||||
the Windows virtual :abbr:`IoT (Internet of Things)` box.
|
the Windows virtual :abbr:`IoT (Internet of Things)` box.
|
||||||
|
|
||||||
|
Worldline exception
|
||||||
|
~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
*Worldline* is a payment terminal that can be connected to Odoo's *PoS* (point of sale) system. It
|
||||||
|
allows for a comprehensive and fluid payment experience for customers. Worldline is available in
|
||||||
|
Benelux (coalition of Belgium, the Netherlands, and Luxembourg).
|
||||||
|
|
||||||
|
When using the Windows IoT server to connect the Worldline payment terminal, it is necessary to
|
||||||
|
create an exception in the Windows firewall so that a connection can be made between the Odoo
|
||||||
|
database/:abbr:`IoT (Internet of Things)` box and Worldline.
|
||||||
|
|
||||||
|
.. seealso::
|
||||||
|
:doc:`../../../sales/point_of_sale/payment_methods/terminals/worldline`
|
||||||
|
|
||||||
|
To create the exception, first, open the *Windows Defender Firewall* app on the Windows machine.
|
||||||
|
This can be accomplished by typing `windows defender` in the :guilabel:`Search` bar.
|
||||||
|
|
||||||
|
Next, click :guilabel:`Advanced settings` in the left menu.
|
||||||
|
|
||||||
|
.. image:: windows_iot/advanced-settings.png
|
||||||
|
:align: center
|
||||||
|
:alt: Advanced settings option highlighted in the left pane of the Windows Defender Firewall app.
|
||||||
|
|
||||||
|
In the left menu, choose :guilabel:`Inbound Rules`.
|
||||||
|
|
||||||
|
.. image:: windows_iot/inbound-rules.png
|
||||||
|
:align: center
|
||||||
|
:alt: Windows Defender left window pane with inbound rules menu item highlighted.
|
||||||
|
|
||||||
|
After selecting :guilabel:`Inbound Rules`, select :guilabel:`New Rule` in the far right menu.
|
||||||
|
|
||||||
|
.. image:: windows_iot/new-rule.png
|
||||||
|
:align: center
|
||||||
|
:alt: New rule dropdown shown with new rule option highlighted.
|
||||||
|
|
||||||
|
Then, for the :guilabel:`Rule Type`, select the radio button for :guilabel:`Port`. Click
|
||||||
|
:guilabel:`Next` to continue to the rest of the configuration.
|
||||||
|
|
||||||
|
.. image:: windows_iot/radio-port.png
|
||||||
|
:align: center
|
||||||
|
:alt: Rule Type window open, with the radio button next to port highlighted.
|
||||||
|
|
||||||
|
On the :guilabel:`Protocols and Ports` page, choose the radio button for :guilabel:`TCP`, under
|
||||||
|
:guilabel:`Does this rule apply to TCP or UDP?`.
|
||||||
|
|
||||||
|
Next, under :guilabel:`Does this rule apply to all local ports or specific ports?`, select the radio
|
||||||
|
button for :guilabel:`Specific local ports`. Then, enter `9050`, and click :guilabel:`Next` to
|
||||||
|
continue.
|
||||||
|
|
||||||
|
.. image:: windows_iot/protocol-port.png
|
||||||
|
:align: center
|
||||||
|
:alt: Protocol/port configuration window with TCP, specific port (9050) and Next highlighted.
|
||||||
|
|
||||||
|
The next screen is the :guilabel:`Action` page. Under :guilabel:`What action should be taken when a
|
||||||
|
connection matches the specified conditions?`, choose the radio button for :guilabel:`Allow the
|
||||||
|
connection`. Then, click :guilabel:`Next` to continue.
|
||||||
|
|
||||||
|
A :guilabel:`Profile` page appears. Under :guilabel:`When does this rule apply?`, leave the three
|
||||||
|
boxes checked for: :guilabel:`Domain`, :guilabel:`Private`, and :guilabel:`Public`. Click
|
||||||
|
:guilabel:`Next` to continue to the naming convention page.
|
||||||
|
|
||||||
|
On the :guilabel:`Name` page, enter `Odoo Worldline`, under the :guilabel:`Name` field. Enter a
|
||||||
|
:guilabel:`Description (optional)`. Finally, once ready, click :guilabel:`Finish`.
|
||||||
|
|
||||||
|
The final :guilabel:`Inbound rule` should appear as follows:
|
||||||
|
|
||||||
|
.. list-table::
|
||||||
|
:header-rows: 1
|
||||||
|
:stub-columns: 1
|
||||||
|
|
||||||
|
* -
|
||||||
|
- Odoo Worldline
|
||||||
|
* - Profile
|
||||||
|
- All
|
||||||
|
* - Enabled
|
||||||
|
- Yes
|
||||||
|
* - Action
|
||||||
|
- Allow
|
||||||
|
* - Override
|
||||||
|
- No
|
||||||
|
* - Program
|
||||||
|
- Any
|
||||||
|
* - Local Address
|
||||||
|
- Any
|
||||||
|
* - Remote Address
|
||||||
|
- Any
|
||||||
|
* - Protocol
|
||||||
|
- TCP
|
||||||
|
* - Local Port
|
||||||
|
- 9050
|
||||||
|
* - Remote Port
|
||||||
|
- Any
|
||||||
|
* - Authorized Users
|
||||||
|
- Any
|
||||||
|
* - Authorized Computers
|
||||||
|
- Any
|
||||||
|
* - Authorized Local Principals
|
||||||
|
- Any
|
||||||
|
* - Local User Owner
|
||||||
|
- Any
|
||||||
|
* - PolicyAppld
|
||||||
|
- None
|
||||||
|
* - Application Package
|
||||||
|
- Any
|
||||||
|
|
||||||
Uninstalling Windows IoT
|
Uninstalling Windows IoT
|
||||||
------------------------
|
------------------------
|
||||||
|
|
||||||
|
Binary file not shown.
After Width: | Height: | Size: 16 KiB |
Binary file not shown.
After Width: | Height: | Size: 34 KiB |
Binary file not shown.
After Width: | Height: | Size: 5.6 KiB |
Binary file not shown.
After Width: | Height: | Size: 39 KiB |
Binary file not shown.
After Width: | Height: | Size: 17 KiB |
Loading…
Reference in New Issue
Block a user