Kaynağa Gözat

qdevice man: Document NSS database conversion

This is not needed at least for cert8 -> cert9, but it's still nice to
have it documented. Also document NSS_IGNORE_SYSTEM_POLICY=1 workaround.

Signed-off-by: Jan Friesse <jfriesse@redhat.com>

(cherry picked from corosync-qdevice project commit
 cb9ea58e00d175f672aabb478438ab3b01ffd3f2)
Jan Friesse 7 yıl önce
ebeveyn
işleme
4f2cdfc304
2 değiştirilmiş dosya ile 44 ekleme ve 4 silme
  1. 22 2
      man/corosync-qdevice.8
  2. 22 2
      man/corosync-qnetd.8

+ 22 - 2
man/corosync-qdevice.8

@@ -1,5 +1,5 @@
 .\"/*
 .\"/*
-.\" * Copyright (C) 2016-2017 Red Hat, Inc.
+.\" * Copyright (C) 2016-2018 Red Hat, Inc.
 .\" *
 .\" *
 .\" * All rights reserved.
 .\" * All rights reserved.
 .\" *
 .\" *
@@ -31,7 +31,7 @@
 .\" * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" * THE POSSIBILITY OF SUCH DAMAGE.
 .\" * THE POSSIBILITY OF SUCH DAMAGE.
 .\" */
 .\" */
-.TH COROSYNC-QDEVICE 8 2017-10-17
+.TH COROSYNC-QDEVICE 8 2018-08-09
 .SH NAME
 .SH NAME
 corosync-qdevice \- QDevice daemon
 corosync-qdevice \- QDevice daemon
 .SH SYNOPSIS
 .SH SYNOPSIS
@@ -273,6 +273,26 @@ If TLS is not required just edit corosync.conf file and set
 to
 to
 .IR off .
 .IR off .
 
 
+Depending on configuration of NSS (stored in nss.config file usually in
+/etc/crypto-policies/back-ends/ directory) disabled ciphers or too short keys
+may be rejected. Proper solution is to regenerate NSS databases for both
+.B corosync-qnetd
+and
+.B corosync-qdevice
+daemons. As a quick workaround it's also possible to set environment variable
+.I NSS_IGNORE_SYSTEM_POLICY=1
+before running
+.B corosync-qdevice
+daemon.
+
+When NSS is updated it may also be needed to upgrade database into new format. There is no
+consensus on recommended way, but following command seems to work just fine (if qdevice
+sysconfdir is set to /etc)
+
+.nf
+# certutil -N -d /etc/corosync/qdevice/net/nssdb -f /etc/corosync/qdevice/net/nssdb/pwdfile.txt
+.fi
+
 .SH MODEL NET ALGORITHMS
 .SH MODEL NET ALGORITHMS
 Algorithms are used to change behavior of how
 Algorithms are used to change behavior of how
 .B corosync-qnetd
 .B corosync-qnetd

+ 22 - 2
man/corosync-qnetd.8

@@ -1,5 +1,5 @@
 .\"/*
 .\"/*
-.\" * Copyright (C) 2016 Red Hat, Inc.
+.\" * Copyright (C) 2016-2018 Red Hat, Inc.
 .\" *
 .\" *
 .\" * All rights reserved.
 .\" * All rights reserved.
 .\" *
 .\" *
@@ -31,7 +31,7 @@
 .\" * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
 .\" * THE POSSIBILITY OF SUCH DAMAGE.
 .\" * THE POSSIBILITY OF SUCH DAMAGE.
 .\" */
 .\" */
-.TH COROSYNC-QNETD 8 2016-06-29
+.TH COROSYNC-QNETD 8 2018-08-09
 .SH NAME
 .SH NAME
 corosync-qnetd \- QNet daemon
 corosync-qnetd \- QNet daemon
 .SH SYNOPSIS
 .SH SYNOPSIS
@@ -165,6 +165,26 @@ systemd unit file and add the parameter
 .I off
 .I off
 in the proper place.
 in the proper place.
 
 
+Depending on configuration of NSS (stored in nss.config file usually in
+/etc/crypto-policies/back-ends/ directory) disabled ciphers or too short keys
+may be rejected. Proper solution is to regenerate NSS databases for both
+.B corosync-qnetd
+and
+.B corosync-qdevice
+daemons. As a quick workaround it's also possible to set environment variable
+.I NSS_IGNORE_SYSTEM_POLICY=1
+before running
+.B corosync-qnetd
+daemon.
+
+When NSS is updated it may also be needed to upgrade database into new format. There is no
+consensus on recommended way, but following command seems to work just fine (if qnetd
+sysconfdir is set to /etc)
+
+.nf
+# certutil -N -d /etc/corosync/qnetd/nssdb -f /etc/corosync/qnetd/nssdb/pwdfile.txt
+.fi
+
 .SH ADVANCED SETTINGS
 .SH ADVANCED SETTINGS
 Set by the
 Set by the
 .B -S
 .B -S