Kaynağa Gözat

Various improvements to quick-install document

- removed paragraph about old Debian Wheezy, the link is broken, and Wheezy doesn't even get security updates anymore, so seems unlikely anyone would do a new install with it.
- clarified that Let's Encrypt script uses only the HTTP challenge.
- added links to a few things that newbies might want to look up (nginx, apache, jetty, SIP, FQDN, Let's Encrypt, etc.
- added some basic debugging starting points, based on my experience
- some minor grammatical tweaks
- other minor tweaks
master
Sean McBride 5 yıl önce
ebeveyn
işleme
e5d87e66bf
1 değiştirilmiş dosya ile 27 ekleme ve 11 silme
  1. 27
    11
      doc/quick-install.md

+ 27
- 11
doc/quick-install.md Dosyayı Görüntüle

@@ -2,8 +2,6 @@
2 2
 
3 3
 This document describes the required steps for a quick Jitsi Meet installation on a Debian based GNU/Linux system. Debian 8 (Jessie) or later, and Ubuntu 14.04 or later are supported out-of-the-box.
4 4
 
5
-Debian Wheezy and other older systems may require additional things to be done. Specifically for Wheezy, [libc needs to be updated](http://lists.jitsi.org/pipermail/users/2015-September/010064.html).
6
-
7 5
 Also note that a recent default Ubuntu installation has only the `main` repository enabled, and Jitsi Meet needs packages from `universe`. Check your `/etc/apt/sources.list` file, and if `universe` is not present refer to [Ubuntu's documentation](https://help.ubuntu.com/community/Repositories/Ubuntu) on how to enable it. (Usually it amounts to copying the `main` lines and changing to `universe`.)
8 6
 
9 7
 N.B.:
@@ -36,37 +34,41 @@ wget -qO -  https://download.jitsi.org/jitsi-key.gpg.key | apt-key add -
36 34
 apt-get update
37 35
 ```
38 36
 
39
-(If you get an error:
37
+If you get an error:
40 38
 E: The method driver /usr/lib/apt/methods/https could not be found.
41 39
 run:
42 40
 ```sh
43 41
 apt-get install apt-transport-https
44 42
 ```
45
-)
46 43
 
47 44
 ### Install Jitsi Meet
48 45
 
49
-Note: Something to consider before installation is how you're planning to serve Jitsi Meet. The installer will check if Nginx or Apache is present (with this order) and configure a virtualhost within the web server it finds to serve Jitsi Meet. If none of the above is found it then configures itself to be served via jetty. So if for example you are planning on deploying Jitsi Meet with a web server, you have to make sure to install the server **before** installing jitsi-meet.
46
+Note: Something to consider before installation is how you're planning to serve Jitsi Meet. The installer will check if [Nginx](https://nginx.org/) or [Apache](https://httpd.apache.org/) is present (in that order) and configure a virtualhost within the web server it finds to serve Jitsi Meet. If none of the above is found it then configures itself to be served via [Jetty](https://www.eclipse.org/jetty/). So if for example you are planning on deploying Jitsi Meet with a web server, you have to make sure to install the server **before** installing jitsi-meet.
50 47
 
51 48
 ```sh
52 49
 apt-get -y install jitsi-meet
53 50
 ```
54 51
 
55
-During the installation, you will be asked to enter the hostname of the Jitsi Meet instance. If you have a FQDN hostname for the instance already set up in DNS, enter it there. If you don't have a resolvable hostname, you can enter the IP address of the machine (if it is static or doesn't change).
52
+During the installation, you will be asked to enter the hostname of the Jitsi Meet instance. If you have a [FQDN](https://en.wikipedia.org/wiki/Fully_qualified_domain_name) for the instance already set up in DNS, enter it there. If you don't have a resolvable hostname, you can enter the IP address of the machine (if it is static or doesn't change).
56 53
 
57 54
 This hostname (or IP address) will be used for virtualhost configuration inside the Jitsi Meet and also, you and your correspondents will be using it to access the web conferences.
58 55
 
59 56
 ### Generate a Let's Encrypt certificate
60 57
 
61
-Simply run the following in your shell
58
+In order to have encrypted communications, you need a [TLS certificate](https://en.wikipedia.org/wiki/Transport_Layer_Security). The easiest way is to use [Let's Encrypt](https://letsencrypt.org/).
59
+
60
+Simply run the following in your shell:
62 61
 
63 62
 ```sh
64 63
 /usr/share/jitsi-meet/scripts/install-letsencrypt-cert.sh
65 64
 ```
66 65
 
66
+Note that this script uses the [HTTP-01 challenge type](https://letsencrypt.org/docs/challenge-types/) and thus your instance needs to be accessible from the public internet. If you want to use a different challenge type, don't use this script and instead choose ___I want to use my own certificate___ during jitsi-meet installation.
67
+
68
+
67 69
 #### Advanced configuration
68
-If installation is on a machine [behind NAT](https://github.com/jitsi/jitsi-meet/blob/master/doc/faq.md) further configuration of jitsi-videobridge is needed in order for it to be accessible.
69
-Provided that all required ports are routed (forwarded) to the machine that it runs on. By default these ports are (TCP/443 or TCP/4443 and UDP 10000).
70
+If the installation is on a machine [behind NAT](https://github.com/jitsi/jitsi-meet/blob/master/doc/faq.md) further configuration of jitsi-videobridge is needed in order for it to be accessible from outside.
71
+Provided that all required ports are routed (forwarded) to the machine that it runs on. By default these ports are (TCP/443 or TCP/4443 and UDP/10000).
70 72
 The following extra lines need to be added the file `/etc/jitsi/videobridge/sip-communicator.properties`:
71 73
 ```
72 74
 org.ice4j.ice.harvest.NAT_HARVESTER_LOCAL_ADDRESS=<Local.IP.Address>
@@ -90,7 +92,7 @@ By default, anyone who has access to your jitsi instance will be able to start a
90 92
 
91 93
 Launch a web browser (Chrome, Chromium or latest Opera) and enter in the URL bar the hostname (or IP address) you used in the previous step.
92 94
 
93
-Confirm that you trust the self-signed certificate of the newly installed Jitsi Meet.
95
+If you used a self-signed certificate (as opposed to using Let's Encrypt), your web browser will ask you to confirm that you trust the certificate.
94 96
 
95 97
 Enjoy!
96 98
 
@@ -98,6 +100,8 @@ Enjoy!
98 100
 
99 101
 ### Install Jigasi
100 102
 
103
+Jigasi is a server-side application acting as a gateway to Jitsi Meet conferences. It allows regular [SIP](https://en.wikipedia.org/wiki/Session_Initiation_Protocol) clients to join meetings and provides transcription capabilities.
104
+
101 105
 ```sh
102 106
 apt-get -y install jigasi
103 107
 ```
@@ -129,7 +133,7 @@ Sometimes the following packages will fail to uninstall properly:
129 133
 
130 134
 When this happens, just run the uninstall command a second time and it should be ok.
131 135
 
132
-The reason for failure is that sometimes, the uninstall script is faster than the process that stops the daemons. The second run of the uninstall command fixes this, as by then the jigasi or jvb daemons are already stopped.
136
+The reason for the failure is that sometimes the uninstall script is faster than the process that stops the daemons. The second run of the uninstall command fixes this, as by then the jigasi or jitsi-videobridge daemons are already stopped.
133 137
 
134 138
 #### Systemd details
135 139
 To reload the systemd changes on a running system execute `systemctl daemon-reload` and `service jitsi-videobridge restart`.
@@ -139,3 +143,15 @@ To check the files and process part execute ```cat /proc/`cat /var/run/jitsi-vid
139 143
 Max processes             65000                65000                processes
140 144
 Max open files            65000                65000                files
141 145
 ```
146
+
147
+## Debugging problems
148
+
149
+If you run into problems, one thing to try is using a different web browser. Some versions of some browsers are known to have issues with Jitsi Meet. You can also visit https://test.webrtc.org to test your browser's [WebRTC](https://en.wikipedia.org/wiki/WebRTC) support.
150
+
151
+Another place to look is the various log files:
152
+
153
+```
154
+/var/log/jitsi/jvb.log
155
+/var/log/jitsi/jicofo.log
156
+/var/log/prosody/prosody.log
157
+```

Loading…
İptal
Kaydet