/
profiles.shtml
124 lines (98 loc) · 5.09 KB
/
profiles.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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<meta name="generator" content=
"HTML Tidy for Mac OS X (vers 31 October 2006 - Apple Inc. build 15.17), see www.w3.org">
<title>JMRI Setup - Configuration Profiles</title><!-- Style -->
<meta http-equiv="Content-Type" content=
"text/html; charset=us-ascii">
<link rel="stylesheet" type="text/css" href="/css/default.css"
media="screen">
<link rel="stylesheet" type="text/css" href="/css/print.css"
media="print">
<link rel="icon" href="/images/jmri.ico" type="image/png">
<link rel="home" title="Home" href="/"><!-- /Style -->
</head>
<body>
<!--#include virtual="/Header" -->
<div id="mBody">
<!--#include virtual="Sidebar" -->
<div id="mainContent">
<!-- Page Body -->
<h1>JMRI Setup: Configuration Profiles</h1>
<p><em>Configuration Profiles</em> allow a single JMRI
application to be launched with one of multiple
user-specified Configurations. A Configuration Profile
contains all Preferences as they are set in the JMRI
Preferences dialog, and may - optionally - include user
files, a Roster, and Throttles.</p>
<p><a href="images/Config_ProfileMigrate314.png"><img src=
"images/Config_ProfileMigrate314.png" width="438" height=
"114" align="right" alt=
"Profile configuration conversion dialog screen"></a> When
opening an older JMRI configuration in one of the newer
applications, the way Preferences are stored is converted.
The application notifies you with this dialog:</p>
<p>When a JMRI application (version 3.9 and up) is launched
for the first time, it checks for a Configuration Profile. If
no Profile exists, the application will create a default
Profile and use it without prompting you. If only a single
Profile is found, the application will use that Profile
without prompting you. If there are multiple Profiles, the
application will prompt you for the Profile to use. You may
specify that the application should always start with the
same Profile.</p>
<p>By default, when a JMRI application starts up, it prompts
the user for which Configuration Profile to use: <img src=
"images/Set_Active_Profile.png"></p>
<p>If the user doesn't select a new Profile and click OK, the
program will continue with the default Profile after a short
delay. You can check a box in the preferences to bypass this
step and go directly to the last-used Profile.</p>
<h2>Profile Management</h2>
<p>Configuration Profiles can be managed in the application
preferences, under the Profile Configuration
tab.</p><img src="images/Profile_Preferences_prompt.png">
<p>The line marked "Current active Profile" in the Status
column is being used by this run of the JMRI application, and
is also where Preferences changes will be saved.</p>
<p>To use or configure a different Profile, select it, click
"Activate", Save and restart the application.</p>
<p>For more information on how to configure JMRI to share its
configuration files between multiple computers, see the
<a href="Dropbox.shtml">help page on using Dropbox with
JMRI</a>.</p>
<p>We recommend that Profile directory names end in <code>.jmri</code> so
that other applications can use that extension to recognize a profile
by extension. JMRI automatically adds <code>.jmri</code> to the name
of the directory for new Profiles. If <code>.jmri</code> is added to
the name of an existing Profile directory, JMRI should automatically
recognize and handle that change.</p>
<h2>Sharing Profiles</h2>
<h3>Exporting</h3>
<p>Profiles can be exported from the application preferences
Config Profile section. An exported Profile is a compressed
archive containing the Profile's contents, and will
optionally contain the user files and roster if they are
stored outside the Profile.</p>
<h3>Importing</h3>
<p>JMRI does not yet directly support importing Profiles.</p>
<p>A Profile can be imported by uncompressing it using an
archive management utility into a new directory and then
opening while launching JMRI or from the application's
Preferences by clicking the "Add Existing..." button.</p>
<p>Note that using the Profile Import/Export capability to
copy JMRI data back and forth between two computers is
neither supported or recommended.</p>
<h2>Upgrading from Earlier Versions of JMRI</h2>
<p>When you first run a JMRI application after upgrading from
an earlier version of JMRI, the application will copy its
existing configuration to a new Profile, and use that
Profile. If you are using a JMRI application you had not used
prior to upgrading, the application will behave as described
above.</p><!--#include virtual="/Footer" -->
</div><!-- closes #mainContent-->
</div><!-- closes #mBody-->
</body>
</html>