# Establish LightNet Cluster

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2FtagpnmOKXt79avrIVnIx%2Fimage.png?alt=media&#x26;token=50266179-b18b-4ccc-bb12-64ac76036015" alt=""><figcaption></figcaption></figure>

When the other machines are found, your LightNet Management window will most likely look similar to this.

{% hint style="info" %}
**Good to know**: Establishing a cluster succesfully means that all 3 communication channels (LightNet, LightSync and Asset transfer) are working and that all servers have the the same project file open.
{% endhint %}

In order to Establish cluster there are just a few steps that you need to do:

1. Invite the machines into Primary's cluster
2. Assign correct roles to them
3. Establish the cluster

## Inviting a machine into a cluster

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2F5aBzEhutVrvddDfwLOsI%2FinvitingAMachineIntoACluster.gif?alt=media&#x26;token=3c54b843-23d0-450d-aef7-12f062e9cb2c" alt=""><figcaption></figcaption></figure>

The quickest way to invite a machine into Primary's cluster is simply to drag it into it. This will also automatically assign it a Secondary role.

## Assigning a role to every machine

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2FNNdqSKxuGbW32YWmJC9m%2Fimage.png?alt=media&#x26;token=9a2ec694-eee7-4306-a72a-6995f248442a" alt=""><figcaption></figcaption></figure>

Use this dropdown to assign a role to a particular machine.

{% hint style="info" %}
**Good to know**: assigning Primary role to a machine in your cluster will automatically remove this machine from your cluster. There can only be one Primary in a cluster.
{% endhint %}

## Establishing a Cluster

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2FbWx3rcGdWAWy4UGy3PDU%2FestablishingCluster.gif?alt=media&#x26;token=ab801994-e731-4ce9-b7e6-3063128ab1da" alt=""><figcaption></figcaption></figure>

The quickest way to establish a cluster is to simply click on the Establish Cluster button. What this will do in the background is:

1. Save the project file on the Primary
2. Establish a LightNet connection with all the machines in the cluster
3. Check if all the machines have the same version of LightAct.
4. Check if Primary has access to the LightNetProjects folders on all the machines
5. Transfer project file to all the machines
6. Open the project file on all the machines
7. Establish LightSync
8. Check if Project files match on all the machines

{% hint style="warning" %}
**I**f any of the above steps fails, your cluster won't work as intended.
{% endhint %}

{% hint style="info" %}
**Good to know:** the most common failed step i number 4 (Access to LightNetProjects folders).
{% endhint %}

### LightNet connection

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2FOBhV1EKQdszE79SxNVPX%2Fimage.png?alt=media&#x26;token=b9c86e3f-cfc2-495c-ae13-7e7b10407ff5" alt=""><figcaption></figcaption></figure>

When you have a server established, you'll see these green circular lights blinking every now and then. These lights blink whenever there is LightNet message (real-time updates across the cluster).

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2Fz14YVOCtk1e3H0opXe75%2Freal-timeUpdatesLightNet.gif?alt=media&#x26;token=56cd0086-a569-4ba1-8846-8a0d6e488812" alt=""><figcaption></figcaption></figure>

If you move drag an object, for example, these lights will blink much faster.

<figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2FTWPFytjohKjpbulMx4MW%2Fimage.png?alt=media&#x26;token=b38bbef8-f89d-494c-a9c3-8201ba156aa9" alt=""><figcaption></figcaption></figure>

What also affect the frequency of LightNet messages are **Real-time edit updates** and **Heartbeat frequency** dropdowns in **Project settings** window in **LightNet** tab.

#### Manually managing LightNet connection

<div align="left"><figure><img src="https://3312042618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2FvKBYquxMrp5YCCWcSFru%2Fimage.png?alt=media&#x26;token=ad9ec599-bb65-4c42-baf4-2a8ce0fc222b" alt=""><figcaption></figcaption></figure></div>

It is possible to manually manage LightNet connection with these 2 buttons:

* **Access check**: checks if Primary has write access to the LightNetProjects folder on this machine
* **Connect/Disconnect**: manages LightNet connection with this machine.

{% hint style="warning" %}
If LightNet connection breaks for any reason, it might be worthwhile to analyse why it happened in the first place.
{% endhint %}

## Multi-user

LightAct allows users to modify project on Primary, all Secondaries and all Editor machines. Everything that you change on any of these machines should be propagated first to the Primary and then to the entire Cluster in real-time.

{% hint style="warning" %}
Even though we don't prohibit changes made in Secondary servers, we **recommend** the users use only Primary and Editor machines.&#x20;

This is also the only workflow that we officially support.
{% endhint %}
