Bug 1397207

Summary: Missing instructions for TigerVNC
Product: [Fedora] Fedora Reporter: Stephen Wadeley <swadeley>
Component: tigervncAssignee: Jan Grulich <jgrulich>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 25CC: bphinz, docs-qa, jgrulich, lzap, swadeley, twaugh
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: tigervnc-1.7.0-4.fc25 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: 1383089 Environment:
Last Closed: 2016-11-28 04:01:18 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Attachments:
Description Flags
Proposed change for vncserver service file none

Description Stephen Wadeley 2016-11-21 22:12:02 UTC
+++ This bug was initially created as a clone of Bug #1383089 +++

Hi guys!

It looks like

https://docs.fedoraproject.org/en-US/Fedora/24/html/System_Administrators_Guide/ch-TigerVNC.html

is a bit out of date. The service changed the way it starts, it now requires two changes:

User=MY_USER
PIDFile=/home/MY_USER/.vnc/%H%i.pid

I also suggest to add Troubleshooting section:

A) When VNC server does not start, check status of the service (systemctl status), system journal or SELinux denials.

(I recently filed a bug 1383088 for Fedora 24 on that topic)

B) TigerVNC enforces encryption when using password authentication. Some clients (outdated or MacOS built-in Shared Screen application) won't be able to connect.

--- Additional comment from Stephen Wadeley on 2016-10-10 17:23:55 EDT ---

Thank you for raising this bug.

 I will test and update accordingly.

--- Additional comment from Stephen Wadeley on 2016-11-21 17:04:50 EST ---

(In reply to Lukas Zapletal from comment #0)
> Hi guys!
> 
> It looks like
> 
> https://docs.fedoraproject.org/en-US/Fedora/24/html/
> System_Administrators_Guide/ch-TigerVNC.html
> 
> is a bit out of date. The service changed the way it starts, it now requires
> two changes:
> 
> User=MY_USER
> PIDFile=/home/MY_USER/.vnc/%H%i.pid
> 
and the instructions in the file [1] do not tell you to replace <user> with a valid user. I can clone this bug for that.

[1] /lib/systemd/system/vncserver@.service

= = = = = =  =

Hello

In file source vncserver service unit file {[1] above} I see:

# 2. Edit User=
#   ("User=foo")

then later the lines:

[Service]
Type=forking
User=   <---- We edit by adding user here

# Clean any existing files in /tmp/.X11-unix environment
ExecStartPre=-/usr/bin/vncserver -kill %i
ExecStart=/usr/bin/vncserver %i
PIDFile=/home/<USER>/.vnc/%H%i.pid

But line above is not mentioned. <USER> must also be replaced by the same "user"

Comment 1 Jan Grulich 2016-11-22 06:52:31 UTC
Created attachment 1222589 [details]
Proposed change for vncserver service file

Would this be ok for you guys? Or rather, does this make sense?

Comment 2 Stephen Wadeley 2016-11-22 09:22:34 UTC
Hello


That looks OK to me.

Thank you

Comment 3 Fedora Update System 2016-11-23 13:42:48 UTC
tigervnc-1.7.0-4.fc24 has been submitted as an update to Fedora 24. https://bodhi.fedoraproject.org/updates/FEDORA-2016-4651224a0b

Comment 4 Fedora Update System 2016-11-23 13:42:58 UTC
tigervnc-1.7.0-4.fc25 has been submitted as an update to Fedora 25. https://bodhi.fedoraproject.org/updates/FEDORA-2016-6f37fc215d

Comment 5 Fedora Update System 2016-11-25 09:38:58 UTC
tigervnc-1.7.0-4.fc24 has been pushed to the Fedora 24 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2016-4651224a0b

Comment 6 Fedora Update System 2016-11-25 09:41:55 UTC
tigervnc-1.7.0-4.fc25 has been pushed to the Fedora 25 testing repository. If problems still persist, please make note of it in this bug report.
See https://fedoraproject.org/wiki/QA:Updates_Testing for
instructions on how to install test updates.
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2016-6f37fc215d

Comment 7 Fedora Update System 2016-11-28 04:01:18 UTC
tigervnc-1.7.0-4.fc25 has been pushed to the Fedora 25 stable repository. If problems still persist, please make note of it in this bug report.