----------------------------------------------------------------------------- C O M P A Q C O M P U T E R C O R P O R A T I O N Compaq Support Paq for Novell NetWare Help Version 1.06a ----------------------------------------------------------------------------- 1. What is a Compaq Support Paq (CSP) 2. Minimum Requirements for the CSP 2.1 Minimum OS Requirements for the CSP 2.2 NetWare Red-box Installation 3. Contents of CSP v1.06a 3.1 NetWare v6.0 CSP 3.2 NetWare v5.1 CSP 3.3 NetWare v4.2 CSP 3.4 New features included in this CSP 3.5 New and updated drivers/components in this CSP 4. Software Installation 4.1 Command Line Deployment Using CPQDPLOY.NLM 4.2 Graphical (NUT-based) Deployment using CPQDPLOY.NLM 4.3 Command-Line by Individual Package 4.4 Graphical (NUT-based) Deployment by Individual Package 4.5 CPQSETUP.NLM (Individual Component Installer) after Component Extraction 4.6 List of Command-line parameters 4.7 Installation Examples 5. Log files 6. FAQ ----------------------------------------------------------------------------- 1. What is a Compaq Support Paq (CSP) A Compaq Support Paq (CSP) is a bundle of software packages. Each package contains an individual driver, utility, or agent software which comes self-contained with all of the necessary support software for that package. As an example, the storage driver package containing CPQSCSI.HAM will have the associated Novell and Compaq NWPA files, such as NWPA.NLM and CPQSHD.CDM, that were used during Compaq's rigorous software testing included in the package. Each package contains an NLM extraction utility to unpack the compressed package contents. CPQDPLOY.NLM is provided as a package manager for installation of multiple packages, either through command-line or a NUT-based interface. CPQDPLOY.NLM uses a bundle XML definition file in the format (BP000xxx.XML) to determine what packages belong in a bundle, which operating systems are supported, and other relevant information. Each package is also installable individually through either its own command-line or NUT-based interface. Each individual package has a unique package number assigned to it by Compaq. The packages will always have the format CP0xxxxx.NLM. *NOTE: The CSP is Compaq's replacement for the now withdrawn CPQNSSU (NSSD) utility. The purpose of a CSP is to provide customers with the latest software, utilities, and drivers for Compaq Proliant servers. 2 Minimum Requirements for the CSP 2.1 Minimum OS Requirements for the CSP The CSP currently is shipped in separate bundles for NetWare v4.2, NetWare v5.1, and NetWare v6.0. Each bundle will only run on the version of NetWare it supports. The CSP expects that you have at a minimum the following requirements: NetWare v4.2 Base installation plus the CLIBAUX1.EXE (CLIBAUX.NLM) patch which is available at http://support.novell.com. Support Pack 9 contains the above NLM and is the recommended minimum support pack level. The CLIBAUX.NLM is also provided as part of the CSP for NetWare v4.2. NetWare v5.1 Base installation. However, Support Pack 2a or later is recommended. NetWare v6.0 Base installation. *NOTE: Failure to obtain the CLIBAUX1.EXE patch will cause the NetWare v4.2 CSP deployment to fail with an unresolved external "_closedir_510". *NOTE: Small Business versions of the above versions of NetWare are also supported. The CSP is intended to be used after OS installation to update drivers and install Compaq-specific utilities (such as Power Management, Health, etc), agents (Foundation, Server, LAN, and Storage), and Compaq Survey. 2.2 NetWare Red-box installation While the CSP cannot be used during initial NetWare red-box installation, Compaq does provide the necessary drivers for red-box installation on the Smart Start CD in the \CPQSUPSW\NSSD\(OS version)\disk1 and \CPQSUPSW\NSSD\(OS version)\disk_2 subdirectories in flat file format. Support for red-box installations can be accomplished by copying the contents of the above directories off the Smart Start CD into the C:\NWUPDATE directory on the server for NetWare v4.2 and v5.1 or the C:\NWINST.TMP directory for NetWare v6.0 after the hard drive has had a DOS partition defined and formatted, but prior to NetWare's driver detection. After the installation has completed, use the CSP as described in Section 4 to 'complete the server'. 3. Contents of CSP v1.06a 3.1 NetWare v6.0 CSP CPQDPLOY.NLM v1.06a BP000063.XML Bundle installation XML file for CPQDPLOY.NLM CPQCSP.TXT This file CP001332.NLM Supports the Compaq Array adapters (CPQARRAY.HAM) CP001333.NLM Supports the Compaq SCSI adapters (CPQSCSI.HAM) CP001334.NLM Supports the Adaptec 160M adapters (ADPT160M.HAM) CP001335.NLM Supports the Compaq Fibre Channel Adapters (CPQFC.HAM) CP001336.NLM Supports the Compaq NetFlex-3 Ethernet Adapters (CPQNF3.LAN) CP001337.NLM Supports the Compaq Netelligent Token-Ring Adapters (CPQTRODI.LAN) CP001338.NLM Supports the IBM 16/4 Token-Ring Adapters (IBMTRPO.LAN) CP001339.NLM Supports the Compaq N100 Fast-Ethernet Adapters (N100.LAN) CP001340.NLM Supports the Compaq N1000 Gigabit Ethernet Adapters (N1000.LAN) CP001341.NLM Supports the SysKonnect FDDI Adapters (SKFPNW.LAN) CP001342.NLM Supports the AMD ISA Ethernet Adapters (PCNTNW.LAN) CP001343.NLM Supports the Compaq Remote Insight Adapter (CPQRI.NLM) CP001344.NLM Provides the Compaq Multi-Processor Driver (CPQMPK.PSM) CP001345.NLM Provides the Compaq Health Drivers (CPQHLTH.NLM) CP001346.NLM Provides the Compaq Array Configuration Utility (CPQONLIN.NLM) CP001347.NLM Provides the Compaq Integrated Management Log Viewer (CPQIML.NLM) CP001348.NLM Provides the Compaq Hot-Plug PCI Support (CPQSBD.NLM) CP001349.NLM Provides the Compaq Power Management Utility (CPQPOWER.NLM) CP001350.NLM Provides the Compaq Standby Server Recovery Option support (CPQRSO.NLM) CP001351.NLM Supports the Compaq RAID adapters (CPQRAID.HAM) CP001353.NLM Provides the Enhanced Integrated Management Utility (CPQEIMD.NLM) CP001355.NLM Provides the Compaq Foundation Agent (CPQHOST.NLM) CP001356.NLM Provides the Compaq Server Agent (CPQBSSA.NLM) CP001357.NLM Provides the Compaq NIC Agent (CPQNCSA.NLM) CP001358.NLM Provides the Compaq Storage Agent (CQMGSTOR.NLM) CP001359.NLM Provides the Compaq Survey Utility (SURVEY.NLM) CP001361.NLM Provides the Compaq iLO Management Interface Driver (CPQCI.NLM) CP001364.NLM Provides the Compaq NC67xx/NC77xx Gigabit Ethernet NIC Driver (Q57.LAN) CP001425.NLM Provides the Compaq NC67xx/NC77xx Gigabit Ethernet NIC Teaming Driver (QASP.LAN) 3.2 NetWare v5.1 CSP CPQDPLOY.NLM v1.06a BP000064.XML Bundle installation XML file for CPQDPLOY.NLM CPQCSP.TXT This file CP001309.NLM Supports the Compaq Array adapters (CPQARRAY.HAM) CP001310.NLM Supports the Compaq SCSI adapters (CPQSCSI.HAM) CP001311.NLM Supports the Adaptec 160M adapters (ADPT160M.HAM) CP001312.NLM Supports the Compaq Fibre Channel Adapters (CPQFC.HAM) CP001313.NLM Supports the Compaq NetFlex-3 Ethernet Adapters (CPQNF3.LAN) CP001314.NLM Supports the Compaq Netelligent Token-Ring Adapters (CPQTRODI.LAN) CP001315.NLM Supports the IBM 16/4 Token-Ring Adapters (IBMTRPO.LAN) CP001316.NLM Supports the Compaq N100 Fast-Ethernet Adapters (N100.LAN) CP001317.NLM Supports the Compaq N1000 Gigabit Ethernet Adapters (N1000.LAN) CP001318.NLM Supports the SysKonnect FDDI Adapters (SKFPNW.LAN) CP001319.NLM Supports the AMD ISA Ethernet Adapters (PCNTNW.LAN) CP001320.NLM Supports the Compaq Remote Insight Adapter (CPQRI.NLM) CP001321.NLM Provides the Compaq Multi-Processor Driver (CPQMPK.PSM) CP001322.NLM Provides the Compaq Health Drivers (CPQHLTH.NLM) CP001323.NLM Provides the Compaq Array Configuration Utility (CPQONLIN.NLM) CP001324.NLM Provides the Compaq Integrated Management Log Viewer (CPQIML.NLM) CP001325.NLM Provides the Compaq Hot-Plug PCI Support (CPQSBD.NLM) CP001326.NLM Provides the Compaq Power Management Utility (CPQPOWER.NLM) CP001327.NLM Provides the Compaq Standby Server Recovery Option support (CPQRSO.NLM) CP001328.NLM Supports the Compaq RAID adapters (CPQRAID.HAM) CP001330.NLM Provides the Enhanced Integrated Management Utility (CPQEIMD.NLM) CP001331.NLM Supports the Compaq MegaIDE IDE adapters (MEGAIDE.HAM) CP001355.NLM Provides the Compaq Foundation Agent (CPQHOST.NLM) CP001356.NLM Provides the Compaq Server Agent (CPQBSSA.NLM) CP001357.NLM Provides the Compaq NIC Agent (CPQNCSA.NLM) CP001358.NLM Provides the Compaq Storage Agent (CQMGSTOR.NLM) CP001359.NLM Provides the Compaq Survey Utility (SURVEY.NLM) CP001360.NLM Provides the Compaq iLO Management Interface Driver (CPQCI.NLM) CP001363.NLM Provides the Compaq NC67xx/NC77xx Gigabit Ethernet NIC Driver (Q57.LAN) CP001424.NLM Provides the Compaq NC67xx/NC77xx Gigabit Ethernet NIC Teaming Driver (QASP.LAN) CP001561.NLM Provides the Compaq Integrated Ultra ATA-100 Dual Channel Driver (MEGARIDE.HAM) CP001589.NLM Provides the Compaq Integrated ATA RAID Management Utility (SPY.NLM) 3.2 NetWare v4.2 CSP CPQDPLOY.NLM v1.06a BP000065.XML Bundle installation XML file for CPQDPLOY.NLM CPQCSP.TXT This file CLIBAUX.NLM CLIB Extensions necessary to support the CSP. CP001286.NLM Supports the Compaq Array adapters (CPQARRAY.HAM) CP001287.NLM Supports the Compaq SCSI adapters (CPQSCSI.HAM) CP001288.NLM Supports the Adaptec 160M adapters (ADPT160M.HAM) CP001289.NLM Supports the Compaq Fibre Channel Adapters (CPQFC.HAM) CP001290.NLM Supports the Compaq NetFlex-3 Ethernet Adapters (CPQNF3.LAN) CP001291.NLM Supports the Compaq Netelligent Token-Ring Adapters (CPQTRODI.LAN) CP001292.NLM Supports the IBM 16/4 Token-Ring Adapters (IBMTRPO.LAN) CP001293.NLM Supports the Compaq N100 Fast-Ethernet Adapters (N100.LAN) CP001294.NLM Supports the Compaq N1000 Gigabit Ethernet Adapters (N1000.LAN) CP001295.NLM Supports the SysKonnect FDDI Adapters (SKFPNW.LAN) CP001296.NLM Supports the AMD ISA Ethernet Adapters (PCNTNW.LAN) CP001297.NLM Supports the Compaq Remote Insight Adapter (CPQRI.NLM) CP001298.NLM Provides the Compaq Multi-Processor Driver (CPQSMP.PSM) CP001299.NLM Provides the Compaq Health Drivers (CPQHLTH.NLM) CP001300.NLM Provides the Compaq Array Configuration Utility (CPQONLIN.NLM) CP001301.NLM Provides the Compaq Integrated Management Log Viewer (CPQIML.NLM) CP001302.NLM Provides the Compaq Hot-Plug PCI Support (CPQSBD.NLM) CP001303.NLM Provides the Compaq Power Management Utility (CPQPOWER.NLM) CP001304.NLM Provides the Compaq Standby Server Recovery Option support (CPQRSO.NLM) CP001305.NLM Supports the Compaq RAID adapters (CPQRAID.HAM) CP001307.NLM Provides the Enhanced Integrated Management Utility (CPQEIMD.NLM) CP001355.NLM Provides the Compaq Foundation Agent (CPQHOST.NLM) CP001356.NLM Provides the Compaq Server Agent (CPQBSSA.NLM) CP001357.NLM Provides the Compaq NIC Agent (CPQNCSA.NLM) CP001358.NLM Provides the Compaq Storage Agent (CQMGSTOR.NLM) CP001359.NLM Provides the Compaq Survey Utility (SURVEY.NLM) CP001362.NLM Provides the Compaq NC67xx/NC77xx Gigabit Ethernet NIC Driver (Q57.LAN) CP001423.NLM Provides the Compaq NC67xx/NC77xx Gigabit Ethernet NIC Teaming Driver (QASP.LAN) 3.4 New features included in this CSP There are many new features and enhancements to this version of the CSP. Among the many enhancements are: o Support for NetWare v6.0 is now available. o A new command switch (/NOMODS) and GUI option to allow for drivers and utilities to be updated without modifying the STARTUP.NCF or AUTOEXEC.NCF files has been added. o F1 help has been added to all screens in the GUI. o CPQDPLOY will now allow installation to continue on a corrupt or missing component with the user's permission. o All components and CPQDPLOY enforce the version of OS to prevent you from accidentally installing a version of software not meant for the installed version of NetWare. o Reporting of errors in the SYS:\ETC\CPQLOG.LOG file has been enhanced. o The details on the Completion Status screen have been updated to show you more information as to why a package wasn't installed, why it failed, or why it was not attempted. o As the now withdrawn NSSD did, entries are placed in the PRODUCTS.DAT for the CSP, CPQONLIN.NLM, CPQEIMD.NLM, NCMCON.NLM, and CPQIML.NLM to show the currently installed version of that software. 3.5 New and updated drivers/components in this CSP o Support for the following adapters and utilities has been added: > Compaq iLo Management Interface driver (CPQCI.NLM) New version is 1.00 > Compaq NC67xx/NC77xx Gigabit Ethernet NIC driver (Q57.LAN) New version is v2.14 > Compaq NC67xx/NC77xx Gigabit Ethernet NIC Teaming driver (QASP.LAN) New version is v2.05 > Compaq Integrated Ultra ATA-100 Dual Channel driver (MEGARIDE.HAM) New version is v1.31 > Compaq Integrated ATA RAID Management Utiilty (SPY.NLM) New version is v3.02 o Support for the following adapters and utilities has been updated*: *[Almost all drivers have been updated to support NetWare v6.0 or the current version was able to support NetWare v6.0 without modifications. The drivers below reflect changes since the last version of the CSP (v1.04a) was made available. The drivers below also may reflect updates beyond what is included on the NetWare v6.0 media.] > Adaptec 160M adapter driver (ADPT160M.HAM) from v15.06 to v17.00m Component numbers CP001288.NLM, CP001311.NLM, and CP001334.NLM. > Compaq NetFlex-3 Ethernet Adapter driver (CPQNF3.LAN) from v2.45 to v2.47 Component numbers CP001290.NLM, CP001313.NLM, and CP001336.NLM. > Compaq N100 Fast-Ethernet Adapter driver (N100.LAN) from v6.36 to v6.38 Component numbers CP001293.NLM, CP001316.NLM, and CP001339.NLM. > Compaq N1000 Gigabit Ethernet Adapter driver (N1000.LAN) from v2.71 to v2.75 Component numbers CP001294.NLM, CP001317.NLM, and CP001340.NLM. > SysKonnect FDDI Adapter driver (SKFPNW.LAN) from v4.21 to v4.22 Component numbers CP001295.NLM, CP001318.NLM, and CP001341.NLM. > AMD ISA Ethernet Adapter driver (PCNTNW.LAN) from v4.18 to v4.23 Component numbers CP001296.NLM, CP001319.NLM, and CP001342.NLM. > Compaq Multi-Processor driver (CPQMPK.PSM) from v3.14 to v3.15 Component numbers CP001321.NLM and CP001344.NLM. > Compaq Health drivers (CPQHLTH.NLM, CPQASM.NLM, and CPQLGCY.NLM) from v4.36 to v5.00 Component numbers CP001299.NLM, CP001322.NLM, and CP001345.NLM. > Compaq Array Configuration Utility (CPQONLIN.NLM) from v2.60 to v2.62a Component numbers CP001300.NLM, CP001323.NLM, and CP001346.NLM. > Compaq Integrated Management Log Viewer (CPQIML.NLM) from v1.10 to v1.11 Component numbers CP001301.NLM, CP001324.NLM, and CP001347.NLM. > Compaq Hot-Plug PCI driver (CPQSBD.NLM) from v3.07 to v3.10 Component numbers CP001302.NLM, CP001325.NLM, and CP001348.NLM. > Compaq Power Management Utility (CPQPOWER.NLM) from v1.08 to v1.09 Component numbers CP001303.NLM, CP001326.NLM, and CP001349.NLM. > Compaq RAID adapter driver (CPQRAID.HAM) from v2.00 to v2.01 Component numbers CP001305.NLM, CP001328.NLM, and CP001351.NLM. > Compaq Management Agents from v5.20 to v5.30 Component numbers (CP001355.NLM, CP001356.NLM, CP001357.NLM and CP001358.NLM) > Compaq Survey Utility from v2.36 to v2.40 Component number CP001359.NLM. 4. Software Installation The CSP can be installed in one of five ways: o Command-line by CPQDPLOY.NLM (See Section 4.1) o Graphical (NUT-based) by CPQDPLOY.NLM (See Section 4.2) o Command-line by individual package (See Section 4.3) o Graphical (NUT-based) by individual package (See Section 4.4) o CPQSETUP.NLM (Individual Component Installer) after Component Extraction (See Section 4.5) 4.1 Command Line Deployment Using CPQDPLOY.NLM Command-line installation using CPQDPLOY.NLM is achieved by passing as arguments either a bundle file name or component file name to install along with either the /nui or /s switches. A bundle file name is of the format BP00XXXX.XML. A component file name is of the format CP0XXXXX.NLM. CPQDPLOY.NLM is capable of installing either one bundle or component at a time. A bundle is a Compaq-tested collection of component packages which will deploy device drivers, utilities, agents, or Survey. See Section 4.7 for information on how to start the deployment utility with the "no user interface" option. If you do not provide the name of a bundle or component package to install and use the -nui or -s option, the installation will fail. Regardless of the command-line option passed, information about the success/failure of the installation is logged in the SYS:\ETC\CPQLOG.LOG file. 4.2 Graphical (NUT-based) Deployment using CPQDPLOY.NLM Graphical installation using CPQDPLOY.NLM can be done by not using the -s or -nui parameters to CPQDPLOY.NLM. You may optionally pass the name of the bundle or component that you want installed. The deployment selection screen will show you the currently installed version of the software on your server (if found), the version that the component package will install, and a description of the component package. The following keystrokes are available on the graphical screen: F1 = Display Help F2 = Toggles the force option F3 = Toggles the reboot option F4 = Marks/Unmarks all the components in the list F5 = Marks/Unmarks an individual component in the list F7 = Toggles whether the STARTUP.NCF and AUTOEXEC.NCF files should be modified F8 = Display more options F10 = Installs the marked packages Enter = Shows the component package details and payload information Esc = Return to the previous screen or exit the deployment utility Once installation has completed, a component installation status screen will be displayed showing the results of the installation. From this screen, you can press F3 to view the SYS:\ETC\CPQLOG.LOG file or press Enter on a component to see further details of the installation. Pressing Escape terminates the component installer. 4.3 Command-Line by Individual Package Command-line installation of an individual component can be done by typing the name of the component package (ie CP001315) preceded by the LOAD command (optional in NetWare v5.1 and v6.0) and either the /nui or /s switches. An individual component package file name is of the format CP0XXXXX.NLM. The individual component installer is capable of installing a single component at a time. A component package will deploy device drivers, utilities, agents, or Survey. See Section 4.7 for information on how to start the individual component installer with the "no user interface" option. Regardless of the command-line option passed, information about the success/failure of the installation is logged in the SYS:\ETC\CPQLOG.LOG file. 4.4 Graphical (NUT-based) Deployment by Individual Package Graphical installation using the individual component installer can be done by not using the -s or -nui parameters to the component package. The deployment selection screen will show you the currently installed version of the component package on your server (if found), the version that the component package will install, and a description of the component package. The following keystrokes are available on the graphical screen: F1 = Display Help F2 = Toggles the force option F3 = Toggles the reboot option F4 = Marks/Unmarks the component to be installed F5 = Marks/Unmarks the component to be installed F7 = Toggles whether the STARTUP.NCF and AUTOEXEC.NCF files should be modified F8 = Display more options F10 = Installs the marked package Enter = Shows the component package details and payload information Esc = Return to the previous screen or exit the deployment utility Once installation has completed, a component installation status screen will be displayed showing the results of the installation. From this screen, you can press F3 to view the SYS:\ETC\CPQLOG.LOG file or press Enter on the component to see further details of the installation. Pressing Escape terminates the component installer. 4.5 CPQSETUP.NLM (Individual Component Installer) after Component Extraction If you elect to extract the contents of a component by using the -x[PATH] option, you can still install the contents of the package by executing the CPQSETUP.NLM utility. See Section 4.7 for an example of how to extract a package and execute the CPQSETUP.NLM utility. Once the utility is started, it behaves exactly as an individual component installer as described above in Sections 4.3 and 4.4. Regardless of the command-line option passed, information about the success/failure of the installation is logged in the SYS:\ETC\CPQLOG.LOG file. NOTE: The CPQSETUP.NLM utility does not support multiple packages in the same extracted directory. Placing multiple extracted packages in the same directory will cause the installation to fail. 4.6 List of Command-line parameters NOTE: Parameters can be entered as upper or lower case, with either a slash '/' or dash '-' preceding them. Parameters in parentheses can be used in place of the whole word (ie -(h)elp means that either -h, -help, /h or /help can be used) CPQDPLOY command-line parameters: CPQDPLOY [/H[ELP]|/?] [/NUI] [/S[ILENT]] [/R[EBOOT]] [/F[ORCE]] [/NOMODS] [BP000xxx.XML|CP00xxxx.NLM] CPQDPLOY [-H[ELP]|-?] [-NUI] [-S[ILENT]] [-R[EBOOT]] [-F[ORCE]] [-NOMODS] [BP000xxx.XML|CP00xxxx.NLM] -(h)elp Show this list of command-line parameters -(r)eboot Reboot if a package installed requires it and no failures occurred -(s)ilent Silent installation means that all messages will be logged to the SYS:\ETC\CPQLOG.LOG file. No console output or GUI will be shown. -(nui) No user interface will be displayed. However, during installation, output will be shown at the system console unless the -(s)ilent option is also used. -(f)orce Force the installation of a package, regardless of software version installed on the server as long as the prerequisite software requirements have been met. -nomods Made no modifications to the STARTUP.NCF and AUTOEXEC.NCF files. The default option (without this parameter) is to make all modifications as needed during the installation of each component package. Individual Component command-line parameters: CP00XXXX [/H[ELP]|/?] [/NUI] [/S[ILENT]] [/NOMODS] [/F[ORCE]] [/I] [/G] [/R[EBOOT]] [/xVOL:\PATH] CP00XXXX [-H[ELP]|-?] [-NUI] [-S[ILENT]] [-NOMODS] [-F[ORCE]] [-I] [-G] [-R[EBOOT]] [-xVOL:\PATH] -(h)elp Show this list of command-line parameters -(r)eboot Reboot if a package installed requires it and no failures occurred -(s)ilent Silent installation means that all messages will be logged to the SYS:\ETC\CPQLOG.LOG file. No console output or GUI will be shown. -(nui) No user interface will be displayed. However, during installation, output will be shown at the system console unless the -(s)ilent option is also used. -(f)orce Force the installation of a package, regardless of software version installed on the server as long as the prerequisite software requirements have been met. -i Display the Package Payload information (no installation occurs) -g Display Package Source and Destination information (no installation occurs) -xVol:\Path Extract the contents of the package to the directory pointed to by Vol:\Path. Note that there is no space between the x and the path. If VOL:\Path does not exist, an attempt is made to create the Path. An invalid volume and/or path will be ignored and the extraction terminated. -nomods Made no modifications to the STARTUP.NCF and AUTOEXEC.NCF files. The default option (without this parameter) is to make all modifications as needed during the installation of each component package. CPQSETUP.NLM (Individual Component Installer) command-line parameters NOTE: CPQSETUP.NLM is only available after a package has been extracted to a directory. During normal installation, CPQSETUP.NLM will be automatically called by the Individual component extraction utility. CPQSETUP [/H[ELP]|/?] [/NUI] [/S[ILENT]] [/NOMODS] [/F[ORCE]] [/R[EBOOT]] CPQSETUP [-H[ELP]|-?] [-NUI] [-S[ILENT]] [-NOMODS] [-F[ORCE]] [-R[EBOOT]] -(h)elp Show this list of command-line parameters -(r)eboot Reboot if a package installed requires it and no failures occurred -(s)ilent Silent installation means that all messages will be logged to the SYS:\ETC\CPQLOG.LOG file. No console output or GUI will be shown. -(nui) No user interface will be displayed. However, during installation, output will be shown at the system console unless the -(s)ilent option is also used. -(f)orce Force the installation of a package, regardless of software version installed on the server as long as the prerequisite software requirements have been met. -nomods Made no modifications to the STARTUP.NCF and AUTOEXEC.NCF files. The default option (without this parameter) is to make all modifications as needed during the installation of each component package. 4.7 Installation Examples o Normal program execution to deploy a bundle of components for NetWare v5.1. The deployment utility will expect the bundle file and all bundles to be in the directory which it was called from. If a bundle file is not found, you will be prompted for the path to a bundle file. SYS:\DEPLOY\CPQDPLOY o Normal program execution to deploy a bundle of components for NetWare v4.2. The deployment utility will expect the bundle file and all bundles to be in the directory which it was called from. If a bundle file is not found, you will be prompted for the path to a bundle file. LOAD SYS:\DEPLOY\CPQDPLOY o Using CPQDPLOY to deploy a bundle LOAD SYS:\DEPLOY\CPQDPLOY BP000064.XML o Using the force option for CPQDPLOY.NLM LOAD SYS:\DEPLOY\CPQDPLOY -f o Using the "no user interface" option (No GUI) LOAD SYS:\DEPLOY\CPQDPLOY -nui o Using the silent option (no command-line or GUI output) LOAD SYS:\DEPLOY\CPQDPLOY -s o Using the silent option and the force option LOAD SYS:\DEPLOY\CPQDLOY -s -f o Installing a single component with GUI LOAD SYS:\DEPLOY\CP001357 o Installing a single component with force and "no user interface" options LOAD SYS:\DEPLOY\CP001331 -f -nui o Extracting a components contents to another directory LOAD SYS:\DEPLOY\CP001286 -xSYS:\TEMP o Install the contents of a package after extracting a components contents to another directory LOAD SYS:\TEMP\CPQSETUP o Determining a components contents without extracting LOAD SYS:\DEPLOY\CP001322 -i o Determining the source directory, destination directory and primary NLM that will be installed by the component package LOAD SYS:\DEPLOY\CP001424 -g o Deploying a single component from the deployment utility with force option LOAD SYS:\DEPLOY\CPQDPLOY CP001334.NLM -f 5. Log files During CSP installation an installation log file is generated that contains more detailed information about the installation than is displayed by the CPQDPLOY.NLM deployment manager status screen. The log file is useful in determining why a particular component failed to install properly. Each component writes to the installation log file that resides at the following location: SYS:\ETC\CPQLOG.LOG To view the installation log file from within the CPQDPLOY.NLM Installation Status screen, press the F3 key. To clear the installation log file while it is displayed in the CPQDPLOY.NLM Installation Status screen, press the F2 key. The installation log file can also be displayed using any text editor. 6. FAQ Issue : On NetWare v4.2, when I try to install using the CSP, I get a message about an undefined public symbol "_closedir_510" Resolution: Download and install the CLIBAUX1.EXE patch off the http://support.novell.com website. This patch is a prerequisite for running the CSP on NetWare v4.2. The CLIBAUX.NLM is also provided as part of the CSP for NetWare v4.2. Issue: I used the /r flag to reboot the server, one of the packages installed required a reboot, but the server did not reboot. What is happening? Resolution: If any of the packages chosen for installation fails the installation, a reboot will not occur. This is so the administrator can examine a server to determine and resolve a software installation failure before activating any changes. Issue: When I examine the package contents, the version of the driver in the package is newer than what I have on my server. However, one of the support files is older than the version that is contained in the package. What happens during installation? Resolution: Each file within a package is version checked (and date checked for non-NLM files) before the file is installed on the server. If one file in the package is newer than the file on the server, then the version in the package will be installed. If another file in the package is older than the version on the server, then the version that is currently on the server will be retained. *NOTE: If the /force flag is used, then no version checking is done. All files in the package will be installed even if one of the files on the server is newer than the one in the package. Issue: When I install a driver, then run the installation utility a second time before rebooting the server, the version shown in the installation utility does not match the version loaded via the MODULES console command. Resolution: Once an installation has occurred, the installation utility will check against the installed version on the fixed disk. Even if the version loaded is different, the version compared against for installations is the version on the physical media. Issue: When I do a command-line install and pass the /r parameter, the server does not reboot. Resolution: Normally this occurs because either the version of the software to be installed is the same or older than the version installed on the server or a failure occurred during the installation (such as a prerequisite was not met). Check the SYS:\ETC\CPQLOG.LOG file to determine the cause of the failure. Issue: When I choose the force installation, some packages are not installed. Resolution: The force option will only cause packages to install when the software prerequisites for the package have been met. If the software prerequisites for a package have not been met, the package installation will fail. In a future release of the CSP, an option will be provided to allow installation even if the software prerequisites that a package requires are not met. Issue: During installation, I get error messages about unable to read xxx from an XML file or an Error 10010 ... message. Resolution: As above, this is normally caused by a corrupted package, which normally occurs during download. If a package XML file cannot be parsed correctly, the installation of that package will terminate with an error such as the above. To resolve this issue, try downloading the package again from http://www.compaq.com. Issue: When I try to install the CSP, I get the message "The software in this package is not intended for this version of NetWare." Resolution: There are two causes of this. First, if you have placed both versions of the CSP in the same directory, the Bundle XML file (BP00xxxx.XML) selected could be for another version of NetWare. Second, the package you have chosen to install is not intended for the version of NetWare that is currently installed on the server. Issue: When I start the CSP with CPQDPLOY.NLM, I get a prompt asking me to 'Enter a path to a supported bundle XML file'. Resolution: This is caused by having CPQDPLOY.NLM in a directory without a valid bundle file. A valid bundle file is a bundle file of the format BP0000xx.XML and which is supported by the currently installed version of NetWare. CPQDPLOY.NLM may be in a directory with a bundle file, but if the bundle file does not provide support for the currently installed version of NetWare, you will be prompted to enter a path to a valid bundle file. You can press F1 to see an example of a valid path. Issue: When upgrading from NetWare v4.x or v5.x to NetWare v6.0, I get an error message during the start of the installation where NWPA.NLM is reporting symbols missing for kResume and kSuspend. Resolution: This is caused by an older version of NWPA.NLM being left in the C:\NWUPDATE directory from a previous installation. The above symbols were removed from the kernel in NetWare v6.0. To resolve the issue, remove the older NWPA.NLM from the C:\NWUPDATE directory. Issue: When upgrading from NetWare v4.x to NetWare v6.0, if you have installed the CPQONLIN.NLM (Compaq Array Configuration Utility) under v4.x, the VOLLIB.NLM is not removed from SYS:\SYSTEM and the drivers are still listed in the AUTOEXEC.NCF file. Resolution: Deleting the SYS:\SYSTEM\VOLLIB.NLM file and removing the entries for 'LOAD C:\NWSERVER\PARTAPI.NLM' and 'LOAD VOLLIB.NLM' from the SYS:\SYSTEM\AUTOEXEC.NCF file will resolve this issue. ----------------------------------------------------------------------------- Copyright 2000-2002 Compaq Computer Corporation Compaq and the Compaq logo Reg. U.S. Pat. & Tm. Off. All other product names mentioned herein may be trademarks and/or registered trademarks of their respective companies. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.