NB65SettingsMigration
Page Info
Plain View
My Prefs
Log in
This page (revision-38) last changed on
11:20 05-Sep-2008
by vita.
![[RSS]](http://wiki.netbeans.org/images/xml.png "Aggregate the RSS feed of the entire wiki")
MODULE OWNERS ARE RESPONSIBLE TO CHECK THE LIST OF SETTINGS BEING IMPORTED FROM ALL RELEASES
Importing user settings in NB 6.5
The Settings Import utility code runs during the first run of the IDE with a not-yet-populated userdir. User's home directory is scanned for previous userdirs by their default names and the user is provided with an option to import existing settings and projects into the new userdir. The copying is selective. Most of the content is carried over, files that are known to cause compatibility problems are not copied.
There are a lot of various settings used by various modules. Some of them may be perfectly compatible and reusable, while others may not make any sense in the new version. In general, module owners are responsible for maintaining compatibility of settings across module versions, so it's up them to specify which files might be subject to importing.
Importing from following releases
| Release |
|---|
| 6.1 |
| 6.0 |
| 5.5(.1) |
Implementation progress
- watch issue 135356
Importable user settings created by NB 6.1-based products
Setting patterns are relative to $userdir/config.
| Module | Settings to be imported | Comment | Verified by QE |
|---|---|---|---|
| ALL | Preferences/** | all preferences are copied | |
| welcome | exclude Preferences/org/netbeans/modules/welcome.properties!feedback.* | satisfaction survey settings | |
| db | Databases/** | Registered JDBC drivers and database connections | |
| db | Services/org-netbeans-modules-db-explorer-DatabaseOption.settings | Module settings | |
| editor | Editors/** exclude Editors/.*/macros.xml exclude Editors/.*/Popup.* exclude Editors/.*/.*\.instance exclude Editors/.*/Settings\.settings | Editor settings for all mime types | |
| editor | Services/IndentEngine/.* | Editor indent engines | |
| java | Templates/Classes/** | Java Templates | |
| core | Keymaps/** Shortcuts/** | Global shortcuts | OK |
| core | Toolbars/** exclude Toolbars/Progress/** | toolbars, exclude javacore-ProgressAction (#63826) | OK (Issue 143618) |
| core.ui | Services/Browsers/.* | Options>General>Web Browser | |
| kjava/j2meplatform | Services/Platforms/org-netbeans-api-java-Platform/*.xml (the same pattern as for J2SE platforms) | J2ME platform definitions | |
| kjava/j2meproject | Templates/J2MEProjectConfigurations/*.cfg | Mobility Project Configuration Custom Templates | |
| vmd.midpnb | vmd-midp/palette/custom/* | Mobility Visual Designer Custom Components | |
| project/libraries | org-netbeans-api-project-libraries/Libraries/*.xml | User defined libraries | OK |
| favorites | Favorites/** | List of items of Favorites view | OK |
| local history | $userdir/var/filehistory/** | LH storage | |
| Debugger | Services/org-netbeans-modules-debugger-Settings.properties | Breakpoints, watches, etc. | |
| form | Services/formsettings.settings FormDesignerPalette/** | Options -> Editing -> GUI Builder | |
| web | JSPPalette/** HTMLPalette/** | Tools -> Palette -> HTML/JSP Code Clips | |
| j2eeserver | J2EE/** | Server Registry settings | |
| Diff | Services/DiffProviders/.* | Order of Diff providers from layer | |
| beans | exlude Templates/Beans/Bean.java exlude Templates/Beans/BeanInfo.java exlude Templates/Beans/NoIconBeanInfo.java exlude Templates/Beans/Customizer.java exlude Templates/Beans/Customizer.form exlude Templates/Beans/PropertyEditor.java | Templates rewritten to FreeMarker |
Importable user settings created by NB 6.0-based products
| Module | Settings to be imported | Comment | Verified by QE |
|---|---|---|---|
| ALL | Preferences/** | all preferences are copied | Issue 143626 |
| Debugger | Services/org-netbeans-modules-debugger-Settings.properties | Breakpoints, watches, etc. | |
| form | Services/formsettings.settings FormDesignerPalette/** | Options -> Editing -> GUI Builder | |
| java | Templates/Classes/** | java templates | |
| websvc | WebServices/service-groups.xml WebServices/**/*-saas.xml | These files relate to the nodes in Services tab > Web Services. The first file records web service groups that the user may have created. The second file is metadata of a web service that the user may have added (not the web services that are provided by the IDE) to the Web Services node in the Services tab, where * is the name of the imported web service. | |
| editor | Editors/** exclude Editors/.*/macros.xml exclude Editors/.*/Popup.* exclude Editors/.*/.*\.instance exclude Editors/.*/Settings\.settings | Editor settings for all mime types | |
| editor | Services/IndentEngine/.* | Editor indent engines | |
| C/C++ | exclude Services/IndentEngine/org-netbeans-modules-cnd-editor-cplusplus-CIndentEngine.settings exclude Services/IndentEngine/org-netbeans-modules-cnd-editor-cplusplus-CCIndentEngine.settings | C/C++ indentation engines to exclude | |
| core | Toolbars/** exclude Toolbars/Progress/** | toolbars, exclude javacore-ProgressAction (#63826) | OK (Issue 143618) |
| core | Keymaps/** Shortcuts/** | Global shortcuts | OK |
| core.ui | Services/Browsers/.* | Options>General>Web Browser | |
| uml | $userdir/.uml | ||
| Diff | Services/DiffProviders/.* | Order of Diff providers from layer | |
| kjava/j2meplatform | Services/Platforms/org-netbeans-api-java-Platform/*.xml (the same pattern as for J2SE platforms) | J2ME platform definitions | |
| kjava/j2meproject | Templates/J2MEProjectConfigurations/*.cfg | Mobility Project Configuration Custom Templates | |
| Mobility: Designer 1 | exclude MVD/** exclude Windows2Local/Components/DesignInspector.settings exclude Windows2Local/Groups/mvd/DesignInspector.wstcgrp exclude Windows2Local/Modes/navigator/DesignInspector.wstcref | Visual Mobility Designer | |
| db | Databases/** | Registered JDBC drivers and database connections | |
| db | Services/org-netbeans-modules-db-explorer-DatabaseOption.settings | Module settings | |
| web | JSPPalette/** HTMLPalette/** | Tools -> Palette -> HTML/JSP Code Clips | |
| j2eeserver | J2EE/** | Server Registry settings | |
| project/libraries | org-netbeans-api-project-libraries/Libraries/*.xml | User defined libraries | OK |
| favorites | Favorites/** | List of items of Favorites view | OK |
| local history | $userdir/var/filehistory/** | LH storage |
Importable user settings created by NB 5.5-based products
| Module | Settings to be imported | Comment | Verified by QE |
|---|---|---|---|
| core | Services/org-netbeans-core-IDESettings.settings | (proxy, preferred html browser,..) | OK |
| core | Toolbars/** exclude Toolbars/Progress/** | toolbars, exclude javacore-ProgressAction (#63826) | OK |
| ant | Services/org-apache-tools-ant-module-AntSettings.settings | Ant Settings | OK |
| collab | Services/Collaboration/** | Collaboration Settings | |
| form | Services/formsettings.settings FormDesignerPalette/** | Options -> Editing -> GUI Builder | |
| profiler | Services/org-netbeans-modules-profiler-ProfilerIDESettings.settings | Options -> Profiler | (NO GO http://www.netbeans.org/issues/show_bug.cgi?id=130811) |
| java/j2seplatform | Services/Platforms/org-netbeans-api-java-Platform/*.xml | J2SE platform definitions | OK |
| project/libraries | org-netbeans-api-project-libraries/Libraries/*.xml | User defined libraries | OK |
| projects | Services/org-netbeans-modules-project-ui-OpenProjectList.settings | projects opened in IDE (not recent projects) | OK |
| editor | Editors/** exclude Editors/.*/macros.xml exclude Editors/.*/Popup.* exclude Editors/.*/.*\.instance exclude Editors/.*/Settings\.settings | Editor settings for all mime types | OK |
| editor | Services/IndentEngine/.* | Editor indent engines | OK |
| C/C++ | exclude Services/IndentEngine/org-netbeans-modules-cnd-editor-cplusplus-CIndentEngine.settings exclude Services/IndentEngine/org-netbeans-modules-cnd-editor-cplusplus-CCIndentEngine.settings | C/C++ indentation engines to exclude | |
| java | Services/org-netbeans-modules-java-settings-JavaSettings.settings | Editing -> Java Sources | OK |
| java | Editors/AnnotationTypes/org-netbeans-modules-java-*.xml | Annotation Types | OK |
| javadoc | Services/org-netbeans-modules-javadoc-settings-DocumentationSettings.settings | Javadoc Search | OK |
| extbrowser | Services/Browsers/**, i.e: Services/Browsers/SimpleExtBrowser.settings Services/Browsers/SystemDefaultBrowser.settings Services/Browsers/IExplorerBrowser.settings Services/Browsers/FirefoxBrowser.settings Services/Browsers/NetscapeBrowser.settings Services/Browsers/MozillaBrowser.settings | IDE Configuration -> Server and External Tool Settings -> Web Browsers in the IDE options dialog | OK |
| httpserver | Services/org-netbeans-modules-httpserver-HttpServerSettings.settings | Runtime -> HTTP Server | |
| monitor | HTTPMonitor/** | Saved HTTP Monitor transactions | |
| j2eeserver | J2EE/** | Server Registry settings | |
| db | Databases/** | Registered JDBC drivers and database connections | |
| db | Services/org-netbeans-modules-db-explorer-DatabaseOption.settings | Module settings | |
| db/derby | Services/org-netbeans-modules-derby-DerbyOptions.settings | Module settings | |
| Tasklist | system/Services/org-netbeans-modules-tasklist-docscan-Settings.settings system/TaskList/** system/Services/Hidden/org-netbeans-modules-tasklist-suggestions-settings-ManagerSettings.instance system/Editors/AnnotationTypes/TaskAnnotation**.xml | TODO Settings | |
| kjava/j2meplatform | Services/Platforms/org-netbeans-api-java-Platform/*.xml (the same pattern as for J2SE platforms) | J2ME platform definitions | |
| kjava/j2meproject | Templates/J2MEProjectConfigurations/*.cfg | Mobility Project Configuration Custom Templates | |
| Mobility: Designer 1 | exclude MVD/** exclude Windows2Local/Components/DesignInspector.settings exclude Windows2Local/Groups/mvd/DesignInspector.wstcgrp exclude Windows2Local/Modes/navigator/DesignInspector.wstcref | Visual Mobility Designer | |
| Old VCS | Services/Hidden/org-netbeans-modules-vcscore-settings-GeneralVcsSettings .settings Services/Hidden/VersionControl/org-netbeans-modules-vcscore-grouping-VcsGroupSettings .settings vcs/.* VCSMount/.* | ||
| New CVS | Services/Hidden/org-netbeans-modules-versioning-system-cvss-settings.* | ||
| Diff | Services/DiffProviders/.* Services/Diffs/.* Services/DiffVisualizers/.* Services/MergeVisualizers/.* Services/Hidden/org-netbeans-modules-diff-DiffSettings .settings | ||
| Visual Web: Dataconnectivity | $userdir/context.xml $userdir/jdbc-drivers/* | To be copied to: $userdir/config/$release/context.xml where $release=5.5 or .5.1 The "jdbc-drivers" directory needs to be recursively copied to new userdir. | |
| Visual Web: Component Library | $userdir/complibs/* | The "complibs" directory needs to be recursively copied to new userdir. | |
| Visual Web: Palette | CreatorDesignerPalette/* CreatorDesignerPalette5/* | VW Palette settings (!!! but not part of NB5.5?), new imported components and code clips need to be recursively copied into the new userdir. | |
| Subversion | Services/Hidden/org-netbeans-modules-subversion-settings-* | ||
| Debugger | Services/org-netbeans-modules-debugger-Settings.properties | Breakpoints, watches, etc. | |
| web | JSPPalette/** HTMLPalette/** | Tools -> Palette -> HTML/JSP Code Clips | |
| favorites | Favorites/** | List of items of Favorites view | OK |
| core | Keymaps/** Shortcuts/** | Global shortcuts | OK |
| java | Templates/Classes/** | java templates | OK |