Effective January 1, 2016, Microsoft has mandated that software vendors digitally sign their products using the SHA256 algorithm. All XMetaL 11.0 and newer products are signed using the mandated SHA256 algorithm. As a result of using this new signing algorithm, attempts to install the software on older unsupported Windows systems such as Windows XP will fail. Please confirm the system requirements are met.
Since the release of version 9.0, the XMetaL software no longer requires an Internet connection to register or unregister a per-seat license. Users with a version 7.0 or 8.0 license file should receive a new license file (e.g. XMAX.lic) as required to activate this software.
For concurrent licenses, a new version of the XMetaL License Server (XMLS) software must be installed. The new XMLS software does not require an Internet connection to register or unregister. A new product license file (e.g. XMLS-XMAX.lic) must be added to your XMLS server. See the new XMLS User Guide for more details.
Note: Older .lic files are incompatible with this version.
Contact your JustSystems Sales representative if you have further licensing-related questions.
The installer lets you choose how to install XMAX.
Note: Do not download and execute the XMAX CAB file on a machine with XMAX installed from the CD. This will cause problems with the uninstallation process. Similarly, do not deploy the Writing Tools installer on a machine with XMAX installed from the CD.
Special note for Windows Vista, Windows 7, 8, and 10 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 XMAX installer.
At the start of the XMAX installation, you will be warned if the Internet Explorer is not installed, or if the version that is installed is an older incompatible version, and you will be given the option to install it.
You can also go to the Web site http://www.microsoft.com/windows/ie/default.htm and download the latest version of Internet Explorer. Internet Explorer is language-specific; if you are using a non-English version of Windows, make sure that you download the version (plus service pack if required) that applies to your system.
Microsoft regularly provides updates to their software. We strongly recommend that you visit Microsoft's web site to get any patches or updates to Microsoft Internet Explorer.
XMAX uses MSXML to enable DTD validation. If you do not have the correct version of this DLL installed, the installer will warn you and give you the option to automatically install it. You can also launch the MSXML Parser Installer from the Web site http://support.microsoft.com/kb/324460/en-us.
Activating your XMetaL XMAX software is required in order to be fully licensed to use the software. The license information required for activation is provided by a license file.
You can uninstall XMAX from Add/Remove Programs on the Control Panel.
This removes all product files (except for files that exist in the WINSYS folder and which may be shared by other products), product shortcut icons, and product registry settings that were created when the product was first installed.
Other types of User Data, which might be files that were created directly by the user or that contain user preferences that a customer may wish to re-use in a later version installation, are not removed at uninstallation time. If you wish to remove them you must remove them manually after uninstallation has completed.
You will need to use the XMetaL XMAX.msi file under the XMX-CD folder to install XMetaL XMAX silently. Using a license file with the silent installer is optional. If the license file is named XMAX.lic and is placed in the same folder as the XMetaL XMAX.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 XMAX.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 XMAX.msi file" /qn XMETAL_LICENSE_PATH=path of license file
msiexec /x "path of XMetaL XMAX.msi file" /qnTo get more options pertaining to the silent installation, run msiexec in another Command Prompt without any options.
Note: Do not download and execute the XMAX CAB file on a machine with XMAX installed from the CD. This will cause problems with the uninstallation process.
To deploy the Writing Tools to users' systems, you must provide your own
mechanism. You can use the property
to determine whether or not you need to install the Writing Tools, and the
[myXMControl].ShowSpellChecker to start the writing tools
if they are already installed.
Note: Vista deployments are not recommended using the stand-alone Writing Tools installer. The spell checker's functionality will be limited and end-users will be required to have administrator privileges and/or UAC turned off.
Certain XMetaL product features are implemented in part by DLLs that are shared with other XMetaL products. When a mix of x86 and x64 XMetaL products are installed on the same machine, uninstall one of them can cause certain features to stop functioning in those XMetaL products still installed on the system.
To correct this issue, goto the Add/Remove Program control panel, select the XMetaL product which is not working, click the "Change" option and wait for the installation wizard to appear. After the installation wizard appears, follow the wizard's instructions and choose the "Repair" option when presented.
Confirm your CPU has a working internet connection and check that there a firewall is not blocking Tcp/ip port 443 as this port (https) is used by XMAX to communicate with a XMetaL license server.
Also check you have unused licenses available to allocate. If you have a XMetaL License server on-site, check with your IT administrator. Otherwise, contact XMetaL Support.
The XMAX Setup program warns you if you do not have sufficient privileges to perform the installation (e.g., if you are logged in as a normal or restricted user). The solution is to install XMAX on Windows by logging in as a User who has Administrative privileges.
If the spellchecker feature is deployed using the stand-alone WritingTools installer, end-users need administrator privileges to perform spellchecks. This stand-alone deployment mechanism isn't recommended for Windows Vista users.
Anti-virus programs sometimes interfere with the installation process, causing the installer to hang, usually within a short time after it starts up. If you encounter this problem, and you have any type of anti-virus program installed on your PC, disable it while you are installing XMAX.
Multiple installations of XMAX on a single machine are not supported.
To prevent multiple installations, installers that call the XMAX installer must be well-configured. When distributing an installer (or uninstaller) that includes the XMAX installer, you should configure your installer as follows:
If a remove or repair operation is initiated but left unattended for a period of time pending additional user input, the installer will display an message noting error code 1730. This is a known issue with the Windows Vista operating system. Please don't leave the install process unattended to get around this issue.