Skip to content

Commit

Permalink
Merge pull request #877 from Concordium/collector-tls
Browse files Browse the repository at this point in the history
Note for collector when using TLS
  • Loading branch information
dg-concordium authored Oct 10, 2023
2 parents daca6c4 + 58e05f9 commit e7ab2ef
Show file tree
Hide file tree
Showing 5 changed files with 17 additions and 2 deletions.
7 changes: 5 additions & 2 deletions source/mainnet/net/guides/run-node-macos.rst
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ Install/upgrade and run a node
.. dropdown:: Mainnet

.. Note::
See :ref:`change-node-settings` for information about how to change the service configuration settings. See :ref:`configure-baker-macos` for information about how to set the location of baker credentials.
See :ref:`change-node-settings` for information about how to change the service configuration settings. See :ref:`baker-macos` for information about how to set the location of baker credentials.

#. Go to :ref:`Downloads<node-downloads>`, and download the latest macOS installer package (.pkg file).

Expand Down Expand Up @@ -107,7 +107,7 @@ Install/upgrade and run a node
.. dropdown:: Testnet

.. Note::
See :ref:`change-node-settings` for information about how to change the service configuration settings. See :ref:`configure-baker-macos` for information about how to set the location of baker credentials.
See :ref:`change-node-settings` for information about how to change the service configuration settings. See :ref:`baker-macos` for information about how to set the location of baker credentials.

#. Go to :ref:`Downloads<testnet-node-downloads>`, and download the latest macOS installer package (.pkg file).

Expand Down Expand Up @@ -286,6 +286,9 @@ Since the GRPC V2 port is different than the GRPC V1 port, you need to change it
.. _configure-baker-macos:

.. Note::
If the node is `configured with TLS <https://github.com/Concordium/concordium-node/blob/main/docs/grpc2.md#grpc-api-v2>`_, then `CONCORDIUM_NODE_COLLECTOR_GRPC_HOST` must be configured such that it uses the domain of the certificate.

Configure a node as a baker
===========================

Expand Down
3 changes: 3 additions & 0 deletions source/mainnet/net/guides/run-node-ubuntu.rst
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,9 @@ This will open your overrides in your default editor. Below is an example for th
.. _upgrade-node-Ubuntu:

.. Note::
If the node is `configured with TLS <https://github.com/Concordium/concordium-node/blob/main/docs/grpc2.md#grpc-api-v2>`_, then `CONCORDIUM_NODE_COLLECTOR_GRPC_HOST` must be configured such that it uses the domain of the certificate, for example, ``Environment=CONCORDIUM_NODE_COLLECTOR_GRPC_HOST=https://example.concordium-node.io:20000``.

Upgrade version
===============

Expand Down
3 changes: 3 additions & 0 deletions source/mainnet/net/guides/run-node-windows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -246,6 +246,9 @@ Node collector configuration

Since version 5.3.2 of the node, the collector uses the GRPC V2 interface. Therefore, in order to run the collector, it is required that the node which the collector connects to has the GRPC V2 interface enabled. For information about how to do this, see :ref:`the note at the top of this topic<install-upgrade-node-windows>`.

.. Note::
If the node is `configured with TLS <https://github.com/Concordium/concordium-node/blob/main/docs/grpc2.md#grpc-api-v2>`_, then `CONCORDIUM_NODE_COLLECTOR_GRPC_HOST` must be configured such that it uses the domain of the certificate.

Baking on a Windows node
========================

Expand Down
3 changes: 3 additions & 0 deletions source/mainnet/net/guides/run-node.rst
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ The node requires a database which must be stored on the host system so that it
enabled, make sure to edit your configuration, adding ``CONCORDIUM_NODE_GRPC2_LISTEN_PORT``
and ``CONCORDIUM_NODE_GRPC2_LISTEN_ADDRESS`` as in the sample configurations.

.. Note::
If the node is `configured with TLS <https://github.com/Concordium/concordium-node/blob/main/docs/grpc2.md#grpc-api-v2>`_, then `CONCORDIUM_NODE_COLLECTOR_GRPC_HOST` must be configured such that it uses the domain of the certificate, for example, ``CONCORDIUM_NODE_COLLECTOR_GRPC_HOST=https://example.concordium-node.io:20000``.

.. Note::

When upgrading, you can only upgrade one minor version at a time, or from the last release of major version X to major version X+1. You cannot skip versions. For patches, you can skip versions e.g. X.X.0 to X.X.3, or `X.1.1` to `X.2.3`.
Expand Down
3 changes: 3 additions & 0 deletions source/mainnet/net/nodes/run-node-ubuntu.rst
Original file line number Diff line number Diff line change
Expand Up @@ -132,6 +132,9 @@ This will open your overrides in your default editor. Below is an example for th
[Service]
Environment=CONCORDIUM_NODE_COLLECTOR_GRPC_HOST=http://localhost:20001
.. Note::
If the node is `configured with TLS <https://github.com/Concordium/concordium-node/blob/main/docs/grpc2.md#grpc-api-v2>`_, then `CONCORDIUM_NODE_COLLECTOR_GRPC_HOST` must be configured such that it uses the domain of the certificate, for example, ``Environment=CONCORDIUM_NODE_COLLECTOR_GRPC_HOST=https://example.concordium-node.io:20000``.

.. _upgrade-node-Ubuntu-testnet:

Upgrade version
Expand Down

0 comments on commit e7ab2ef

Please sign in to comment.