Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Note for collector when using TLS #877

Merged
merged 10 commits into from
Oct 10, 2023
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
Loading