XMetaL® Developer 7.0

Installation Notes

System Requirements

XMetaL® Developer is a plug-in to Microsoft® Visual Studio® .NET. Your system must have one of the Microsoft Visual Studio .NET standard language products, e.g., Microsoft Visual Basic® .NET Standard, or alternatively Visual Studio .NET Enterprise or Professional versions installed prior to installing XMetaL Developer. See http://msdn.microsoft.com/vstudio/.

Your operating system must meet the system requirements for VS.NET for your particular Windows version. XMetaL Developer supports the following:

* Support for Windows XP will be deprecated after this version of XMetaL Developer.

In addition, your system must have the following, or higher:

Required Memory:

XMetaL Developer runs on the following operating systems:

Before you begin

This version of XMetaL Developer can only be installed beside like versions of XMetaL Author and XMetaL XMAX (i.e. v7.0).

For correct XMetaL Author customization debugging behavior, your XMetaL Author software must be v7.0.0.110 or newer (see Installations Issues below).

If you are upgrading from a previous release, you need to run Add/Remove Programs and remove any previous versions of XMetaL Developer before you install XMetaL Developer 7.0.

Note: If you plan on using the XMetaL Java API Toolkit included with XMetaL Developer, it's recommended that you install the Sun JRE before installing XMetaL Developer.

Installing XMetaL Developer

Prior to installing XMetaL Developer, you must have already installed Microsoft Visual Studio .NET Standard Edition or higher.

To install XMetaL Developer

  1. Run the downloaded .exe file (or setup.exe if you received XMetaL on disk) from Windows Explorer or from the Windows Run dialog.
  2. Click Install XMetaL Developer. This launches the installer.
  3. Proceed with the installation, following the on-screen directions.

Reinstalling or uninstalling XMetaL Developer

You can re-run the installer by selecting XMetaL Developer from the Add/Remove Programs Control Panel.

If you have already installed XMetaL Developer, the installer presents various options if you run it again, including the option to uninstall XMetaL Developer. See the sectionMaintenance installations below for more information.

Installing Microsoft Internet Explorer

You must have certain components of Microsoft Internet Explorer, version 6.00.2600.0000 or above, installed on your PC in order for XMetaL Author Enterprise to function.

At the start of the XMetaL Author Enterprise installation, you will be warned if 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 this 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.

Updates to MSIE

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.

Installing Microsoft Data Access Components

The XMetaL Database Import wizard requires Microsoft Data Access Components (MDAC) to be installed on your PC in order to function.

At the start of the XMetaL Author Enterprise installation, you will be warned if MDAC 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 launch the MDAC Installer from your XMetaL CD (in the redist folder). Alternatively, you can go to the Web site http://www.microsoft.com/data/ and look for "MDAC 2.1.2.4202.3 (GA) Typical install for x86" or greater (later versions are referred to as RTM instead of GA).

The Database Import wizard will not function unless these components are installed before XMetaL Author Enterprise is installed. If you have already installed XMetaL Author Enterprise, and the Database Import wizard fails with one of the following errors:

Automation server can't create object
ODBC Driver manager: Failed to load resource DLL odbcint.dll

then you should uninstall XMetaL, make sure the required components are installed, and then re-install XMetaL.

Document viewers

Viewers for PDF documents are available at the following locations:

PDF: http://www.adobe.com/products/acrobat/readermain.html

After installation

After the installer is finished, you must reboot your system prior to launching XMetaL Developer for the first time. If you do not, you may experience unpredictable behavior.

Maintenance installations

You can perform various additional installation tasks after you have installed the product for the first time. For example, you might want to do one of the following:

Note: In order to be able to perform maintenance installations (except for the 'Remove' option), you will need to have the files that you unpacked during the initial installation still available. If you installed from a CD you will need the CD media again.

To access the Maintenance installer

  1. Choose Settings from the Start menu, and then Control Panel.
  2. Double-click Add/Remove Programs.
  3. Select XMetaL Developer.
  4. Click Change/Remove.

    If you have already successfully installed this version of XMetaL Developer, you will see a dialog box that gives you three options: Modify, Repair, and Remove.

  5. Select an option and click Next.

Modify

  1. Select Modify if you want to modify your existing installation. For example, you might want to add some components or remove some unwanted components.
  2. You will see a custom dialog that enables you to remove old components and add new components. Components that are already installed are initially selected. You can now make additional selections, or deselect currently selected components. Grey check boxes indicate required components.
  3. Click Next.
  4. In some cases there may be two or more choices that the installer can make when installing certain components. In this situation a dialog appears asking for your preference.
  5. In the final dialog, confirm your choices and click OK to carry out the modifications.

All of the unselected components will be removed, and all of the selected components will be installed.

Repair

Select Repair if you suspect that the currently installed product has become corrupted in some way. Repair will reinstall the same set of components that were installed in the previous installation.

Note: Any files that you downloaded must still be available on your hard drive if you choose this option.

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.

Remove

  1. Select Remove if you want to uninstall the complete product. Click Next.
  2. Click OK, then wait while XMetaL uninstalls.
  3. Click Finish .
  4. Reboot your computer.
  5. At the DOS command prompt, run the command: 
    devenv.exe /setup
    Note that devenv.exe is normally found in C:\Program Files\Microsoft Visual Studio .NET\Common7\IDE.

Notes about uninstallation

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. Such files may exist here:

Installation issues

Debugging customization hangs

Confirm that XMetaL Author (xmetal70.exe) is version 7.0.0.110 or higher. If the version is lower, download the latest XMetaL Author Enterprise software (available at the same ftp link as before), uninstall your current version and reinstall the newly download software.

Program entry left-over after upgrading to XMetaL Developer 7.0

After you upgrade to XMetaL Developer 7.0, you may see a program entry in Add/Remove programs left-over from a previous version. You can safely remove the old program entry.

Installing XMetaL without Administrative Privileges

The XMetaL Developer Installer Setup program will warn 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 XMetaL Developer by logging in as a User who has Administrative privileges.

DLL unregistration error

Symptom

Dialog boxes displaying the following unregistration errors might appear during uninstallation of XMetaL Developer 4 (if you are uninstalling XMetaL 4 prior to installing XMetaL 7.0):

Error 1905. Module "C:\Program Files\Corel\XMetaL 4\Developer\Bin\XMWizard.dll" failed to unregister. HRESULT...
Error 1905. Module "C:\Program Files\Corel\XMetaL 4\Developer\Bin\DTDDataProvider.dll" failed to unregister. HRESULT...
Error 1905. Module "C:\Program Files\Corel\XMetaL 4\Developer\Bin\CTMDataProvider.dll" failed to unregister. HRESULT...
Cause

Uninstalling the core XMetaL Developer after uninstalling an XMetaL Service Pack causes the error.

Workaround

You can safely ignore the unregistration errors.

Anti-virus program interference

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 computer, disable it while you are installing XMetaL.