###############
Location Editor
###############

.. image:: ../media/images/jetstream-location-editor.png

The *Location Editor* is displayed when :doc:`creating a new Location <location-create>` and when :doc:`editing an existing Location <location-edit>`.

Configuring A Location
========================

Location Name
-------------
Specify a name for your Location. The name can be anything you choose, save for a few restrictions:

- You may not use the name "Local".
- The name may not be empty.
- The name may not start with whitespace.
- The name may not end with whitespace.


Host / IP
---------
Specify the host name or IP address for the Location's JetStream server.

    .. note:: JetStream currently only supports IPv4.

You may create more than one Location that connects to the same JetStream server. There are a few reasons why you may want to do this:

- Each Location may require different authentication. The authentication will govern which files and folders are accessible from the client.


Username / Password
--------------------
If the Location requires a login, specify the username and password here.


API Control Port
----------------
Specify the API control port for the JetStream server. This is the port on which the server listens for connections from the JetStream client.

    .. note:: You'll need to obtain the API control port from the server administrator. By default, JetStream servers use port 8886.


Validate Server Identity
------------------------
Each JetStream server has a security certificate. When :guilabel:`Validate Server Identity` is turned on, connections to the Location will only succeed if the server's certificate is trusted. The trusted certificate for this Location can be set by pressing the :guilabel:`Manage identity...` button. This bring up the :doc:`location-manage-identity` dialog which can be used to either download or manually set a trusted certificate for this Location.

.. note:: When creating a new Location, the server's identity is automatically downloaded in the background and trusted.

.. note:: A server running on the same machine as the Client application, such as when the Host is ``localhost`` or ``127.0.0.1``, does not require a trusted certificate, so :guilabel:`Validate Server Identity` will default to off.


.. _symlink_handling-location-label:

Symbolic Links
--------------
The Symbolic Links dropdown provides a default transfer-level option for symbolic link handling. Available options are:

* Copy contents -- follow the symbolic link, and copy the actual file contents
* Ignore -- Ignore (do not copy) any symbolic links


Administration
--------------
If you have administrator privileges on the JetStream server, you may configure the server by clicking the :guilabel:`Configure server...` button. This bring up the :doc:`location-configure-server` dialog.

Testing Your Connection
=======================

Once you have configured your location, click on :guilabel:`Test Connection` to check if your connection setup works. This will bring up the :doc:`Connection Test<location-test>` dialog, which runs a variety of tests to determine if the server you have configured is accessible and can be used to transfer files.

Connection Console
==================

JetStream provides a command line console for sending JetStream API commands to the server at any given location. This can be useful in certain troubleshooting scenarios. To bring up the :doc:`connection console<location-console>`, click on :guilabel:`Console`.
