All installations of XMetaL Author are now pre-configured to operate in an environment where end-users are assumed have 'Limited User' account privileges. Programs running under such user accounts are normally restricted from writing to Program Files and similar folders along with writing to Windows HKEY_LOCAL_MACHINE/HKEY_CLASSES_ROOT registry hives. XMetaL Author still has some features that require operating under a Local Admin user account in order to write to the Program Files folder. A prompt will appear warning the user of this restriction.
user_setting_mode=default // Use this value for local-admin environmentsOR
user_setting_mode=per_user // Use this value for limited-user environments - default setting
* Support for Windows XP will be deprecated after this version of XMetaL Author.
Special note for Windows Vista and Windows 7 installations: If you are installing the software from a Limited User account, you must provide an Administrator ID and password in order to run the XMetaL Author installer.
Special note for Windows XP installations: On computers without the Microsoft .NET Framework installed, the installation of XMetaL Author will take more time than usual to complete. To speed up the installation time, the following components of .NET Framework can be be installed beforehand and MUST be installed beforehand if you are using the "XMetaL Author Enterprise.msi":
The following additional software is required for generating output and page previewing for DITA documents:
You must remove all previous versions of XMetaL Author before you install this version.
Registering XMetaL author is required in order for the software to be fully licensed. The license information required for registration is provided by a license file, or by a licensing server at your company.
Uninstalling the software does not unregister the software from an XMetaL License Server.
If you have registered the software using direct licensing (XMdLS) then the software should be unregistered prior to uninstalling. This can be done from within the XMetaL software (
). If you do not do this prior to uninstalling you will need to contact JustSystems and ask to have this computer's license revoked by providing the machine name.If you are running your own XMetaL License Server (XMLS), you may unregister the software from withing the XMetaL software (
), or you may revoke the license from within the XMLS server.The DITA Open Toolkit included with XMetaL Author is required to be deployed separately for each end user. XMetaL Author automatically deploys a per-user copy of the toolkit the first time the end user generates output or does a page preview of a DITA document. Samples files installed in the Program Files folder are also deployed on a per-user basis. Customization files may also be deployed on a per-user basis if they are initially deployed in the Program Files folder.
If you need to re-deploy the DITA Open Toolkit, remove the following folder for each user:
If you need to re-deploy samples, remove the following folder for each user:
If you need to re-deploy customization files deployed in the Program Files folder, remove the corresponding sub-folder for each customization for each user. Note that the folder structure within the following folder mimics the folder structure of the customization files:
If you have specializations, you need to re-integrate them after installing. By default, they will be setup as DITA 1.2 specializations. Adjust DITA Options if DITA 1.1 is needed. Follow these steps:
Note: On Vista or newer with UAC enabled, you must log-in as Administrator or run XMetaL as Administrator.
Note for XMetaL Author Enterprise for Documentum Webtop users: To see all the enhancements and changes for DITA, please ensure that the DocApp is updated accordingly. Updated DocApps are made available with the XMetaL Author 7.0-compatible release of XMetaL Author Enterprise for Documentum Webtop.
If you have DITA Open Toolkit plug-ins, you must re-integrate them after installing. Follow these steps:
Notes:
You can re-run the installer from the Add/Remove Programs Control Panel.
If you have already installed XMetaL Author, the installer gives you various options if you run it again, including the option to uninstall XMetaL Author (see below).
In some cases there may be two or more choices that the installer can make when installing certain components. In this situation a dialog box appears asking for your preference.
You will need to use the XMetaL Author Enterprise.msi file under the xmetal folder to install XMetaL Author silently. Using a license file with the silent installer is optional. If the license file is named xmetal.lic and is placed in the same folder as the XMetaL Author Enterprise.msi file, the installer will automatically use it. Use the XMETAL_LICENSE_PATH parameter when a license file is not in the same folder as the MSI file or the name of the license file is not xmetal.lic. If a license file is not used, the XMETAL_LICENSE_PATH is not required. The license file is provided by JustSystems or by your system administrator.
msiexec /i "path of XMetaL Author Enterprise.msi file" /qn XMETAL_LICENSE_PATH=path of license file
msiexec /x "path of XMetaL Author Enterprise.msi file" /qnTo get more options pertaining to the silent installation, run msiexec in another Command Prompt without any options.
This release of XMetaL Author automatically installs all supported languages for spell checking and the thesaurus including the following
The XMetaL Author Installer Setup program warns you if you do not have permission to install XMetaL Author (for example, if you are logged in as a normal or restricted user). The solution is to install XMetaL Author on Windows by logging in as a user who has administrator privileges.
XMetaL Author is now certified on Citrix Metaframe Presentation Server 4.0. The Citrix-compatible version of XMetaL uses the MSI-type installer and has specific installation prerequisites. There are also some minor functional differences in the software. These and other differences are detailed below.
The Citrix Installation Manager will install the MSI installer silently, so there is no user interaction.
The MSI installer cannot be modified or repaired through Add/Remove Programs. It should be removed only from the Citrix Installation Manager.
No command line parameters are required to un-install.
XMetaL Author has been tested and operates properly when the Citrix drive remap feature is configured. Please ensure XMetaL Author is installed only after drive remap has been applied.
The following additional software is required for the generating output and page previewing:
In Citrix environments, it is expected that the administrator will setup XMetaL Author prior to publishing the application to the Citrix users. If specializations or some pre-configuration is required using these features, the Citrix admin needs to toggle the 'user_setting_mode' variable (see Configuring XMetaL Author).
Application Limits: Check 'Allow only one instance of application for each user'
Application Appearance: Session Window Size: 1024x768
Application Appearance: Colors: High Color (16-bit) or better
Application Location : Check 'Isolate Application'