# Setting Up Polarity Enterprise Edition

## System Requirements

In order to run the Polarity-Client, there are some basic requirements that your computer will need to meet:

{% tabs %}
{% tab title="macOS" %}

* 64 bit version of macOS 10.9 or greater
* 4+ GB of RAM
* 2+ GHz Quad Core CPU with Hyper-Threading
  {% endtab %}

{% tab title="Windows" %}

* 64 bit version of Microsoft® Windows® 10, 8.1, 8, 7
* 4+ GB RAM
* 2+ GHz Quad Core CPU with Hyper-Threading
  {% endtab %}

{% tab title="Linux" %}

* 64 bit version of CentOS 7, Ubuntu 16 LTS or Ubuntu 18 LTS
* 4+ GB RAM
* 2+ GHz Quad Core CPU with Hyper-Threading
  {% endtab %}
  {% endtabs %}

## Client Installation

### Prior to installation&#x20;

{% hint style="warning" %}
Ensure that all system requirements are met.
{% endhint %}

Download the Polarity-Client Installer to your local file system. This will be provided by your Polarity Account Manager.

1. Run the executable file that will look like the following: PolarityInstaller-VX.X.X.exe or PolarityInstaller-vX.X.X.dmg.

### After Installation

Once the system is installed it will provide you with the option to start Polarity. If you click yes then the application will start.

If you do not start Polarity after installing go to your desktop and locate the Polarity Icon and double-click.

Polarity is meant to run in the background of your computer and can be accessed from the system tray or macOS menu bar.

## Connecting to the Polarity Server

In order for Polarity to work, a connection to a Polarity Server needs to be configured. Upon first launch, Polarity will prompt you to configure your connection settings.

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FG9LGWJw00geTrFeqLdfM%2Fsignin_enter_server.png?alt=media\&token=48bf5c6a-7d8d-4b2a-8471-5a2d49fec05b) ![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FY9GCOBY8gYriCuFrkGRh%2Fsignin_enter_userandpass.png?alt=media\&token=6acb4367-d6a3-4882-b9a2-0f96ca2bb710)

If it does not provide a prompt you can access the Sign-In Page by going to `File` -> `Sign-In Page` in the application window menu bar.

To add a new server:

1. Click on the `Add new server` button<br>
2. Populate the form with details provided from the server installation or your Polarity Administrator.
   * Server URL
   * Username
   * Password<br>
3. Click `Sign-in` once you have completed the sections above.

{% hint style="info" %}
Click on Advanced Options to configure Port and Proxy settings.
{% endhint %}

## Determining Connection Status

If you have Polarity pinned to the system tray or the macOS menu bar, the Polarity icon will change appearance depending on Polarity's status.&#x20;

Below are examples of the different icon states that you will encounter and their meanings.

**1) Green, hollowed out Polarity icon** - On-Demand Only Mode Enabled

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCAAXaadP8o1ERJ4Z4C%2F-MDGX3bs_webyIY6EET8%2F-MDGcDKM4zZJhEj7ef97%2Ficon_ondemand_only.png?alt=media\&token=f2f4bd6a-8103-4d44-99a5-700653beaa6a)

**2) Solid green Polarity icon** - Stream and/or Highlight Mode Enabled

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCAAXaadP8o1ERJ4Z4C%2F-MDGX3bs_webyIY6EET8%2F-MDGcHA4GzajPBQWBZEb%2Ficon_stream_and_or_highlight_enabled.png?alt=media\&token=c86cbfc5-87ed-4329-aace-a2d7488c7acb)

**3) Orange Polarity icon with two arrows in the center** - Not Connected to Server, Attempting to automatically Restore Connection

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCAAXaadP8o1ERJ4Z4C%2F-MDGX3bs_webyIY6EET8%2F-MDGc228Vcl66L7kdM3c%2Ficon_not_connected.png?alt=media\&token=f69fcc30-806b-4e0a-b0d5-7897a1eb238e)

**4) Red Polarity icon with red horizontal line through it** - Not Connected to Server, Cannot Automatically Restore Connection

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCAAXaadP8o1ERJ4Z4C%2F-MDGX3bs_webyIY6EET8%2F-MDGgtJFLxYQ4a1yiiPh%2Ficon_not_connected_cannot_reconnect.png?alt=media\&token=4050cc01-98f1-4457-ad53-3a3b6a1ece17)

You can also tell if you are having connection issues by opening the Polarity client and looking at the connection status icon in the bottom right corner of the Polarity configuration window.&#x20;

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FL5P2Kz3P4RFpIjdHG6UU%2FConnected_status.png?alt=media\&token=fd117456-4a75-43e2-ad41-bc785e0b966c)

**1) Grey icon** - Polarity Not Connected to Server

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCAAXaadP8o1ERJ4Z4C%2F-MDGX3bs_webyIY6EET8%2F-MDGaQsojq60LGiGE2Kz%2Ficon_configwindow_disconnected.png?alt=media\&token=d846a5cb-f9f8-465c-87f1-2756b47a4265)

**2) Green icon** - Polarity Connected to Server

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCAAXaadP8o1ERJ4Z4C%2F-MDGX3bs_webyIY6EET8%2F-MDGaa22aH4h52dwRbQb%2Ficon_configwindow_connected.png?alt=media\&token=83c9eac1-68fc-417d-894d-2c49994ce832)

## Start on Boot

After the first login to Polarity, you can set whether or not you want Polarity to start up on boot.

![](https://2418141914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCAAXaadP8o1ERJ4Z4C%2Fuploads%2FYj13clgkYLfhnHdO49jN%2Fstart_on_boot.png?alt=media\&token=770f8f7b-6309-4511-a799-5d4edf8a7fcd)

To Access the `Start on Boot` option navigate to the Polarity Menu.

{% tabs %}
{% tab title="macOS" %}

1. Navigate to `Start on Boot` by opening Polarity,
2. At the top of the macOS application file bar you will see the Polarity Menu.&#x20;
3. Click where it says `File` and then check `Start on Boot`.
   {% endtab %}

{% tab title="WIndows" %}

1. Navigate to `Start on Boot` by opening Polarity,
2. At the top of the application, find the Polarity file menu.
3. &#x20;Click where it says `File` and then check `Start on Boot`.
   {% endtab %}

{% tab title="Linux" %}

1. Navigate to Start on Boot by opening Polarity,&#x20;
2. At the top of the Linux menu bar you will see the Polarity Menu.&#x20;
3. Click on where it says `File` and then select `Start on Boot`.
   {% endtab %}
   {% endtabs %}

##

{% hint style="info" %}
Start on Boot is enabled by default
{% endhint %}

####
