17-2 Installation/Upgrade/License File

17-2-1 What do Antenna House PDF API versions and maintenance release mean?

A version is a combination of a major version (n) and a minor version (m) expressed in the "Vn.m" format. An increase in n is called a major version upgrade, and an increase in m is called a point release version upgrade. A maintenance release version is a product in which the old and new version numbers (n and m in Vn.m) are the same, and only the release date is new. The MR number is written after the version number.

For other details regarding version upgrades, see "Chapter.16 Upgrading" in this manual.

17-2-2 Can I overwrite the maintenance release version (MR) of Antenna House PDF API? What happens to the files then?

[For Windows version]

  • You can overwrite and install the maintenance release version.
  • In overwrite installation, the executable binary file is replaced with a new one, checking the date and file version. Non-executable files such as header files are checked for date and replaced with new ones. It does not replace the license file. If you need to replace the license file, replace it manually.

[For Linux version]

  • Overwrite installation is not available on the Linux version.
  • Uninstall the previous version before installing the maintenance release version. If you have placed the license file in the default installation folder, the license file will also be deleted during uninstallation.

For details on installation, see "Chapter.3 Installation Instructions" of this manual.

17-2-3 When upgrading the version of "Antenna House PDF API", do I need to uninstall the old version?

[For Windows version]

  • Different versions of Antenna House PDF API can be installed on one PC.

[For Linux version]

  • We recommend uninstalling the old version before installing the new version.
    It is also possible to newly install the Linux version in a different directory from the previous version.

17-2-4 A maintenance release version (MR) was released after installing the evaluation version. After that, I purchased the product, but what are the steps to upgrade?

[For Windows version]

  • If you want to update to the maintenance release version (MR), you can perform an overwrite installation. Therefore, you can update it by following these steps: It doesn't matter which order comes first, 1 or 2.
  1. Install the maintenance release version (latest version) over the folder where you installed the old evaluation version.
  2. Replace the license file at the installation destination with the regular license file.

[For Linux version]

  • The Linux version installer cannot be overwritten. Therefore, please uninstall the old evaluation version and then reinstall the maintenance release version.
  • At this time, the license file folder in the installation folder will be deleted during uninstallation.
  • Therefore, place the regular license file after installing the maintenance release version.

For details on installation and uninstallation procedures, see "Chapter.3 Installation Instructions" in this manual.

For details on the location of license files, see "Chapter.4 License File" in this manual.

17-2-5 I have purchased a license for the product version, so I would like to convert the evaluation version to the regular version. What should I do?

The license file (file name [ptalic.dat] (regular license file)) is included in the electronic delivery. Replace [ptalic.dat] in the evaluation version installation folder with the regular version license file included in the delivery.

Alternatively, you can place the official license file in any location and specify the location of the license file using the environment variable [PTL80_LIC_PATH]. For more information, see "Chapter.4 License File" in this manual.

17-2-6 How can I check the information contained in the Antenna House PDF API license file?

You can display license information on screen by running the following command on the Command-line.

AHPDFToolCmd80 -v

For details, see "12-41 -v: Getting Version, Copyright, and License Information" in this manual.

17-2-7 How do I uninstall the Linux version?

The Linux version is provided as an rpm package, so use the rpm -e command to uninstall it.

Next, delete the environment variables [PTL80_LIC_PATH], [PTL80_FONT_CONFIGFILE] and [ PTL80_ICCPROFILE_PATH] if they are set. If you have set any other environment variables, also delete them.

17-2-8 When upgrading Antenna House PDF API, is it necessary to replace the license file (ptalic.dat)?

For major version upgrades, it is necessary to replace the license file. For point release version upgrades, it is not necessary to replace the license file if the version was released within the maintenance period.

A new license file for major version upgrades is available within the maintenance contract period. To obtain one, please request it from the following contact point:

17-2-9 When updating Antenna House PDF API to a maintenance release version, is it necessary to replace the license file [ptalic.dat]?

If Antenna House PDF API maintenance release date falls within the maintenance period specified in the license file, replacing the license file is not required.
To use a maintenance release version released after the maintenance period written in the license file has passed, you must replace the license file with one that has the updated maintenance period.

17-2-10 I was using the regular version of Antenna House PDF API. When I installed a maintenance release version and started it up, a watermark of the evaluation version was output. Why?

The maintenance period for the license file may have expired. You will need to replace the license file with one that has an updated maintenance deadline. If you have already renewed your maintenance contract, replace it with the new license file you received.

For details on obtaining and replacing license files, see "Chapter.4 License File" in this manual.

17-2-11 When I migrated the version, an evaluation version message is output. Who should I contact to issue a new license?

Product upgrades can be requested at the following contact point:

During the maintenance support service period, you can upgrade for free or for a fee that is the difference from the purchase price. For more information, see "Chapter.16 Upgrading" in this manual.

17-2-12 [Windows version] Is it possible to operate Antenna House PDF API without installing VC++ runtime?

The Windows version of Antenna House PDF API is developed using Microsoft's Visual C++ (VC++). Therefore, a runtime library that is binary compatible with the VC++ version used for development is required. The installer will launch the VC++ redistributable package installer if necessary.

17-2-13 [Windows version] What happens if the VC++ runtime exists on the installation destination PC?

The installer for Antenna House PDF API launches the Microsoft VC++ redistributable package installer. When an older VC++ runtime is present in your environment, the Microsoft VC++ redistributable package typically replaces it with the newer one. Note that you may be asked to restart Windows at this time.

17-2-14 [Windows version] When upgrading after uninstalling the current version, the "Setup Failed" screen appears. It seems that if I close this error screen, the installation will continue and end normally, but is there any problem with this procedure?

The Microsoft VC++ redistributable installer may display a "Setup Failed" screen when a newer runtime is present. In this case, if you close the error screen, the installation will continue and complete successfully. Even if "Setup Failed" is displayed, there is no problem in using Antenna House PDF API.