/
jmri5.7.7.shtml
236 lines (195 loc) · 10.5 KB
/
jmri5.7.7.shtml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>
JMRI: Release Notes for 5.7.7
</title>
<meta content="Bob Jacobsen" name="author">
<meta name="keywords" content="java model railroad JMRI 5.7.7 decoderpro panelpro loconet lenz nce easydcc dcc nmra">
<!--#include virtual="/Style.shtml" -->
</head>
<body>
<!--#include virtual="/Header.shtml" -->
<div id="mBody">
<!--#include virtual="../download/Sidebar.shtml" -->
<div id="mainContent">
<h1>
Release Notes for JMRI 5.7.7 release
</h1>
<p>Date: MM DDD, 2024</p>
<p>From: release pumpkin</p>
<p>Subject: Test Release 5.7.7 of JMRI/DecoderPro is available for download.</p>
<p><b>This is a draft release note only; the download links do not yet work</b></p>
<h2>Notes:</h2>
<p>This is a test release. Please
<a href="https://groups.io/g/jmriusers">post a note</a>
if you encounter any new or old bugs!
And please back up your JMRI files before installing this, in case you want to go
back to an earlier version.</p>
<p>This is the first in a series of 5.7.* test releases.
It requires Java 11 to work.
(See <a href="http://jmri.org/java">our page on downloading Java 11</a>)
We expect this series to end in the next JMRI 5.8 production release in June 2024.
(See the <a href="https://github.com/JMRI/JMRI/milestones?direction=asc&sort=due_date&state=open"><em>tentative</em> release schedule</a>)
</p>
<!--
<P>We are getting close to the next production release, so we would particularly
appreciate your testing of this release to make sure it works for you. That way,
if you find new problems, we can try to fix them before the production release.</P>
-->
<!--
<p>Some of the changes involved are quite extensive.
They may require a certain amount of experience before they are working well.
Therefore, this test release should be considered experimental.
We would appreciate your feedback on it.</p>
-->
<p><b>
JMRI is now only available under the
<a href="/COPYING">GNU General Public License</a>. For more information, please
see our
<a href="/Copyright.html">copyright and licensing page</a>.</b></p>
<a id="update" name="update"></a>
<h3>Update From Older JMRI Versions</h3>
If you are currently using a version older than JMRI 5.0, please follow these instructions carefully:
<ol>
<li>Is your current version older than <a href="jmri4.12.shtml">JMRI 4.12</a>?
If so, then update to <a href="jmri4.12.shtml">JMRI 4.12</a> first, and ensure everything works correctly: check
start-up, check things you need to be working, and check the JMRI log as well) before doing anything else.
Store your configuration and panel files under a new name and use those from now on.
Then continue with step 2.
<p>
If you are currently using JMRI 4.7.3 or earlier on Linux or macOS (Windows doesn't need this),
then it's <u>very important</u>
that you update to <a href="jmri4.12.shtml">JMRI 4.12</a> and
carrying out the <a href="jmri4.12.shtml#migration">migration process described in the JMRI 4.12 release note</a>
before updating to any later release.
</li>
<li>Is your current version older than <a href="jmri4.20.shtml">JMRI 4.20</a>?
Then update to <a href="jmri4.20.shtml">JMRI 4.20</a> first, and ensure that works correctly (check
start-up, check things you need to be working, and check the JMRI log as well) before doing anything else.
Save your preferences again.
Store your configuration and panel files under a new name, use those from now on, and go on to step 3.</li>
<li>Is your current version older than <a href="jmri4.24.shtml">JMRI 4.24</a>?
Then update to <a href="jmri4.24.shtml">JMRI 4.24</a> first, and ensure that works correctly (check
start-up, check things you need to be working, and check the JMRI log as well) before doing anything else.
Save your preferences again.
Store your configuration and panel files under a new name and use those from now on.</li>
<li>Is your current version older than <a href="jmri5.0.shtml">JMRI 5.0</a>?
Then update to <a href="jmri5.0.shtml">JMRI 5.0</a> first, and ensure that works correctly (check
start-up, check things you need to be working, and check the JMRI log as well) before doing anything else.
Save your preferences again.
Store your configuration and panel files under a new name and use those from now on.</li>
<li>You can then install this release.
</ol>
Following this multi-step order of updating via stable major releases safeguards you against possible migration issues
that can arise from skipping these versions.
<a id="problems" name="problems"></a>
<h3>New problems with this release</h3>
<ul>
<li>None yet</li>
</ul>
<!--
If any of those affect you, please either
wait for
<a href="jmri5.7.7.shtml">JMRI 5.7.7</a>, due out shortly after this one,
or (once there's a fix for the problem) pick up a
<a href="https://builds.jmri.org/jenkins/job/development/job/packages/">JMRI development build installer</a>
from
<a href="https://builds.jmri.org/jenkins/job/development/job/packages/">Jenkins</a>.</p>
-->
<a id="warnings" name="warnings"></a>
<h3>New warnings for this release:</h3>
<ul>
<!-- While this release is in development, the -->
<!-- list of new warnings is kept in -->
<!-- help/en/releasenotes/current-draft-warnings.shtml -->
<!-- in the JMRI/JMRI repository. Please edit -->
<!-- there. Changes to this file won't be merged. -->
<!--#include virtual="/help/en/releasenotes/current-draft-warnings.shtml" -->
<li>None Yet</li>
</ul>
<h3>Older warnings</h3>
See the <a href="jmri5.6.shtml#warnings">JMRI 5.6 release note</a> for more warnings predating the 5.7 development series,
including pointers to various migration issues.
These may be relevant to you if you're updating from an earlier version;
we strongly recommend you update to at least <a href="jmri5.0.shtml">JMRI 5.0</a>
before installing this test release.
See <a href="#update">instructions above</a>.
<ul>
<li><span class="since">Since <a href="jmri4.99.1.shtml">JMRI 4.99.1</a></span>
This test release, and all subsequent ones, require the use of
Java 11 or later. Java 8 is explicitly not supported.
There's more information on this migration on the
<a href="https://www.jmri.org/help/en/html/doc/Technical/TechRoadMap.shtml">JMRI Tech Road Map</a> and
<a href="https://www.jmri.org/help/en/html/doc/Technical/JVMCapabilities.shtml">JVM Capabilities</a> pages.
</li>
<li><span class="since">Since <a href="jmri5.5.3.shtml">JMRI 5.5.3</a></span>
Scripts that output Logging statements with log4jv1.x ( org.apache.log4j ) imports will stop working
from JMRI 5.5.4 and should be updated to use SLF4J logging.
<br>See <a href="https://github.com/JMRI/JMRI/pull/12237/files">here</a> for some examples on how to do this.</li>
<li><span class="since">Since <a href="jmri5.5.4.shtml">JMRI 5.5.4</a></span>
Custom default.lcf Logging Control Files will cease to take effect from JMRI 5.5.4
<br>To create a custom default_lcf.xml in the new Logging Configuration format, see
<a href="https://www.jmri.org/help/en/html/apps/Debug.shtml">JMRI Debugging and Logging</a>
</li>
<li><span class="since">Since <a href="jmri5.5.5.shtml">JMRI 5.5.5</a></span>
XML files with table contents and panels have been changed in JMRI 5.5.5. It's therefore not
possible to load an xml file with tables and panels that has been created with JMRI 5.5.5 or
later with a JMRI version pre 5.5.5.
</li>
<li><span class="since">Since <a href="jmri5.5.5.shtml">JMRI 5.5.5</a></span>
MQTT Connection - Throttle loco address and function placeholders in MQTT topics have changed from
$address and $function to {0} and {1} for consistency with other objects.
</li>
<li><span class="since">Since <a href="jmri5.7.1.shtml">JMRI 5.7.1</a></span>
Several systems have had extensive updates to their serial
support. If you have trouble connecting to your layout hardware
after installing this version, please contact us
<a href="https://groups.io/g/jmriusers">on the JMRIusers list</a>
for assistance.
</li>
</ul>
<a id="download" name="download"></a>
<h2>Download links:</h2>
<!--
<div class="wide">
<ul>
<li>OS X / macOS: <a
href="https://github.com/JMRI/JMRI/releases/download/v5.3.4/JMRI.5.3.4+Rd7c66df2d0.dmg">https://github.com/JMRI/JMRI/releases/download/v5.3.4/JMRI.5.3.4+Rd7c66df2d0.dmg</a><br/>
sha256: 284c20cbd50b40317a558129cca9ac893fe1938ceae8b2de67790fc0ddcf27f5 </li>
<li>Windows: <a
href="https://github.com/JMRI/JMRI/releases/download/v5.3.4/JMRI.5.3.4+Rd7c66df2d0.exe">https://github.com/JMRI/JMRI/releases/download/v5.3.4/JMRI.5.3.4+Rd7c66df2d0.exe</a><br/>
sha256: 4111f6822df4a3b99f916fcb9b688c66a1c121fe011e4ab7c041e6b1359ca7c1</li>
<li>Linux: <a
href="https://github.com/JMRI/JMRI/releases/download/v5.3.4/JMRI.5.3.4+Rd7c66df2d0.tgz">https://github.com/JMRI/JMRI/releases/download/v5.3.4/JMRI.5.3.4+Rd7c66df2d0.tgz</a><br/>
sha256: 3ea4efa27a5ef984737c4e77288de2bf63e0d45cee588150227b9059db56766f</li>
</ul>
</div>
These files are located in the
<a href="https://github.com/JMRI/JMRI/releases/tag/v5.7.7">JMRI 5.7.7 GitHub release</a>.
-->
<!--
Preliminary build files (not the final released files) can be found
on the
<a href="https://builds.jmri.org/jenkins/job/testreleases/job/5.7.7/">CI project page</a>.
-->
During development leading to the actual release, you can find test download files on the
<a href="https://builds.jmri.org/jenkins/job/development/job/packages/">continuous integration build page</a>.
These are development files, and might not be working at any particular time.</p>
<a id="changes" name="changes"></a>
<h2>Changes since <a href="jmri5.7.6.shtml">Test Release 5.7.6</a>:</h2>
The <a href="https://github.com/JMRI/JMRI/issues?utf8=✓&q=milestone%3A5.7.7+is%3Amerged">full list of included changes</a> is available from our
<a href="https://github.com/JMRI/JMRI">GitHub code repository</a>.
<!-- While this release is in development, the -->
<!-- new release note items are kept in -->
<!-- help/en/releasenotes/current-draft-note.shtml -->
<!-- in the JMRI/JMRI repository. Please edit -->
<!-- there. Changes to this file won't be merged. -->
<!--#include virtual="/help/en/releasenotes/current-draft-note.shtml" -->
<!--#include virtual="/Footer.shtml" -->
</div><!-- closes #mainContent-->
</div> <!-- closes #mBody-->
<script src="/js/main.js"></script>
</body>
</html>