Troubleshooting Guide
The Troubleshooting Guide contains explanation about common problems, which occur during installation, use and administration of Scroll.
Use Issues
Cannot find the Scroll Link?
This is most probably due to missing permissions. You will have to contact your space admin or system administrator to give you 'Export Space' permissions.
If you are a space admin yourself you should refer to this page for getting a better understanding of the Permissions Concept of Scroll.
Icons which look ok in HTML, render too big in exported PDF
Usually this is a problem of the the resolution set in the icon file. You have to change the resolution of the icon file to 150 dpi.
To change this using IrfanView (Website):
- Open the icon file in IrfanView
- Press Image > Image Information to open the image properties.
- In the line Resolution put in 150x150 and click Change.
- Click on Ok to close the image information.
- Click on File > Save As and save icon as PNG (GIF will not work, as they do not store the resolution).
- After that replace the image referenced by your Confluence page.
Licensing Issues
Scroll displays a license error
In case you get a license error, make sure that you have copied the complete license string including lines with the dashes into the text area. If the problem persists contact support@k15t.com
Administration and Installation Issues
PacketTooBigException: Packet for query is too large
If you use MySQL you may get the following error, when installing or upgrading Scroll:
com.mysql.jdbc.PacketTooBigException: Packet for query is too large (5224044 > 4193280). You can change this value on the server by setting the max_allowed_packet' variable.
If you install through the Plugin Repository, the error looks like this:
To resolve this problem, you need to increase the value for max_allowed_packet. Make sure to set the packed size when starting the server, not the client.
To do so, execute the following:
shell> mysqld --max_allowed_packet=32M
More information:
Atlassian Developer Wiki
MySQL Documentation
Umlauts are not rendered correctly
On some systems the file.encoding is not properly set, which causes Scroll to render Umlauts as question marks. To fix this, add a system property to your Confluence configuration: -Dfile.encoding=cp850
For more information about how to configure system properties refer to this page: http://confluence.atlassian.com/display/DOC/Configuring+System+Properties.
Images attached to Confluence pages do not show up in the export
If the Confluence Base URL is not set correctly and users use absolute URLs to reference images, which are attached to Confluence pages (e.g. !http://localhost:8030/download/attachments/131076/img.jpg?version=1!), Scroll will not be able to download those images.
To fix this set the base URL as described in the Confluence documentation.
Comments (6)
May 12, 2009
Anonymous says:
Hi, it is possible to set up the size of an image? I tried to set up both widt...Hi,
it is possible to set up the size of an image?
I tried to set up both width=100 and width=50% and neither of them is preserved in export.
Mysha
May 12, 2009
Stefan Kleineikenscheidt (K15t Software) says:
Hi Mysha, the size of the image in the PDF is dependent on the resolution of th...Hi Mysha,
the size of the image in the PDF is dependent on the resolution of the image. By default the exporter will resize big images to have the width of the text.
You can do that as described here (Irfan View) or here (Photoshop).
-Stefan
Sep 23, 2009
Anonymous says:
How can I customize header & footer when exporting to PDF ? (i.e. include c...How can I customize header & footer when exporting to PDF ?
(i.e. include corporate logo, page number, revision etc. on each page)
Sep 24, 2009
Stefan Kleineikenscheidt (K15t Software) says:
Scroll 1.0 does not support this directly. Scroll 1.1 will support theme config...Scroll 1.0 does not support this directly. Scroll 1.1 will support theme configuration through UI and by leveraging DocBook's customization layers directly (see http://www.sagehill.net/docbookxsl/).
What you can do with Scroll 1.0 is replacing the following files from in the Scroll.jar:
Oct 09, 2009
Anonymous says:
Hi Stefan, in my company we're also very interested in this feature in order to ...Hi Stefan,
in my company we're also very interested in this feature in order to customize header&footer of our PDF exported files.
In particular we need to have a simple 1-row/3-columns table in the header with the "company logo" in the top left cell, "confluence space name" in the central cell and "page number" in the top right.
Could that be possible in Scroll 1.1? Can you give us a rollout date for the new version?
Thanks
Regards
Marco
Oct 10, 2009
Stefan Kleineikenscheidt (K15t Software) says:
Marco, yes that would be possible with Scroll 1.1. We plan to ship Scroll 1...Marco,
yes that would be possible with Scroll 1.1.
We plan to ship Scroll 1.1 beginning of November.
-Stefan
Add Comment