You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
msgid"{% include breadcrumb.html root=\"More\" branch1=\"Server Administration\" branch1-url=\"Running-a-Server\" %}"
47
46
msgstr""
48
47
49
48
#. type: Title ####
50
49
#:../wiki/en/DNS-SRV-Support.md:12
51
-
#,markdown-text, no-wrap
50
+
#, no-wrap
52
51
msgid"Background - connecting to a Server or Directory"
53
52
msgstr""
54
53
55
54
#. type: Plain text
56
55
#:../wiki/en/DNS-SRV-Support.md:15
57
-
#, markdown-text
58
56
msgid"The default UDP port on which a Jamulus Server or Directory listens is **22124**. Normally, when a Client or a Server is given a plain hostname or an IP address to connect to, such as `198.51.100.46` or `jamulus.example.com`, it will use `22124` as the destination port number."
59
57
msgstr""
60
58
61
59
#. type: Plain text
62
60
#:../wiki/en/DNS-SRV-Support.md:17
63
-
#, markdown-text
64
61
msgid"Since a single Jamulus Server only provides a single \"room\", and a single Jamulus Directory only provides a single \"list\", it is often useful to run multiple Jamulus Server or Directory instances on a single host, sharing one IP address. In order to do this, the instances must each be made to listen on a different UDP port. This is done by specifying the port number on the command line, using `-p NNNNN` or `--port NNNNN`."
65
62
msgstr""
66
63
67
64
#. type: Plain text
68
65
#:../wiki/en/DNS-SRV-Support.md:19
69
-
#, markdown-text
70
66
msgid"If such a Server is registered with a Directory, such as the standard Jamulus Directories, e.g. **Any Genre 1**, the port number in use is automatically detected by the Directory at registration time, and stored in the list which is sent to a Client. The user's Jamulus Client can then connect to the Server in the normal way from the list in the Connect Dialog."
71
67
msgstr""
72
68
73
69
#. type: Plain text
74
70
#:../wiki/en/DNS-SRV-Support.md:21
75
-
#, markdown-text
76
71
msgid"However, a Jamulus instance wanting to connect _directly_ to a Server or Directory by IP or hostname must know the port number to use. This can be specified after the IP address or hostname, such as `198.51.100.46:22123` or `jamulus.example.com:22120`. Such port numbers are not very memorable, so it's often necessary to look them up! The solution is for the server operator to publish the port number using an SRV record in DNS."
77
72
msgstr""
78
73
79
74
#. type: Title ####
80
75
#:../wiki/en/DNS-SRV-Support.md:22
81
-
#,markdown-text, no-wrap
76
+
#, no-wrap
82
77
msgid"Using DNS SRV to publish port numbers"
83
78
msgstr""
84
79
85
80
#. type: Plain text
86
81
#:../wiki/en/DNS-SRV-Support.md:25
87
-
#, markdown-text
88
82
msgid"A [DNS SRV record (\"service\" record)](https://en.wikipedia.org/wiki/SRV_record) is a special DNS record that can be used to publish the port number and hostname that should be used to connect to a particular service."
89
83
msgstr""
90
84
91
85
#. type: Plain text
92
86
#:../wiki/en/DNS-SRV-Support.md:27
93
-
#, markdown-text
94
87
msgid"Recent versions of Jamulus Clients and Servers are able to make use of such records. Depending on the version of Jamulus (see below), if it finds a DNS SRV record associated with the domain name given, it will try to connect to the endpoint host and port listed in the SRV record. The user does not have to specify the port number explicitly."
95
88
msgstr""
96
89
97
90
#. type: Plain text
98
91
#:../wiki/en/DNS-SRV-Support.md:29
99
-
#, markdown-text
100
92
msgid"If no SRV records are found on the DNS server for the hostname given, Jamulus will attempt to connect to the Directory or Server address on the default port number `22124`."
101
93
msgstr""
102
94
103
95
#. type: Title ####
104
96
#:../wiki/en/DNS-SRV-Support.md:30
105
-
#,markdown-text, no-wrap
97
+
#, no-wrap
106
98
msgid"Jamulus versions supporting SRV"
107
99
msgstr""
108
100
109
101
#. type: Plain text
110
102
#:../wiki/en/DNS-SRV-Support.md:33
111
-
#, markdown-text
112
103
msgid"Clients with version **3.10.0** or later support SRV records for a hostname given in the following contexts:"
113
104
msgstr""
114
105
115
106
#. type: Bullet: '* '
116
107
#:../wiki/en/DNS-SRV-Support.md:36
117
-
#, markdown-text
118
108
msgid"In the Connect dialog as \"Server Address\"."
119
109
msgstr""
120
110
121
111
#. type: Bullet: '* '
122
112
#:../wiki/en/DNS-SRV-Support.md:36
123
-
#, markdown-text
124
113
msgid"On the command line with `-c`, to specify immediate direct connection to a Server."
125
114
msgstr""
126
115
127
116
#. type: Plain text
128
117
#:../wiki/en/DNS-SRV-Support.md:38
129
-
#, markdown-text
130
118
msgid"In addition to the above, both Clients and Servers with version **3.12.0** or later also support SRV records for a hostname given to specify a Directory, in the following contexts:"
131
119
msgstr""
132
120
133
121
#. type: Bullet: '* '
134
122
#:../wiki/en/DNS-SRV-Support.md:42
135
-
#, markdown-text
136
123
msgid"Server: `-e` or `--directoryaddress` option on the command line."
137
124
msgstr""
138
125
139
126
#. type: Bullet: '* '
140
127
#:../wiki/en/DNS-SRV-Support.md:42
141
-
#, markdown-text
142
128
msgid"Server: (GUI) in the \"Custom Directory address\" setting under \"Options\"."
143
129
msgstr""
144
130
145
131
#. type: Bullet: '* '
146
132
#:../wiki/en/DNS-SRV-Support.md:42
147
-
#, markdown-text
148
133
msgid"Client: (GUI) in the list of custom Directories under \"Advanced Setup\" in \"Settings\"."
149
134
msgstr""
150
135
151
136
#. type: Title ####
152
137
#:../wiki/en/DNS-SRV-Support.md:43
153
-
#,markdown-text, no-wrap
138
+
#, no-wrap
154
139
msgid"Creating DNS SRV records"
155
140
msgstr""
156
141
157
142
#. type: Plain text
158
143
#:../wiki/en/DNS-SRV-Support.md:46
159
-
#, markdown-text
160
144
msgid"SRV records are created by the administrator of the DNS domain being used to host the Jamulus Server. The SRV records are added through the administration portal (or API if available) of the domain's DNS hosting service. The format of the SRV record entry can vary by DNS hosting service but will generally look something like this:"
161
145
msgstr""
162
146
@@ -168,13 +152,11 @@ msgstr ""
168
152
169
153
#. type: Plain text
170
154
#:../wiki/en/DNS-SRV-Support.md:52
171
-
#, markdown-text
172
155
msgid"Note that the `name` and `target` hostnames may either be the same or different. `name` is the hostname the user will use without a port number for SRV lookup, and `target` is the hostname the Jamulus will use together with the discovered port number in order to connect to the Jamulus Server or Directory."
173
156
msgstr""
174
157
175
158
#. type: Plain text
176
159
#:../wiki/en/DNS-SRV-Support.md:54
177
-
#, markdown-text
178
160
msgid"In the case of Jamulus, the `service` must be `jamulus` and the `proto` must be `udp`, so the record will look like this (for a port number of `12345`):"
179
161
msgstr""
180
162
@@ -186,31 +168,28 @@ msgstr ""
186
168
187
169
#. type: Plain text
188
170
#:../wiki/en/DNS-SRV-Support.md:60
189
-
#, markdown-text
190
171
msgid"This technique allows you to host many Jamulus Servers or Directories at different ports on a single host with different hostnames by giving each its own SRV record. This avoids having to give your users the port number, which may be less memorable than a name. In the above example, the user will specify `myserver.example.com` and Jamulus will then connect to `myhost.example.com:12345`."
191
172
msgstr""
192
173
193
174
#. type: Plain text
194
175
#:../wiki/en/DNS-SRV-Support.md:62
195
-
#, markdown-text
196
176
msgid"See the documentation of your DNS provider for instructions on creating an SRV record."
197
177
msgstr""
198
178
199
179
#. type: Title ####
200
180
#:../wiki/en/DNS-SRV-Support.md:63
201
-
#,markdown-text, no-wrap
181
+
#, no-wrap
202
182
msgid"Example - SRV records for the main Jamulus public Directories"
203
183
msgstr""
204
184
205
185
#. type: Plain text
206
186
#:../wiki/en/DNS-SRV-Support.md:66
207
-
#, markdown-text
208
187
msgid"In the `jamulus.io` domain, SRV records have been created to specify the correct port for each of the standard public Directories:"
209
188
msgstr""
210
189
211
190
#. type: Plain text
212
191
#:../wiki/en/DNS-SRV-Support.md:76
213
-
#,markdown-text, no-wrap
192
+
#, no-wrap
214
193
msgid""
215
194
"| DIRECTORY | DNS SRV RECORD | JAMULUS SERVER |\n"
msgid"This means that a Jamulus Server of version **3.12.0** or later can just give the hostname of the Directory to the `-e` or `--directoryaddress` option, without needing to find and specify the port number."
230
208
msgstr""
231
209
232
210
#. type: Plain text
233
211
#:../wiki/en/DNS-SRV-Support.md:79
234
-
#, markdown-text
235
212
msgid"A server administrator can use the same technique to publish an SRV record for his own Server or Directory."
0 commit comments