
Ubuntu 22.04
============

.. _installation#ubuntu:

.. program:: jetstream server

.. note:: To install JetStream, you will need to either be logged in as ``root`` or be an administrative user using ``sudo``. The examples below use ``sudo``.

JetStream will install systemd service units for ``jetstream-server`` and ``jetstream-relay`` services, with :file:`/etc/jetstream-server.rsp` and :file:`/etc/jetstream-relay.rsp` configuration files respectively. The server service is enabled by default.


New Installation
----------------

To install JetStream on Ubuntu, run the following:

.. code-block:: shell-session

  # sudo dpkg -i go-jetstream_<version>.deb

Your server should now be running.


Update Existing Installation
----------------------------

To update JetStream on Linux, run:

.. code-block:: shell-session

   # sudo dpkg -i go-jetstream_<version>.deb

If you have made modifications to system configuration files, such :file:`/etc/jetstream-server.rsp`, you may be prompted to overwrite the file with a new version. Say can say "N" to keep your current configuration, and then refer to :file:`/etc/jetstream-server.rsp.dist` to see which changes were made to the default configuration.


Uninstall
---------

To uninstall JetStream:

.. code-block:: shell-session

   # sudo dpkg -P go-jetstream


Check Service
-------------

You can check if the JetStream service is running by running the :command:`systemctl status` command. Under normal circumstances, the command should report that the process is ``active(running)`` under the ``Active`` heading. For example:

.. code-block:: shell-session

   # systemctl status jetstream-server
   ● jetstream-server.service - Go:JetStream server service
      Loaded: loaded (/lib/systemd/system/jetstream-server.service; enabled; vendor preset: enabled)
      Active: active (running) since Thu 2019-10-03 15:23:37 PDT; 1min 41s ago
    Main PID: 681 (jetstream)
       Tasks: 26 (limit: 2314)
      CGroup: /system.slice/jetstream-server.service
              ├─ 681 /usr/local/bin/jetstream server @/etc/jetstream-server.rsp
              └─1172 /usr/local/bin/jetstream server @/etc/jetstream-server.rsp


Check Server
------------

You can check that the server is active by making a simple API call on the command-line.

.. code-block:: shell-session

   # /usr/local/bin/jetstream api --no-auth getServerInfo
   {
    "allowRemoteControl": true,
    "apiControlPort": 8886,
    ...
    "license": {
      "expiry": "2020-10-01 (365 days from now including today)",
      "valid": true
    },
    ...
    "version": "2.0.0"
   }


Active Directory
----------------

If your system is integrated with Active Directory, you may need to enable JetStream authentication in sssd. See :ref:`Active Directory Integration <troubleshooting#active-directory>`.


Firewalls
---------

There may be internal or external firewalls preventing connections. See :doc:`/setup/firewalls` for tips on firewall configuration.


.. seealso::
  - :doc:`Interact with the JetStream Server </using_jetstream/interacting_with_jetstream>`
  - :doc:`Configure your JetStream Server license and installation </setup/configuration>`
  - :doc:`Manage the JetStream service </setup/services>`
