开云体育

On Oct 27, 2018, at 4:49 AM, Dave Heap <dgheap@...> wrote:

Settings Location (portable name = "settings:")
This is the only fixed location and is determined by the underlying operating system type and your logged-in-username. It's a known place the JMRI?program can always look and find essential settings files that tell it where everything else is located.
The following files/folders are always located here:
nodeIdentity.xml
This file contains a unique nodeIdentity string that is generated the first time JMRI uses this?Settings Location, doesn't change and serves to distinguish?between other possible Settings Locations (such as under another username, on a different operating system partition or another computer).
profiles.xml
This file lists the name of every Profile Folder known to this instance of JMRI and its location. It also has a list of all paths you wish to search for profiles?and which path is the default for newly-created profiles. "settings:" is always searched but it doesn't have to be the default.
log
This folder contains the session.log and messages.log files, plus several previous versions of these files.
DecoderProConfig3.properties
PanelProConfig2.properties
SoundProConfig2.properties
These files are created the first time each of the apps are run and simply contain three pieces of information:
- The name of the Profile Folder last used by this app.
- Whether you want the app to autostart with the last-used Profile Folder
- How long to display the Profile Selector box if you choose not to autostart.
Other files/folders
The following?may?be present, but do not have to be:
- ?Various Profile Folders you have created. From V4.13.4 on, newly-created Profile Folders will have a ".jmri" extension.
- ?Your User Files - panels etc.
-?Your "roster" folder?and its (recreatable) roster.xml file.

Profile Location (portable name = "profile:")
This folder is the one chosen by the Profile Selector mechanism for the current JMRI session.
The following files/folders are?always located here:

ProfileConfig.xml
profile.properties
profile
This folder contains node-specific folders with overrides for?ProfileConfig.xml and?profile.properties as well as user-interface.xml (window positions,?column widths, etc.).
Other files/folders
Other specific preference folders (throttle, etc.)
The following?may?be present, but do not have to be:
- ?Your User Files - panels etc.
- Your "roster" folder and its (recreatable) roster.xml file.

User Files Location (portable name = "preference:")
This location contains:
- ?Your User Files - panels etc.
The following?may?be present, but does not have to be:
- Your "roster" folder and its (recreatable) roster.xml file.
You are free to change the User Files Location as you like (Preferences->File Locations).

Roster Location (portable name = "roster:")
This location contains:
- Your "roster" folder and its (recreatable) roster.xml file.
By default the Roster Location is the same as (and follows) the User Files location unless you explicitly set a different location.
You are free to change the Roster Location as you like (Preferences->Roster->Roster->Location Set/Reset).

Scripts Location (portable name = "scripts:")
This location defaults to the "jython" sample scripts folder located within your JMRI Program Location. You should?never?store user-created files?anywhere within your Program Location, they are likely to be lost in a JMRI upgrade.?
If you are creating your own scripts you may wish to change the Scripts Location (Preferences->Locations).

Program Location (portable name = "program:")
This location is set when JMRI is installed and can only be changed when installing the software.
You should?never?store user-created files anywhere within your Program Location, they are likely to be lost in a JMRI upgrade.

User Files Location defaults and implications
Depending when you first installed JMRI on your computer, the default User Files Location will differ:
- Before the advent of Profiles (JMRI V3.8),the default?User Files Location was the same as the Settings. This arrangement stayed in place with the?upgrade.
- After the implementation of Profiles (JMRI V3.8),the default User Files Location for new installations is the same as the Profile Location.

Implications of User Files Location with Profiles
- If you create a new profile,?User Files Location = Profile Location. This means the profile will have an initially-empty set of User Files.
- If you create a copy of a profile that has User Files Location within the Profile Location, the new profile will have a new private copy of User Files from?the source profile. The two sets will be unconnected and changes to one will not affect the other.
- If you create a copy of a profile that has User Files Location anywhere on the computer outside the Profile Location, the new profile will share User?Files with the source profile. So changes will be seen by both profiles.

Implications of?Separating User Files Location and ?Roster Location
If you separate User Files Location from Roster Location (as documented above), you can implement differing sharing/separation of the two, e.g. a?single roster shared between two different layouts (each with its own profile).

Sharing User Files between Computers
Since User Files can be relocated completely outside of the user's JMRI file system, sharing of User Files between computers is easy:
Use of simple file sharing or using a local NAS or other file server:
This approach seems appealing at first sight. However there are considerable disadvantages and risks.
- The host computer or server must always be on line when using JMRI on any computer.
- Use of JMRI on a laptop away from home or Internet access will not be possible.
- JMRI is not designed for simultaneous file access. The risk of file corruption is very high.
- Recovery from a file corruption may be difficult or impossible unless a very comprehensive incremental backup strategy is in use and even the there is?likely to be some data loss.
See the link below for further information on issues with simple file sharing:?
Use of a cloud-synced sharing solution:
Note that in this context we are?not?talking about a Cloud Server approach where your files only exist on a remote server. We?are?talking about a?service such as Dropbox, Google Drive, OneDrive where full local copies exist on each computer and each copy is kept in sync with the central Cloud?copy.
There are considerable advantages with this approach.
- Only one computer needs to be switched on at a time.
- Use of JMRI on a laptop away from home or Internet access is fine. The file changes will be synced next time you are connected.
- These services generally do not usually use simultaneous file access. The risk of file corruption is much lower.?
- Recovery from unintended file changes is much easier. For example Dropbox keeps every saved change you have made in the past 30 days (even if?you only have one computer) and allows easy reversion.
We tend to talk about Dropbox because that is the one that seems to be most used by JMRI developers and users, some of whom have been doing so?for many years. For more information and setup instructions (also applicable to competing services) see:
<>

?Sharing Profiles between Computers
In the same way that User Files can be relocated completely outside of the user's JMRI file system and shared between computers, so can entire?Profiles. In Preferences->Config Profiles->Search Paths you can add a search path in a synced/shared location and set that to be the default for newly-created profiles. It's then simply a matter of manually moving each Profile Folder from the Settings Location to your new shared folder. When you first?use a shared profile on a different computer JMRI creates a node-specific folder for storing overrides of settings (see above) that are machine-specific?(e.g. COM port names).

I have been using both of shared User Files (a "JMRI" folder in my Dropbox folder) for many years and a shared Profiles (a "JMRI Config Profiles" folder?in my Dropbox folder) for more than a year now (and tweaked some JMRI code to improve node differentiation) across more than a dozen?machines/virtual machines, running Mac, Windows and Linux.

Portable File Access in JMRI
The success of file and profile sharing in JMRI is very dependent on the use of our Portable File Access specification in XML files.
Briefly, this consists of pseudo-URL prefixes (portable names mentioned above) that replace machine-specific directory paths in file specifications with a?set of prefixes relative to known JMRI and machine locations. These are expanded by the local JMRI instance to create a machine-specific file?specification. The component separators are standardised as "/" and converted locally.
For more information see:
<http://jmri.org/help/en/html/doc/Technical/FileNames.shtml>
For a full list of prefixes, see:
<http://jmri.org/JavaDoc/doc/jmri/util/FileUtil.html#getExternalFilename-java.lang.String->

Summary
I apologise for the verbosity of this document, but I've drawn together a lot of information and personal knowledge of how JMRI code works in these?areas (some of which is not well documented).
Some may think this document is worth converting to html and adding to the JMRI help pages, where it can be fine-tuned, corrected and updated as?need be. I'd like to do or but I'm afraid don't have the time to do so.

Time to get back to family priorities...

E&OE

Dave in Australia