|
|
Description/Features
The Remote Import plugin allows to import data from a remote Confluence instance. Spaces, users and groups can be migrated from one instance to another.
Installation
Please refer to the Confluence documentation on installing plugins.
 |
|
Usage
The plugin will add a new Remote Import link to the global administration in the Administration section.
The Remote Import screen has two section.
- Remote Login Details
- What do you want to import
The remote login details specify the instance from which you want to import the data as well as a username and password to log into the instance. Please note that you will only be able to import spaces to which the specified user has access.
The second section allows you to specify the type of data you want to import.
| Property | Description |
|---|---|
| Space (key) | the key a single space |
| Space Group (key) | the key of the space group |
| User Group | the name of a single user group |
| Groups | all groups starting with the specified key. Eg. the key "sales" will retrieve the groups sales-interal and sales-external |
Examples
Version History
| Version | Date | State | License | Price |
0.9.7
(#107)
|
30 Jan 2009 | Beta | Freeware / Open Source (BSD) | Free |
|
0.9.5
(#106)
|
13 Mar 2008 | Beta | Freeware / Open Source (BSD) | Free |
|
0.9.6
(#105)
|
22 Oct 2008 | Beta | Freeware / Open Source (BSD) | Free |
|
0.9.4
(#104)
|
07 Feb 2008 | Beta | Freeware / Open Source (BSD) | Free |
|
0.9
(#101)
|
19 Sep 2007 | Beta | Freeware / Open Source (BSD) | Free |
|
0.8
(#100)
|
07 Sep 2007 | Beta | Freeware / Open Source (BSD) | Free |
Open Issues
No issue tracking setup for this plugin.
Screenshots
Screenshots |
|---|
|
Comments (19)
Sep 20, 2007
Guy Fraser says:
The JIRA project doesn't seem to exist yet so posting a couple of feature reques...The JIRA project doesn't seem to exist yet so posting a couple of feature requests here before I forget...
I guess normally this plugin will be used behind the company firewall and as only admins can use it then it makes sense to have the plugin do what it currently does.
However, I'd love to use this plugin on a public server - that being the case, some extra controls are needed...
1. Ability to define which spaces/etc can be exported on source server.
It would be sweet if the server that contains the original data could be configured to say which things it will allow to be exported to another server.
For example, I might want our user guides to be transferrable to other sites, but not our website space.
If none of these settings are defined, then the default should be "nothing can be exported". You have to add things to make them available for export and maybe also have an "All" checkbox if you wanted all spaces or all users, etc., to be exportable.
2. Ability for destination server to show a list of available things that can be imported.
Based on #1 above, the user would enter details for the source server and the plugin would query the source server to ask for a list of available things. The admin then chooses what they want from the list and away they go.
3. Ability to say which users are allowed to use the export
As the admin of a destination server might not be an admin of the source server, it would be useful if we could list which users (they would need account on source server) are allowed to perform the import to from the remote server.
4. Ability for source server to export to a remote destination server
From what I can see, at present the remote (destination) server logs in to the source server and pulls data from it.
It would be useful if that could also work the other way round - ie. source server pushes data to the remote destination server. In this scenario, the source server would need to log in to the remote destination server and push the content in to it.
5. Ability to do scheduled transfers
The ability to schedule hourly, daily, weekly transfers of data would be most useful.
Oct 03, 2007
Jens Schumacher says:
Guy, I've added a Jira project for this plugin, so feel free to create future ...Guy,
I've added a Jira project for this plugin, so feel free to create future issues in Jira.
Regarding your suggestions:
1-3: The use is currently limited to administrators because the plugin is located in the global administration. However, that doesn't mean that you will have to be an administrator on the remote instance. You can login as any user and export content from that instance. However, there are a few restrictions:
4. I had already a customer asking for this so I will definitely put that up on the roadmap.
5. Agreed, scheduled transfers would be useful to merge data. However, for this to work, local space has to be removed before the import is done. This functionality gives you the ability to shoot yourself in the foot and I would rather not hand over the gun for this
That said, there are ways to reduce the risk of accidently deleting your data and we can certainly look into implementing the feature in a future version.
Feb 22, 2008
Aaron Godert says:
This plugin looks great! We've got two separate instances on the same ...This plugin looks great! We've got two separate instances on the same version, and our users and groups are sync'd up already (or will be here shortly).
So, my question is if all of that is already taken care of and now we only want to import space content, will the plugin know that the users and groups already exist on the target system and just ignore creating or updating them?
Feb 22, 2008
Aaron Godert says:
Hi, I have a couple other questions: Does it leave the old space on the source...Hi, I have a couple other questions:
Thanks!
Feb 25, 2008
Choy Li Tham says:
Hi Aaron, If you have any queries regarding the usage of the Remote Import plug...Hi Aaron,
If you have any queries regarding the usage of the Remote Import plugin, I would recommend you to contact the plugin authors as stated in this page, so that they should be able to resolve your queries.
Regards,
Choy Li
Mar 06, 2008
Jens Schumacher says:
1. The remote space will not be deleted. 2. The plugin will not delete any data....1. The remote space will not be deleted.
2. The plugin will not delete any data. The migration will be aborted if a space with the same key already exists on the local instance.
3. All users and groups will be copied. If the group already exists, the remote users will be added to that group. If a user already exists, the user from the remote server will not be migrated, but the local user will still be added to the required groups.
Mar 28, 2008
Patricia Kale says:
Hello! I am trying to use this plugin to migrate several spaces from our de...Hello!
I am trying to use this plugin to migrate several spaces from our development Confluence instance to our production instance. However, I have run into a problem. After I enter the URL, username, password, and space key, then press import, I receive this error message: Import failed: Unable to contact remote Confluence server and execute export. On the running task page, I get the following message: Status: Import failed: Unable to contact remote Confluence server and execute export
Time Elapsed: 30 seconds
Completion: 100% complete
The entries in the stdout log file are voluminous. I think that these bits might give a clue:
We are using SSL on the machines running both Confluence instance (URL is https://). Could this be causing the problem?
Thanks much!
Pat
Mar 30, 2008
Choy Li Tham says:
Hi Patricia, Please create a support ticket at the following issue tracker for ...Hi Patricia,
Please create a support ticket at the following issue tracker for further investigation:
Regards,
Choy Li
May 19, 2008
Imtiaz B Syed says:
Dear Jens/Brown, I would like to know whether this plugin will work the sam...Dear Jens/Brown,
I would like to know whether this plugin will work the same even if we change the context from confluence to some other name like 'containerdoc'.
Because I observe there are some remote calls based on string 'confluence1.xxx'. It will be a great help if you could explain the role of the string 'confluence1.xxx' in this implimentation and what are the other similar strings to call remote services?
Thanks
Imtiaz
May 22, 2008
Imtiaz B Syed says:
When we do a Remote import thru this plug-in it is not importing the labels of t...When we do a Remote import thru this plug-in it is not importing the labels of the source server space to target server space. Any clue in this how to get it done?
Jul 29, 2008
Aaron Hamid says:
@ Patricia and Choy: I think this is a bug in the plugin. It does not app...@ Patricia and Choy:
I think this is a bug in the plugin. It does not appear to be fixed as of this posting. There is a check that prepends the "http://" incorrectly yielding a url like http://https://urlyouspecified/ and therefore the unknownhostexception. Here is a trivial patch that fixes it:
Index: C:/data/development/projects/remoteimport-0.9.5/src/main/java/com/atlassian/confluence/extra/remoteimport/AbstractRemoteImportAction.java
===================================================================
--- C:/data/development/projects/remoteimport-0.9.5/src/main/java/com/atlassian/confluence/extra/remoteimport/AbstractRemoteImportAction.java (revision 21411)
+++ C:/data/development/projects/remoteimport-0.9.5/src/main/java/com/atlassian/confluence/extra/remoteimport/AbstractRemoteImportAction.java (working copy)
@@ -28,7 +28,7 @@
{
try
{
- if (!url.startsWith("http://"))
+ if (!url.startsWith("http://") && !url.startsWith("https://"))
url = "http://"+url;
parsedUrl = new URL(url + "/rpc/xmlrpc");
Jul 30, 2008
Patricia Kale says:
Hi Aaron, Thanks for replying to my post. I submitted a Jira issue for this pro...Hi Aaron,
Thanks for replying to my post. I submitted a Jira issue for this problem, which was resolved for me. The instructions on this page addressed my problem:
http://confluence.atlassian.com/display/JIRA/Connecting to SSL services
-Pat
Oct 21, 2008
Aaron Hamid says:
I discovered that the Remote Import plugin does not work with external (e.g. JIR...I discovered that the Remote Import plugin does not work with external (e.g. JIRA) user management because it is running SQL directly against the Confluence db. I think (hope) I can fix this by going through the UserAccessor API.
Jan 06, 2009
Jens Schumacher says:
The problem is that the UserAccessor API does not expose the hashed user passwor...The problem is that the UserAccessor API does not expose the hashed user password. Therefore this information will have to be retrieved via the database directly at this stage.
Jan 06, 2009
Aaron Hamid says:
That's right, I was not able to obtain the passwords (fortunately that was accep...That's right, I was not able to obtain the passwords (fortunately that was acceptable) - it was the only way I was able to perform the import. My problem is solved, it was just a few lines of code change if I recall correctly.
Feb 17, 2009
Antti Komulainen says:
I just tried to install v. 0.97 on Confluence 2.9.1. After the installation I ge...I just tried to install v. 0.97 on Confluence 2.9.1. After the installation I get the following errors when clicking the plugin in the admin panel:
Log says:
-- url: /admin/plugins.action | userName: admin | action: plugins org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'spaceGroupPermissionImportManager': Instantiation of bean failed; nested exception is ja va.lang.NoClassDefFoundError: com/atlassian/confluence/hosted/SpaceGroupPermissionManager Caused by: java.lang.NoClassDefFoundError: com/atlassian/confluence/hosted/SpaceGroupPermissionManager at java.lang.Class.getDeclaredMethods0(Native Method) at java.lang.Class.privateGetDeclaredMethods(Class.java:2427) at java.lang.Class.getDeclaredMethods(Class.java:1791) at java.beans.Introspector$1.run(Introspector.java:1272) at java.security.AccessController.doPrivileged(Native Method) at java.beans.Introspector.getPublicDeclaredMethods(Introspector.java:1270) at java.beans.Introspector.getTargetMethodInfo(Introspector.java:1136) at java.beans.Introspector.getBeanInfo(Introspector.java:387) at java.beans.Introspector.getBeanInfo(Introspector.java:159)and:
2009-02-17 12:17:13,326 ERROR [TP-Processor1] [com.atlassian.plugin.DefaultPluginManager] enablePluginModules There was an error loading the descriptor 'spaceImportManager' of plugin 'com.atlassian.confluence.extra.remoteimport'. Disabling. -- url: /admin/uploadplugin.action | userName: admin | action: uploadplugin java.lang.IllegalStateException: Can not overwrite an existing bean definition: spaceImportManager at com.atlassian.confluence.plugin.descriptor.ComponentModuleDescriptor.enabled(ComponentModuleDescriptor.java:76) at com.atlassian.plugin.DefaultPluginManager.enablePluginModules(DefaultPluginManager.java:697) at com.atlassian.plugin.DefaultPluginManager.addPlugin(DefaultPluginManager.java:314) at com.atlassian.plugin.DefaultPluginManager.scanForNewPlugins(DefaultPluginManager.java:181) at com.atlassian.plugin.DefaultPluginManager.installPlugin(DefaultPluginManager.java:126)Any idea what's going on?
May 27, 2009
Andy Brook says:
Early days I know for 3.0, but just tried this on beta3: Cause: java.lang.Ille...Early days I know for 3.0, but just tried this on beta3:
Cause: java.lang.IllegalArgumentException: Method 'doDefault()' is not defined in action 'class com.atlassian.confluence.extra.remoteimport.ImportSpaceAction' at com.opensymphony.xwork.DefaultActionInvocation.invokeAction(DefaultActionInvocation.java:305)2.9.2 also cant deploy, when installed via pugin repo (0.9.7)
Oct 16
Robert Quinn says:
looks like a useful plugin.... any word on when this will support 3.0.2... i hav...looks like a useful plugin.... any word on when this will support 3.0.2... i have multiple instances that i want to consolidate.
Nov 12
Brice Copy says:
I second that motion, an update for Confluence 3 would be welcome, any release d...I second that motion, an update for Confluence 3 would be welcome, any release dates on the plans ?
Are there viable alternatives, or known procedures to automate space imports between two Confluence instances ?