Installation Notes

The notes below tell you things you need to know before installing Open PL/I.

•  Installation Program
•  Microsoft Terminal Server
•  Uninstalling
•  Updating from an Earlier Version
•  Coexistence
•  Permissions
•  Open PL/I and Networks

After installing, you need to install the latest updates from the Micro Focus Product Support Web site. See Updates and Product Support.

Installation Program

• The installation program should start automatically when you insert the Open PL/I CD. If after a few seconds the installation window hasn't appeared, run the installation program as follows:

  x:\setup.exe

  where x: is your CD-ROM drive.

• When installing, you need to be logged in with a user-ID that has write access to the registry structure under HKEY_LOCAL_MACHINE, HKEY_CLASSES_ROOT, and HKEY_CURRENT_USER so the installation software can set the required environment.
• You can only install a particular version of this product once from any one computer. You can install on a different computer from where you are running the installation program, by specifying a network drive when you are asked which drive to install on. However, you will then not be able to install the product onto the computer from where you ran the installation program or to any other computer from the same computer.

Microsoft Terminal Server

• Microsoft Terminal Server is an environment for running multiple instances of a single user product. It is not a platform where a single-user product can be made to perform as a multi-user product.
• You can use Open PL/I with Microsoft Terminal Server. Note that a separate end-user license is required for each user who accesses Open PL/I, even if the product is running on a single machine. See your End User License Agreement.
• To install onto a terminal server, log on to the physical terminal server with a user ID that has administrator privileges. Then use Control Panel > Add/Remove Programs and follow the instructions on the screen.
• When you install the product on Microsoft Terminal Server or similar terminal software, do not execute more than one installation at the same time.
• When you install Microsoft Terminal server, you must assign a unique port address to each user. Then the very first time that each user logs into Open PL/I and starts the terminal server, he or she should:
  1. Select Options > Project > Port address for Web Server.
  2. Type in the assigned port address.

  This is necessary because the default port address for the Web server is 80. Once this has been allocated to the first user, when the next user attempts to start the Web server, the software recognizes that this port is in use and rejects the attempt. Consequently each user requires an individual port address.

Uninstalling

• To uninstall Open PL/I you must be logged in with the same user-ID as when you installed it.
• To uninstall Open PL/I, you cannot simply delete its files from your hard disk. Instead, you uninstall by using Control Panel > Add/Remove Programs, on most Windows systems. You might need to ensure that Show Updates (at the top of the Add or Remove Programs dialog) is checked, so that any hot fixes or WrapPacks are listed.

  When you unistall, the only files deleted are those that the installation software installed. If your Open PL/I folder has not disappeared, delete any unwanted files and subfolders within it using Windows Explorer.

• To uninstall Open PL/I using a command prompt use the following command:

  start /wait msiexec.exe /x {GUID_To_Uninstall} 

  Where GUID_To_Uninstall is the 32-digit GUID of the product to uninstall.

  To find out the GUID of an installed program:

  1. In the Registry Editor, in the left-hand pane, highlight the folder \My Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Micro Focus.
  2. In the right-hand pane, note the GUID in the Name column for SOFTWARE\Micro Focus\Open PLI\8.0\Setup.
• To uninstall an Open PL/I WrapPack, HotFix or other patch and restore a previous release, run the following command all on one line (don't split it across lines, which is done here to make it easier to read):

  start /wait msiexec.exe  /i {GUID_To_Restore} 
              MSIPATCHREMOVE={GUID_To_Uninstall} 
              CHECKPREREQLIST=""

  Where:

  • GUID_To_Restore is the 32-digit GUID of the product to restore
  • GUID_To_Uninstall is the 32-digit GUID of the product to uninstall
  • You should not specify the switch CHECKPREREQLIST="", if you have Microsoft Visual Studio installed

Repairing

• If any product files, registry settings or shortcuts are accidentally removed at any point, you can perform a Repair on the installation to replace them. To do this, use Control Panel > Add/Remove Programs and follow the instructions on the screen.

Updating from an Earlier Version

• See the New Features section of this Readme.
• If you should want to replace this version by an earlier version, you must uninstall this version before installing the earlier version.
• Your Setup run to upgrade to this version must be run on the same computer where you ran Setup when you installed the earlier version. (This question arises if you run Setup across a network, so the computer where you run Setup is not the one you are installing the product onto.)

Coexistence

• You can have this version of Open PL/I installed on the same computer as previous versions, enabling you to use any of them simultaneously. You must, however, install earlier versions before this one.
• If you have more than one version of Open PL/I on the same computer and have updated your PATH to specify any Open PL/I folders, you need to make sure that PATH specifies the folders for the version of Open PL/I that you are intending to use. For example, if you have Open PL/I versions 8.0 and 7.0 on the same computer and are running version 8.0, you must ensure that your PATH includes folders from Open PL/I version 8.0 instead of version 7.0.

Permissions

• To use Open PL/I you must have permissions set to full control for the following folders:
  • \Program Files\Micro Focus\Open PLI 8.0
  • \Documents and Settings\All Users\Micro Focus\mfuser

  Note that the folders above are the default names which might not be the names used in your installation.

Open PL/I and Networks

• We do not recommend or support installing Open PL/I for running across a Wide Area Network.