 | Old Gui This gui was last seen with UWC v45. |
UWC Quick Start
1. Download the latest version of the UWC and unzip.
2. Make sure you have the following prerequisities:
Java 5 (a.k.a. JDK 1.5) or higher
A user/login id and password which has write permission to the space(s) you wish to add converted content to
Back up Confluence before running the UWC. (in theory this process involves no data loss, no deletions, but back up to be safe and easily revert to an earlier state).
The Confluence you want to send pages to must be running and accessible.
Adminstration -> General Configuration -> Remote API (XML-RPC & SOAP): must be turned on
3. Start the UWC by running:
cd to your uwc directory
run_uwc.bat (Windows)
run_uwc.sh (Linux)
4. Select your wiki, then click "Next >>"
5. Add the appropriate Confluence setting values.
The 'filename pattern' of .txt means only filenames with those extensions will be shown. You can leave it blank
The 'attachment directory' setting depends on where the wiki files are stored and depends on the wiki you're converter. Click here for more details on this setting.
Then click "Next >>"
6. Select converters
In most cases you can just accept the default and click on "Next >>"
7. Choose Pages to Convert
Here you select text files which contain the wiki markup of the wiki you're converting. Some wikis store files like this automatically. Some wikis require you to do an export.
8. Send Pages to Confluence
Clicking on "Send Pages To Confluence" creates an output directory with the converted pages which you can inspect.
Only once you click on the pop up confirmation will pages actually be sent to Confluence. 
Comments (6)
Oct 31, 2007
Darryl Lee says:
Step 5 says:The 'attachment directory' setting depends on where the wiki files a...Step 5 says:The 'attachment directory' setting depends on where the wiki files are stored and depends on the wiki you're converter. Click here for more details on this setting.
There are not actually more details on the "attachment directory" setting and according to UWC-180 a wrong setting here can screw things up. I am getting the message that my "user is authenticated... but had no permissions on the space"
Dec 06, 2007
Jeremy Moritz says:
I am having this same problem. I have full permissions on the space I'm attempti...I am having this same problem. I have full permissions on the space I'm attempting to connect to, but I always get this error with the default attachment directory. I'm not sure what to change it to or what I'm doing wrong in my connection settings.
I have version 45 of UWC and am attempting to convert a PM Wiki to Confluence.
When this happens the following shows up in my command prompt:
2007-12-06 08:56:13,497 DEBUG [main] - initializing listeners
Second(s): 0
java.net.UnknownHostException: http
at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:177)
at java.net.Socket.connect(Socket.java:519)
at java.net.Socket.connect(Socket.java:469)
at sun.net.NetworkClient.doConnect(NetworkClient.java:157)
at sun.net.www.http.HttpClient.openServer(HttpClient.java:394)
at sun.net.www.http.HttpClient.openServer(HttpClient.java:529)
at sun.net.www.http.HttpClient.<init>(HttpClient.java:233)
at sun.net.www.http.HttpClient.New(HttpClient.java:306)
at sun.net.www.http.HttpClient.New(HttpClient.java:323)
at sun.net.www.protocol.http.HttpURLConnection.getNewHttpClient(HttpURLC
onnection.java:788)
at sun.net.www.protocol.http.HttpURLConnection.plainConnect(HttpURLConne
ction.java:729)
at sun.net.www.protocol.http.HttpURLConnection.connect(HttpURLConnection
.java:654)
at sun.net.www.protocol.http.HttpURLConnection.getOutputStream(HttpURLCo
nnection.java:832)
at org.apache.xmlrpc.DefaultXmlRpcTransport.sendXmlRpc(DefaultXmlRpcTran
sport.java:83)
at org.apache.xmlrpc.XmlRpcClientWorker.execute(XmlRpcClientWorker.java:
72)
at org.apache.xmlrpc.XmlRpcClient.execute(XmlRpcClient.java:194)
at org.apache.xmlrpc.XmlRpcClient.execute(XmlRpcClient.java:185)
at org.apache.xmlrpc.XmlRpcClient.execute(XmlRpcClient.java:178)
at biz.artemis.confluence.xmlrpcwrapper.RemoteWikiBroker.getLoginTokenTh
rowExceptions(RemoteWikiBroker.java:270)
at biz.artemis.confluence.xmlrpcwrapper.RemoteWikiBroker.getLoginToken(R
emoteWikiBroker.java:222)
at biz.artemis.confluence.xmlrpcwrapper.RemoteWikiBroker.getUserPermissi
onsForUser(RemoteWikiBroker.java:786)
at com.atlassian.uwc.ui.ConfluenceSettingsForm$1.actionPerformed(Conflue
nceSettingsForm.java:59)
at javax.swing.AbstractButton.fireActionPerformed(AbstractButton.java:19
95)
at javax.swing.AbstractButton$Handler.actionPerformed(AbstractButton.jav
a:2318)
at javax.swing.DefaultButtonModel.fireActionPerformed(DefaultButtonModel
.java:387)
at javax.swing.DefaultButtonModel.setPressed(DefaultButtonModel.java:242
)
at javax.swing.plaf.basic.BasicButtonListener.mouseReleased(BasicButtonL
istener.java:236)
at org.jvnet.substance.utils.RolloverButtonListener.mouseReleased(Rollov
erButtonListener.java:108)
at java.awt.Component.processMouseEvent(Component.java:6038)
at javax.swing.JComponent.processMouseEvent(JComponent.java:3265)
at java.awt.Component.processEvent(Component.java:5803)
at java.awt.Container.processEvent(Container.java:2058)
at java.awt.Component.dispatchEventImpl(Component.java:4410)
at java.awt.Container.dispatchEventImpl(Container.java:2116)
at java.awt.Component.dispatchEvent(Component.java:4240)
at java.awt.LightweightDispatcher.retargetMouseEvent(Container.java:4322
)
at java.awt.LightweightDispatcher.processMouseEvent(Container.java:3986)
at java.awt.LightweightDispatcher.dispatchEvent(Container.java:3916)
at java.awt.Container.dispatchEventImpl(Container.java:2102)
at java.awt.Window.dispatchEventImpl(Window.java:2429)
at java.awt.Component.dispatchEvent(Component.java:4240)
at java.awt.EventQueue.dispatchEvent(EventQueue.java:599)
at java.awt.EventDispatchThread.pumpOneEventForFilters(EventDispatchThre
ad.java:273)
at java.awt.EventDispatchThread.pumpEventsForFilter(EventDispatchThread.
java:183)
at java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThre
ad.java:173)
at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:168)
at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:160)
at java.awt.EventDispatchThread.run(EventDispatchThread.java:121)
2007-12-06 08:56:55,684 INFO [AWT-EventQueue-0] - problem getting this user
Dec 18, 2007
Brendan Patterson says:
Hi Jeremy, Your error of 'unknown host' makes it look like the 'address' settin...Hi Jeremy,
Your error of 'unknown host' makes it look like the 'address' setting might be incorrect. Can you copy and paste what you have in that text field into the browser and have it give you back a Confluence page?
The attachments directory setting should be a directory you can copy/paste into a command prompt and do an ls (unix) or dir (dos) and have the dir. come back for you.
Maybe ping me directly and I can help get you over the hump.
thanks,
Brendan
Dec 26, 2007
Oren Hurvitz says:
Hi Jeremy, Remove the "http://" part. I.e., if your Confluence URL is http://wi...Hi Jeremy,
Remove the "http://" part. I.e., if your Confluence URL is http://wiki.example.com:8080/confluence/ , then you should enter wiki.example.com:8080/confluence/
Hope this helps,
Oren
Dec 26, 2007
Jeremy Moritz says:
That worked thank you very much!That worked thank you very much!
Dec 18, 2007
Brendan Patterson says:
Hi Darryl, It sounds like there are two issues here. #1) For more details on t...Hi Darryl,
It sounds like there are two issues here.
#1) For more details on the attachment directory setting you need to click through to the specific wiki notes (i.e. TikiWiki, PmWiki, MediaWiki, etc.) you are trying to convert. However it's possible the notes for the one you're converting are missing for that setting. Which wiki are you converting?
#2) For the 'user had no permissions' the message is not all that helpful and can be due to some other things such as a typo in the space key or accidently using the 'space name' instead of the 'space key'. Though adding that test button has helped quite a bit it does need to be improved.
Apologies for the delay on replying to this. Oct/Nov. was a very busy time and I'm afraid a few comments to these pages slipped through the cracks.
thanks!