Export spaces vua command line(using SOAP remote API) times out

Hi !

I am working with a standalone Confluence installations (3.5.6) and I'd like to export spaces from the commandline (Confluence CLI seems to be the answer).

When I try to export a reasonably large wiki space using Confluence CLI (which uses SOAP Remote API), I get:

Remote error: ; nested exception is:
Java.net.SocketTimeoutException: Read timed out

It times out in 10mins. Exactly.

Export space does work from within Confluence, and takes about 22 minutes. I've tested the export with a smaller space, and it works just fine through the CLI.

What is the right way to enable an end user to change the default timeout for all TCP connections or those initiated in a JVM so that these longer running tasks can finish and return? And, more importantly, is this the way to do it?

Has anyone had success exporting large spaces via command line?


6 answers

1 accepted

3 votes
Answer accepted


I don't quite know how to get around this issue with the CLI tool for Confluence, but I was able to overcome this issue with a Python script that might be useful:


import sys, string, xmlrpclib, re, httplib, time

#http timeout override
class TimeoutHTTPConnection( httplib.HTTPConnection ):
   def connect( self ):
       httplib.HTTPConnection.connect( self )
       self.sock.settimeout( self.timeout )

class TimeoutHTTP( httplib.HTTP ):
   _connection_class = TimeoutHTTPConnection
   def set_timeout( self, timeout ):
       self._conn.timeout = timeout

class TimeoutTransport( xmlrpclib.Transport ):
    def __init__( self, timeout = 10, *l, **kw ):
        xmlrpclib.Transport.__init__( self, *l, **kw )
        self.timeout = timeout
    def make_connection( self, host ):
        conn = TimeoutHTTP( host )
        conn.set_timeout( self.timeout )
        return conn

class TimeoutServerProxy( xmlrpclib.ServerProxy ):
    def __init__( self, uri, timeout = 10, *l, **kw ):
        kw['transport'] = TimeoutTransport( timeout = timeout, use_datetime = kw.get( 'use_datetime', 0 ) )
        xmlrpclib.ServerProxy.__init__( self, uri, *l, **kw )

def runExport(newtimeout):
	#server = xmlrpclib.ServerProxy('http://localhost:8080/rpc/xmlrpc')

		print ("Starting at: "+time.asctime())
		server = TimeoutServerProxy( 'http://localhost:8080/rpc/xmlrpc', timeout = newtimeout )
		token = server.confluence1.login( 'admin', 'admin' )
		key = raw_input( "Enter space key: " )
		vartype = raw_input( "Eport type (xml or html): " )
		if "xml" in vartype.lower():
			type = 'TYPE_XML'
			if "html" in vartype.lower():
				type = 'TYPE_HTML'
			else: print ("Invalid output type.")
		string = server.confluence1.exportSpace( token, key, type )
		exit( string )
	except Exception as e:
		print (time.asctime())
		print (e)
		print (time.asctime())
toset = int(raw_input( "Set Timeout Value in Minutes: " ))*60

You will need to change the details in 'server' and 'token' to match your server URL and login details. When you run the script, set a timeout value in minutes and specify the space key and xml and it should eventually spit out a URL. In local testing, a space with 35000 unique pages, each with one image attached, finished in 16 minutes. Mileage will vary, but you can get a feel for how long you can expect it to take by running a space export in the Confluence UI to establish your baseline.

0 votes
Joe Clark Atlassian Team Nov 02, 2011

I was just about to link you to https://studio.plugins.atlassian.com/browse/CSOAP-74 but I see that you have already commented on that, and it lead you here. :-)

You say you have tried setting CONNECTION_TIMEOUT to 1000 and it times out at around 10 minutes. If your export directly from Confluence takes around 22 minutes, you will probably need to change the timeout value to something even larger.

Try setting CONNECTION_TIMEOUT and SO_TIMEOUT to 1800000, which should give Confluence a 30 minute window to complete the export.

The peculiar thing seems to be that no matter what I specify on the command line for the CONNECTION_TIMEOUT and SO_TIMEOUT, it still bombs out in 10mins. So, somewhere the 10min timeout for something is taking precedence....I'm hoping someone who understands the SOAP API/Java interaction better or who better know how the long running tasks in confluence work can shed some light on this.

From the description in CSOAP-74, this problem has been around a while....

I've sent the same query to the Java folks who happen to sit on my floor - I hope to hear back. It would be so very nice if Confluence would just add a way for a space admin to backup their space on a schedule.

More as I learn it.

Adam - What version of Python are you using? I installed 2.7 (on solaris) and it gave me this error - Set Timeout Value in Minutes: 40
Starting at: Tue Jan 3 11:36:19 2012
Tue Jan 3 11:36:19 2012
TimeoutHTTP instance has no attribute 'getresponse'
Tue Jan 3 11:36:19 2012


More recent versions of the Confluence CLI have a connectionTimeout parameter - Documentation

To get this to work for me, I commented out:

server = TimeoutServerProxy( 'http://localhost:8080/rpc/xmlrpc', timeout = newtimeout )

and uncommented

#server = xmlrpclib.ServerProxy('http://localhost:8080/rpc/xmlrpc')

Because my Space was quite large (3gigs) I also had to increase the amount of memory available. In my setenv.bat file I updated the JAVA_OPTS to be:

set JAVA_OPTS=%JAVA_OPTS% -Xms2056m -Xmx3072m -XX:MaxPermSize=3072m

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

372 views 2 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you