DITA and XMetaL Discussion
pmasal December 2, 2013 at 11:40 pm
Unable to publish preview with DITA toolkitDecember 2, 2013 at 11:40 pmParticipants 2Replies 3Last Activity 9 years, 1 month ago
When our users try to publish a preview of a DITA topic, they receive the attached error dialog from XMetaL, and no preview is produced.
But when I navigate to C:Userswindows-useridAppDataRoamingSoftQuadXMetaL Shared, unset the readonly box in properties, and apply it to all files and subfolders, I can run the preview again.
Is there any way to avoid this issue? Each time users logoff from windows, the problem happens again, and they must repeat the process.
Big Company Based in Seattle, WADerek Read December 3, 2013 at 12:16 am
Reply to: Unable to publish preview with DITA toolkitDecember 3, 2013 at 12:16 am
By default this folder (and all folders and files in AppData) are not usually readonly. Our software (and the DITA Open Toolkit itself) needs to write to to this location, so these folders must be writable.
Check with your IT people to see what they have configured (anti-virus or other protection) that is making these changes. They will need to adjust things in order for this feature to function.
XMetaL Author Enterprise also writes files one folder up (SoftQuad), so it is at that level down that should be writeable. If the software cannot write to the SoftQuad folder then quite a few other features will be broken as well.pmasal December 5, 2013 at 2:57 pm
Reply to: Unable to publish preview with DITA toolkitDecember 5, 2013 at 2:57 pm
Thanks as always, Derek. Can you tell me where in C:Userswindows-useridAppData the XMetaL preview function must write? I'm using a CMS with XMetaL integration, which downloadsupdates from our internal central server to C:Userswindows-useridAppDataRoamingSoftQuadXMetaL Shared with no worries. That's why it's strange that the preview can't work with our permissions on C:Userswindows-useridAppData. Is there a service account that's trying to access that folder?
Many thanks for any additional help you can give, as this is impacting over 200 users.
PaulDerek Read December 6, 2013 at 12:45 am
Reply to: Unable to publish preview with DITA toolkitDecember 6, 2013 at 12:45 am
When you generate output using the DITA OT the DITA OT is first deployed here for the current Windows user:
So that entire folder (SoftQuad) must be writable.
Note that %appdata% location varies depending on Windows version and IT's configuration of Windows. In your case it sounds like it is located here:
Folders and files for the DITA OT are deployed there (to the path above) by copying them from here (which is where they are installed to):
C:Program FilesCommon FilesXMetaL Shared
That folder doesn't need to be writable after installation but the user does need read permission (which should be default).
There are quite a few files inside %appdata%SoftQuadDITA_OT that are written to by the DITA OT itself when it is running (when you are generating output).
XMetaL Author Enterprise deploys a license for RenderX XEP into the same location inside the RenderX subfolder which is used to generate PDF for deliverables that use RenderX XEP, so that needs to be writable as well.
In addition to the DITA OT needing full read / write access to that location XMetaL Author Enterprise writes configuration and user preference settings to %appdata%SoftQuad (and various subfolders depending on what it is writing).
If %appdata%SoftQuad is left fully read/write for current user then you don't need to worry about the specifics above. I think it would probably be a nightmare to try to lock down individual folders. And to what purpose?
Some files may also be written to the following location (also always read/write for current user by default):
- You must be logged in to reply to this topic.