-
Notifications
You must be signed in to change notification settings - Fork 331
/
profiles.shtml
117 lines (92 loc) · 4.65 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
<!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>
<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>