| Previous | Contents | Index |
Oracle CDD/Repository Version 6.1A is supported by ACMS Version 4.x. Oracle CDD/Repository Version 6.1 is not supported by ACMS Version 4.x. An access violation occurs if ACMS attempts to access the dictionary.
The following paragraphs discuss the requirements for Oracle CDD when installing the different ACMS kit types.
If you are installing the ACMS development kit, at least the minimum version of CDD as identified in the ACMS SPD must be installed on your system. If CDD is not installed or if a lower version of CDD is installed, VMSINSTAL terminates the installation procedure.
If you are installing the ACMS run-time kit, CDD is optional; however, the minimum version of CDD is required for the run-time kit to be fully functional. Specifically, if you install the ACMS run-time kit with CDD available, you can create new applications and menus and modify existing applications and menus, on your ACMS run-time system. If you install the ACMS run-time kit without CDD available, you can use only existing applications and menus; you cannot create new ones on your run-time system. If you subsequently install CDD, you can make the ACMS run-time CDD-related features available by reinstalling the ACMS Version 4.3 run-time kit and choosing the CDD-related files option at the beginning of the installation.
If you are installing the ACMS remote-access kit, CDD is not required.
1.4.3 Requirements for LSE
LSE is an optional layered product for all ACMS kits. If the minimum
version (or a higher, allowed version) of LSE as identified in the ACMS
SPD is not available when you install ACMS, LSE templates for ACMS
Version 4.3 are not provided on your system. If you
subsequently install LSE, you can make the ACMS Version 4.3
LSE templates available by reinstalling the ACMS Version 4.3
kit and choosing the LSE update option at the beginning of the
installation.
1.4.4 Requirements for TP Desktop Connector
Compaq TP Desktop Connector for OpenVMS is an optional layered product for ACMS. If you are installing TP Desktop Connector on a system with ACMS Version 4.0 or higher, you must have at least the minimum version of the TP Desktop Connector as identified in the ACMS SPD.
If the ACMS installation runs while TP Desktop Connector is running, the results are unpredictable. Use the following command to shut down TP Desktop Connector before you begin an installation of ACMS:
$ @SYS$STARTUP:ACMSDI$SHUTDOWN.COM |
To ensure problem-free installation of software on your system, install the OpenVMS operating system and layered products in the following order:
Upgrading software in a distributed transaction processing system is complex because of the dependencies among the software products. The process becomes even more complex when you take into account the dependencies that are created from multiple versions that exist for each of the individual software products.
Because you cannot upgrade all nodes in a distributed environment
simultaneously, and because the upgrade process might last several
days, a clear methodology is required to ensure smooth and timely
introduction of new software versions.
1.5.1 Configuration Issues
A simple, distributed configuration in a TP system consists of an ACMS front-end node and an ACMS back-end node. You can configure ACMS on each node for the processing of specific tasks. Likewise, the roles of the layered products on each node are distinct. For simple configurations, the upgrade process is straightforward:
Upgrading in this order ensures that the system delivers the same version of software to the front-end node and the back-end node.
However, this simple rule cannot be applied to a configuration in which a node is both a front end and a back end. To successfully upgrade a more complex configuration, apply these two key points:
To upgrade software in a distributed system, follow these steps:
Do not modify by recompilation any application components (unless required by the installation procedure) until you upgrade all the nodes that compose the distributed application. |
Keep in mind the following dependencies when upgrading software, especially in a distributed environment:
This chapter discusses the preparations and requirements necessary for installing ACMS Version 4.3.
ACMS provides online release notes and gives you the option of printing or displaying the release notes during the installation procedure. Compaq strongly recommends that you read the release notes before proceeding with the installation in case they contain some important information regarding the installation procedure.
The sections in this chapter describe requirements that are checked by
the ACMS installation procedure. With the exception of optional layered
products, your system must meet these requirements before you can
install ACMS successfully.
2.1 Backing Up Your System Disk
At the beginning of the installation, VMSINSTAL asks whether you have backed up your system disk. Compaq recommends that you back up your system disk before installing any software.
Use the backup procedures that have been established at your site to do
this backup. For details about performing a system disk backup, see the
section on the Backup Utility in the OpenVMS documentation set.
2.2 Software Versions
As discussed in Section 1.4, ACMS Version 4.3 requires
minimum versions of a number of layered products. The installation
procedure lists all layered products that do not meet or exceed the
required minimum version. The ACMS Software Product Description (SPD)
identifies the minimum software versions of required and optional
products. If any required products are below minimum version, the
installation fails.
2.2.1 Installed Images
In order to use other layered products during the installation of ACMS, certain executable images related to those products must be installed using the DCL command INSTALL. These images are normally installed by executing the startup procedure for the product. These startup procedures should be executed automatically when the system is started. Startup procedures are found in SYS$STARTUP.
To determine whether an image is installed, execute the following DCL command:
$ INSTALL LIST file-specification |
If an image is not installed, you must execute the related product startup procedure; also ensure that this startup procedure is executed automatically during system startup.
If you are installing the ACMS development kit, the CDD image SYS$LIBRARY:CDDSHR.EXE must be installed. If you are installing the ACMS run-time kit, this is optional; however, if the image is not installed, CDD-related files will not be made available. The CDD startup procedure is CDDSTRTUP.COM.
To use CDD, Rdb must also be available. Therefore, if you are installing the ACMS development kit, or if you plan to use the CDD-related function of the ACMS run-time kit, the Rdb image SYS$LIBRARY:RDBSHR.EXE must be installed. The Rdb startup procedure is RMONSTART.COM.
If you have Oracle Trace installed on your system and you want the ACMS
facility definition updated during the installation, the Oracle Trace
image SYS$LIBRARY:EPC$FUNCSHRP.EXE must be installed. The Oracle Trace
startup procedure is EPC$STARTUP.COM.
2.3 Privileges
To install ACMS, you must be logged in to the SYSTEM account, or any account with similar privileges. The SYSTEM account has all the privileges required for the installation.
Table 2-1 lists the privileges required to execute various steps of the installation.
| Step | Required Privileges |
|---|---|
| Installation procedure | BYPASS |
| Postinstallation procedure | BYPASS, SYSPRV, SYSNAM, CMEXEC, OPER |
| Installation Verification Procedure | OPER, SYSPRV, SYSNAM, CMKRNL |
The following sections describe the approximate disk space requirements
for a normal installation, and an option for installing ACMS on a
system disk with limited space available.
2.4.1 Disk Space for a Normal Installation
Installing ACMS requires a certain amount of free storage space during the installation. Once ACMS is installed, less storage space is required. Table 2-2 and Table 2-3 summarize the approximate storage requirements for ACMS during and after installation. These tables reflect the installation of full kits, with all options selected.
| Kit | Blocks During Installation |
Blocks After Installation |
|---|---|---|
| Development | 45,000 | 28,000 |
| Run-time | 32,000 | 22,000 |
| Remote-access | 22,000 | 14,000 |
| Kit | Blocks During Installation |
Blocks After Installation |
|---|---|---|
| Development | 43,000 | 40,700 |
| Run-time | 34,500 | 33,200 |
| Remote-access | 23,700 | 22,400 |
If you are installing only some parts of the ACMS kits, you need less disk space for the installation. Table 2-4 and Table 2-5 list the approximate amount of space required for each optional component of the ACMS kits.
| Component | Blocks During Installation |
Blocks After Installation |
|---|---|---|
| Development software 1 | 35,000 | 23,000 |
| Run-time software | 27,000 | 16,000 |
| Remote-access software | 22,000 | 14,000 |
| ACMS samples | 3,300 | 1,500 |
| ACMS Request Interface samples | 6,000 | 3,900 |
| CDD-related files | 6,000 | 5,500 |
| LSE-related files | 6,200 | 600 |
| Component | Blocks During Installation |
Blocks After Installation |
|---|---|---|
| Development software 1 | 30,000 | 17,200 |
| Run-time software | 21,000 | 12,600 |
| Remote-access software | 18,000 | 11,000 |
| ACMS samples | 1,900 | 1,300 |
| ACMS Request Interface samples | 2,900 | 2,700 |
| CDD-related files | 6,000 | 3,600 |
| LSE-related files | 600 | 100 |
To determine the number of free disk blocks on your system disk, enter the following command:
$ SHOW DEVICE SYS$SYSDEVICE |
If your system disk has less space than indicated in Section 2.4.1, and if you have previously installed ACMS on your system disk, you may be able to install ACMS Version 4.3 by using the VMSINSTAL Alternate Working Device (AWD) option.
The AWD option allows you to specify another disk device on which VMSINSTAL creates its temporary working directory.
For a normal Compaq ACMS Version 4.3 for OpenVMS Alpha development kit installation, VMSINSTAL creates the following temporary working directory:
SYS$SPECIFIC:[SYSUPD.ACMSDEVA_043] |
For an AWD installation of the same kit, the VMSINSTAL temporary working directory is:
alternate-working-device:[000000.ACMSDEVA_043] |
The space required during installation indicated in Section 2.4.1 must be available on the alternate working device; this space will be available again after the installation is complete. You must still have at least 5000 blocks available on the system disk to use the AWD option.
The AWD installation assumes that the ACMS Version 4.3 is no more than 5000 blocks larger than the ACMS kit currently installed on your system. If the AWD installation does not work, you must make the required disk space available for a normal installation before installing ACMS. |
To determine the number of free disk blocks on your system disk and alternate working device, execute the following commands:
$ SHOW DEVICE SYS$SYSDEVICE $ SHOW DEVICE alternate-working-device |
If disk quotas are enabled on the system disk, the ACMS Installation Verification Procedure (IVP) fails. The ACMS installation procedure normally schedules the IVP to execute automatically after the installation is completed. However, if disk quotas are enabled, the installation procedure cancels the IVP and notifies you. You can choose to stop the installation and address the issue, or continue the installation and execute the IVP manually at a later time.
To determine whether disk quotas are enabled, execute the following DCL command:
$ SHOW QUOTA/DISK=SYS$SYSDEVICE |
Table 2-6 and Table 2-7 list the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings.
| System Parameter | Value |
|---|---|
| CLISYMTBL 1 | 500 |
| GBLPAGES 2 | n + 6,000 |
| GBLPAGFIL | 2,048 |
| GBLSECTIONS 2 | n + 55 |
| PQL_DASTLM 3 | 20 |
| PQL_DBIOLM 3 | 12 |
| PQL_DDIOLM 3 | 20 |
| PQL_MDIOLM 3 | 20 |
| VIRTUALPAGECNT | 19,000 |
| System Parameter | Value |
|---|---|
| CLISYMTBL 1 | 500 |
| GBLPAGES 2 | n + 3,500 |
| GBLPAGFIL | 2,048 |
| GBLSECTIONS 2 | n + 55 |
| PQL_DASTLM 3 | 20 |
| PQL_DBIOLM 3 | 12 |
| PQL_DDIOLM 3 | 20 |
| PQL_MDIOLM 3 | 20 |
| VIRTUALPAGECNT | 19,000 |
The following sections describe how to check system parameter values, calculate values for the GBLPAGES and GBLSECTIONS system parameters, change parameter values with the OpenVMS AUTOGEN command procedure, and set the CLISYMTBL dynamic system parameter with the OpenVMS System Generation Utility (SYSGEN).
| Previous | Next | Contents | Index |