Patch-ID# 118132-04 Keywords: man pages startup script autoinstall Synopsis: N1 Grid Engine 6.0: maintenance patch Date: Apr/28/2005 Install Requirements: NA Solaris Release: 7 8 9 10 SunOS Release: 5.7 5.8 5.9 5.10 Unbundled Product: N1 Grid Engine Unbundled Release: 6.0 Xref: See patch matrix below Topic: Relevant Architectures: all BugId's fixed with this patch: 4820420 5062683 5063305 5063315 5063317 5071527 5071868 5071878 5071999 5077167 5084927 5085411 5085507 5085508 5086193 5102340 6176177 6178328 6193866 6194002 6197109 6197253 6197730 6200013 6201044 6203977 6203984 6211725 6214459 6218379 6221850 6229603 6231589 6233300 6235845 6236136 6236139 6236476 6239640 6239655 6245486 6251175 6251178 6253138 6253192 6253219 6253278 6253291 6253313 6254840 6257389 6259993 Changes incorporated in this version: 4820420 5071527 5086193 6197109 6197730 6203977 6203984 6218379 6221850 6229603 6231589 6233300 6235845 6236136 6236139 6236476 6239640 6239655 6245486 6251175 6251178 6253138 6253192 6253219 6253278 6253291 6253313 6254840 6257389 6259993 Patches accumulated and obsoleted by this patch: Patches which conflict with this patch: Patches required with this patch: Obsoleted by: Files included with this patch: /3rd_party/THIRDPARTYLICENSEREADME.txt /catman/a_man/cat5/bootstrap.z /catman/a_man/cat5/calendar_conf.z /catman/a_man/cat5/complex.z /catman/a_man/cat5/host_aliases.z /catman/a_man/cat5/hostgroup.z /catman/a_man/cat5/qtask.z /catman/a_man/cat5/queue_conf.z /catman/a_man/cat5/reporting.z /catman/a_man/cat5/sched_conf.z /catman/a_man/cat5/sge_conf.z /catman/a_man/cat5/sge_pe.z /catman/a_man/cat5/sge_priority.z /catman/a_man/cat5/sge_qstat.z /catman/a_man/cat8/sge_execd.z /catman/a_man/cat8/sge_qmaster.z /catman/a_man/cat8/sge_schedd.z /catman/a_man/cat8/sge_shadowd.z /catman/a_man/cat8/sge_shepherd.z /catman/cat/cat1/gethostbyaddr.1 /catman/cat/cat1/gethostbyname.1 /catman/cat/cat1/gethostname.1 /catman/cat/cat1/getservbyname.1 /catman/cat/cat1/hostnameutils.1 /catman/cat/cat1/qacct.1 /catman/cat/cat1/qalter.1 /catman/cat/cat1/qconf.1 /catman/cat/cat1/qdel.1 /catman/cat/cat1/qhold.1 /catman/cat/cat1/qhost.1 /catman/cat/cat1/qlogin.1 /catman/cat/cat1/qmake.1 /catman/cat/cat1/qmod.1 /catman/cat/cat1/qmon.1 /catman/cat/cat1/qping.1 /catman/cat/cat1/qresub.1 /catman/cat/cat1/qrls.1 /catman/cat/cat1/qrsh.1 /catman/cat/cat1/qselect.1 /catman/cat/cat1/qsh.1 /catman/cat/cat1/qstat.1 /catman/cat/cat1/qsub.1 /catman/cat/cat1/qtcsh.1 /catman/cat/cat1/sge_ckpt.1 /catman/cat/cat1/sge_intro.1 /catman/cat/cat1/sge_types.1 /catman/cat/cat1/submit.1 /catman/cat/cat3/drmaa_allocate_job_template.3 /catman/cat/cat3/drmaa_attributes.3 /catman/cat/cat3/drmaa_control.3 /catman/cat/cat3/drmaa_delete_job_template.3 /catman/cat/cat3/drmaa_exit.3 /catman/cat/cat3/drmaa_get_DRM_system.3 /catman/cat/cat3/drmaa_get_attribute.3 /catman/cat/cat3/drmaa_get_attribute_names.3 /catman/cat/cat3/drmaa_get_contact.3 /catman/cat/cat3/drmaa_get_next_attr_name.3 /catman/cat/cat3/drmaa_get_next_attr_value.3 /catman/cat/cat3/drmaa_get_next_job_id.3 /catman/cat/cat3/drmaa_get_vector_attribute.3 /catman/cat/cat3/drmaa_get_vector_attribute_names.3 /catman/cat/cat3/drmaa_init.3 /catman/cat/cat3/drmaa_job_ps.3 /catman/cat/cat3/drmaa_jobcontrol.3 /catman/cat/cat3/drmaa_jobtemplate.3 /catman/cat/cat3/drmaa_misc.3 /catman/cat/cat3/drmaa_release_attr_names.3 /catman/cat/cat3/drmaa_release_attr_values.3 /catman/cat/cat3/drmaa_release_job_ids.3 /catman/cat/cat3/drmaa_run_bulk_jobs.3 /catman/cat/cat3/drmaa_run_job.3 /catman/cat/cat3/drmaa_session.3 /catman/cat/cat3/drmaa_set_attribute.3 /catman/cat/cat3/drmaa_set_vector_attribute.3 /catman/cat/cat3/drmaa_strerror.3 /catman/cat/cat3/drmaa_submit.3 /catman/cat/cat3/drmaa_synchronize.3 /catman/cat/cat3/drmaa_version.3 /catman/cat/cat3/drmaa_wait.3 /catman/cat/cat3/drmaa_wcoredump.3 /catman/cat/cat3/drmaa_wexitstatus.3 /catman/cat/cat3/drmaa_wifaborted.3 /catman/cat/cat3/drmaa_wifexited.3 /catman/cat/cat3/drmaa_wifsignaled.3 /catman/cat/cat3/drmaa_wtermsig.3 /catman/cat/cat5/access_list.5 /catman/cat/cat5/accounting.5 /catman/cat/cat5/bootstrap.5 /catman/cat/cat5/calendar_conf.5 /catman/cat/cat5/checkpoint.5 /catman/cat/cat5/complex.5 /catman/cat/cat5/host_aliases.5 /catman/cat/cat5/host_conf.5 /catman/cat/cat5/hostgroup.5 /catman/cat/cat5/project.5 /catman/cat/cat5/qtask.5 /catman/cat/cat5/queue_conf.5 /catman/cat/cat5/reporting.5 /catman/cat/cat5/sched_conf.5 /catman/cat/cat5/sge_aliases.5 /catman/cat/cat5/sge_conf.5 /catman/cat/cat5/sge_pe.5 /catman/cat/cat5/sge_priority.5 /catman/cat/cat5/sge_qstat.5 /catman/cat/cat5/sge_request.5 /catman/cat/cat5/share_tree.5 /catman/cat/cat5/user.5 /catman/cat/cat5/usermapping.5 /catman/cat/cat8/sge_execd.8 /catman/cat/cat8/sge_qmaster.8 /catman/cat/cat8/sge_schedd.8 /catman/cat/cat8/sge_shadowd.8 /catman/cat/cat8/sge_shepherd.8 /catman/u_man/cat1/gethostbyaddr.z /catman/u_man/cat1/gethostbyname.z /catman/u_man/cat1/gethostname.z /catman/u_man/cat1/getservbyname.z /catman/u_man/cat1/hostnameutils.z /catman/u_man/cat1/qalter.z /catman/u_man/cat1/qconf.z /catman/u_man/cat1/qlogin.z /catman/u_man/cat1/qmake.z /catman/u_man/cat1/qmod.z /catman/u_man/cat1/qping.z /catman/u_man/cat1/qresub.z /catman/u_man/cat1/qrsh.z /catman/u_man/cat1/qselect.z /catman/u_man/cat1/qsh.z /catman/u_man/cat1/qstat.z /catman/u_man/cat1/qsub.z /catman/u_man/cat1/qtcsh.z /catman/u_man/cat1/sge_types.z /catman/u_man/cat1/submit.z /ckpt/README.cpr /ckpt/README.cray /doc/README-Autoinstall.txt /doc/README-DRMAA.txt /doc/javadocs /doc/javadocs/allclasses-frame.html /doc/javadocs/allclasses-noframe.html /doc/javadocs/com/sun/grid/drmaa/JobInfoImpl.html /doc/javadocs/com/sun/grid/drmaa/JobTemplateImpl.html /doc/javadocs/com/sun/grid/drmaa/SessionFactoryImpl.html /doc/javadocs/com/sun/grid/drmaa/SessionImpl.html /doc/javadocs/com/sun/grid/drmaa/package-frame.html /doc/javadocs/com/sun/grid/drmaa/package-summary.html /doc/javadocs/com/sun/grid/drmaa/package-tree.html /doc/javadocs/constant-values.html /doc/javadocs/deprecated-list.html /doc/javadocs/help-doc.html /doc/javadocs/index-all.html /doc/javadocs/index.html /doc/javadocs/org/ggf /doc/javadocs/org/ggf/drmaa/AlreadyActiveSessionException.html /doc/javadocs/org/ggf/drmaa/AuthorizationException.html /doc/javadocs/org/ggf/drmaa/ConflictingAttributeValuesException.html /doc/javadocs/org/ggf/drmaa/DefaultContactStringException.html /doc/javadocs/org/ggf/drmaa/DeniedByDrmException.html /doc/javadocs/org/ggf/drmaa/DrmCommunicationException.html /doc/javadocs/org/ggf/drmaa/DrmaaException.html /doc/javadocs/org/ggf/drmaa/DrmaaRuntimeException.html /doc/javadocs/org/ggf/drmaa/DrmsExitException.html /doc/javadocs/org/ggf/drmaa/DrmsInitException.html /doc/javadocs/org/ggf/drmaa/ExitTimeoutException.html /doc/javadocs/org/ggf/drmaa/FileTransferMode.html /doc/javadocs/org/ggf/drmaa/HoldInconsistentStateException.html /doc/javadocs/org/ggf/drmaa/InconsistentStateException.html /doc/javadocs/org/ggf/drmaa/InternalException.html /doc/javadocs/org/ggf/drmaa/InvalidArgumentException.html /doc/javadocs/org/ggf/drmaa/InvalidAttributeException.html /doc/javadocs/org/ggf/drmaa/InvalidAttributeFormatException.html /doc/javadocs/org/ggf/drmaa/InvalidAttributeValueException.html /doc/javadocs/org/ggf/drmaa/InvalidContactStringException.html /doc/javadocs/org/ggf/drmaa/InvalidJobException.html /doc/javadocs/org/ggf/drmaa/InvalidJobTemplateException.html /doc/javadocs/org/ggf/drmaa/JobInfo.html /doc/javadocs/org/ggf/drmaa/JobTemplate.html /doc/javadocs/org/ggf/drmaa/NoActiveSessionException.html /doc/javadocs/org/ggf/drmaa/NoDefaultContactStringException.html /doc/javadocs/org/ggf/drmaa/NoResourceUsageException.html /doc/javadocs/org/ggf/drmaa/PartialTimestamp.html /doc/javadocs/org/ggf/drmaa/PartialTimestampFormat.html /doc/javadocs/org/ggf/drmaa/ReleaseInconsistentStateException.html /doc/javadocs/org/ggf/drmaa/ResumeInconsistentStateException.html /doc/javadocs/org/ggf/drmaa/Session.html /doc/javadocs/org/ggf/drmaa/SessionException.html /doc/javadocs/org/ggf/drmaa/SessionFactory.html /doc/javadocs/org/ggf/drmaa/SuspendInconsistentStateException.html /doc/javadocs/org/ggf/drmaa/TryLaterException.html /doc/javadocs/org/ggf/drmaa/UnsupportedAttributeException.html /doc/javadocs/org/ggf/drmaa/Version.html /doc/javadocs/org/ggf/drmaa/package-frame.html /doc/javadocs/org/ggf/drmaa/package-summary.html /doc/javadocs/org/ggf/drmaa/package-tree.html /doc/javadocs/overview-frame.html /doc/javadocs/overview-summary.html /doc/javadocs/overview-tree.html /doc/javadocs/package-list /doc/javadocs/packages.html /doc/javadocs/resources /doc/javadocs/resources/inherit.gif /doc/javadocs/serialized-form.html /doc/javadocs/stylesheet.css /include/drmaa.h /inst_sge /lib/drmaa.jar /man/man1/gethostbyaddr.1 /man/man1/gethostbyname.1 /man/man1/gethostname.1 /man/man1/getservbyname.1 /man/man1/hostnameutils.1 /man/man1/qconf.1 /man/man1/qmake.1 /man/man1/qmod.1 /man/man1/qping.1 /man/man1/qselect.1 /man/man1/qstat.1 /man/man1/qtcsh.1 /man/man1/sge_types.1 /man/man1/submit.1 /man/man3/drmaa_attributes.3 /man/man3/drmaa_jobcontrol.3 /man/man3/drmaa_jobtemplate.3 /man/man3/drmaa_misc.3 /man/man3/drmaa_session.3 /man/man3/drmaa_submit.3 /man/man3/drmaa_wait.3 /man/man5/bootstrap.5 /man/man5/calendar_conf.5 /man/man5/complex.5 /man/man5/host_aliases.5 /man/man5/hostgroup.5 /man/man5/qtask.5 /man/man5/queue_conf.5 /man/man5/reporting.5 /man/man5/sched_conf.5 /man/man5/sge_conf.5 /man/man5/sge_pe.5 /man/man5/sge_priority.5 /man/man5/sge_qstat.5 /man/man8/sge_execd.8 /man/man8/sge_qmaster.8 /man/man8/sge_schedd.8 /man/man8/sge_shadowd.8 /man/man8/sge_shepherd.8 /qmon/PIXMAPS/leaf_minus.xpm /qmon/PIXMAPS/leaf_plus.xpm /qmon/qmon_help.ad /util/arch /util/arch_variables /util/create_settings.sh /util/install_modules /util/install_modules/inst_berkeley.sh /util/install_modules/inst_common.sh /util/install_modules/inst_execd.sh /util/install_modules/inst_execd_uninst.sh /util/install_modules/inst_qmaster.sh /util/install_modules/inst_qmaster_uninst.sh /util/install_modules/inst_schedd_high.conf /util/install_modules/inst_schedd_max.conf /util/install_modules/inst_schedd_normal.conf /util/install_modules/inst_template.conf /util/install_modules/inst_update.sh /util/rctemplates /util/rctemplates/sgebdb_template /util/rctemplates/sgeexecd_template /util/rctemplates/sgemaster_template /util/resources /util/resources/loadsensors /util/resources/loadsensors/interix-loadsensor.sh /util/resources/loadsensors/load.sh /util/resources/schemas /util/resources/schemas/qstat/detailed_job_info.xsd /util/setfileperm.sh /util/sgeCA/renew_all_certs.csh /util/sgeCA/sge_ca /util/sgeCA/sge_ssl.cnf /util/sgeCA/sge_ssl_template.cnf Problem Description: 6259993 inst_sge -bup does not backup shadow_masters file 6257389 inst_sge -bup with rpc server destroy database 6254840 Install failure for execution hosts on multiple domains 6253313 auto_inst -um does not uses configurationfile 6253291 auto_inst uninstallation with fqnd does not work 6253278 auto_inst should ne be case sensitive for hostnames 6253219 BDB RPC server with NFS spooling dir and master auto_install does not work 6253192 bdb rpc auto install does not work 6253138 auto_inst uses ADMIN_HOST_LIST variable onl at qmaster installation time 6251178 install_qmaster picks up commented out service sge_qmaster 6251175 berkeleydb server shutdown script failes 6245486 sge_ca needs to export SGE_CELL 6239655 inst_sge only deletes common, but not 6239640 ./inst_sge -x fails with fqdn and no default domain 6236476 NoClassDefFoundError: org/ggf/drmaa/NoResourceUsageDataException 6236139 restore procedure does not really ensure qmaster is down 6236136 backup/restore for classic and rpc server spooling not supported! 6235845 install script should create execd spooldir 6233300 Upgrade procedure should be more verbose wrts manual steps required to transfer 5.3 configuration 6231589 execd uninstall doesn't remove all objects 6229603 reprioritize parameter is NOT documented 6221850 Request for start-up script additions 6218379 Problems with BDB RPC server are hard to diagnose 6203984 Port free/used check returns a wrong result in some cases! 6203977 execd installation fails, if local spool dir is not entered by user! 6197730 Problems with shadowd install 6197109 install_execd does not pick up $SGE_CELL 5086193 load.sh fails on a machine when uptime displays time for less than an hour 5071527 Error messages with autoinstallation 4820420 sge_shadowd(8) man page should be improved (from 118132-03) 6211725 uninstall of exec host doesn't work 6214459 install fails on AMD64 Linux (from 118132-02) 5063315 Confusing Install Text: spooling method 5063317 Confusing Install Text: port numbers 5071878 no man page for qping and gethostname binaries 5102340 drmaa_synchronize() waits for all jobs, including newly submitted jobs 6176177 restoring a backup does not restore the job_scripts dir. 6178328 Admin/Users Guide: qstat has been enhanced. 6193866 backup/restore does not work under Linux and others.. 6194002 sgemaster -migrate on qmaster host tries to start second qmaster 6197253 DRMAA_DURATION_{H|S}LIMIT misspelled as "durartion" 6200013 arch script does not know about /lib64 6201044 Checkpoint README refers to wrong script (from 118132-01) 5062683 Install script fails when sgeadmin is selected as install user. 5063305 remove stat_log_time 5071868 uninstall procedure doesn't remove the rc-script of execd! 5071999 inst_sge -sm doesn't create a local_conf 5077167 NO_REPRIORITATION should be removed from man pages 5084927 install script fails without SGE_ROOT 5085411 man pages corrections and clarifications 5085507 sge_inst restore does not work 5085508 sge backup cannot override older backups Patch Installation Instructions: -------------------------------- For Solaris 7 through 10 releases, refer to the man pages for instructions on using 'patchadd' and 'patchrm' scripts provided with Solaris. Any other special or non-generic installation instructions should be described below as special instructions. The following example installs a patch to a standalone machine: example# patchadd /var/spool/patch/104945-02 The following example removes a patch from a standalone system: example# patchrm 104945-02 For additional examples please see the appropriate man pages. See the "Special Install Instructions" section below before installing this patch. Patch requirements and patch matrix for N1 Grid Engine 6 packages ----------------------------------------------------------------- The patches below update a N1 Grid Engine 6 distribution to N1 Grid Engine 6 Update 4 (N1GE 6.0u4). The "-help" output of most commands will print a version string "N1GE 6.0u4" after applying the patch. All packages of a N1 Grid Engine 6 distribution must have the same patch level (exception for ARCo - see below under "Installation note for ARCo patches"). Please refer to the patch matrix below which updates the distribution to most recent patch level. It is not supported and possible to mix different patch levels of binaries and the "common" package in a single N1 Grid Engine cluster. 1. Patches for packages in Sun pkgadd format -------------------------------------------- Package name* OS* Architecture* Patch-Id ----------------------------------------------------------------- SUNWsgee Solaris, Sparc, 32bit sol-sparc 118094-04 SUNWsgeex Solaris, Sparc, 64bit sol-sparc64 118130-04 SUNWsgeex Solaris x86 sol-x86 118131-04 SUNWsgeec all common 118132-04 SUNWsgeea all arco 118133-04 *Package Name = see pkginfo(1) *OS = Operating system *Architecture = N1 Grid Engine binary architecture string or "common" = architecture independent packages "arco" = Accounting and Reproting console 2. Patches for packages in tar.gz format ---------------------------------------- OS* Architecture Patch-Id ----------------------------------------------------- Solaris, Sparc, 32bit sol-sparc 118082-04 Solaris, Sparc, 64bit sol-sparc64 118083-04 Solaris, x86 sol-x86 118084-04 Linux kernel2.4/2.6, x86 lx24-x86 118085-04 Linux kernel2.4/2.6, AMD64 lx24-amd64 118086-04 IBM AIX 4.3 aix43 118087-04 IBM AIX 5.1 aix51 118088-04 Apple MAC OS/X darwin 118089-04 HP HP-UX 11 hp11 118090-04 SGI Irix 6.5 irix65 118091-04 all common 118092-04 all arco 118093-04 Installation note for ARCo patches 118133 or 118093 --------------------------------------------------- With N1 Grid Engine 6 Update 4 (or higher) the look&feel of ARCo has been updated to use the native Sun Web Console (SWC) 2.2 GUI controls. The installation of the ARCo patch requires a new installation of SWC 2.2. You may not install the ARCo patch unless you can install SWC 2.2. SWC 2.2 is bundled with the N1 Grid Engine 6 Update 4 CDROM or can be downloaded with the full N1GE 6.0u4 distribution from Sun Download Center (SDLC). Please contact your Sun Microsystems account manager how to get access to N1GE 6.0u4 for no additional license fees if you have a valid support contract. The distribution also contains a new version of the manuals which describe the installation and use of ARCo. You can install all other N1GE6 patches without updating ARCo to the most recent patch level, however you cannot make a new installation of older ARCo packages of N1GE 6.0/6.0u1/6.0u2/6.0u3 once you installed the N1GE 6.0u4 binary and "common" patches. Special Install Instructions: ----------------------------- This patch for the architecture independent "common" package should only be installed with the corresponding binary patches and patches for the Accounting and Reporting console ("arco" patch"). See the patch matrix above and the patch installation instructions in the README files of the binary patches and "arco" package for more information. New startup script template for qmaster and execd startup --------------------------------------------------------- This patch changes the startup script of qmaster/scheduler/shadowd (the "sgemaster" script) and the startup script of the execution daemon ("sgeexecd"). Since these scripts are created from a template it is necessary to recreate the startup scripts and install them in the system wide boot script directory (e.g. /etc/init.d). The patch for N1 Grid Engine 6.0u4 comes with a few fixes for the startup script templates. If you are updating from N1 Grid Engine 6.0 to a newer release you should recreate a new startup script. If you already updated to N1 Grid Engine 6.0u4 or higher and you already executed the steps outlined below you don't need to repeat them. 1. Recreate the startup script The new scripts are installed in //common. A backup of the original scripts is saved in this directory as sgemaster_YYYY-MM-DD_HH:MM:ss sgeexecd_YYYY-MM-DD_HH:MM:ss where YYYY-MM-DD_HH:MM:ss defines the current date and time. Login as the root or admin user and source the environment settings for Grid Engine. The example below assumes your current shell is the Bourne shell or Korn shell # cd # . /common/settings.sh # ./inst_sge -rccreate The new startup scripts will be installed in //common. 2. Copy the new startup scripts Copy the new startup scripts to the system wide rc file location on all qmaster, shadowd and execution hosts. Depending on the operating system this can be one of the following directories - /etc/init.d - /etc/rc.d - /sbin/init.d New functionality delivered since N1GE 6.0 ------------------------------------------ 1. DRMAA Java[TM] language binding available -------------------------------------------- The DRMAA Java language binding is now available. The DRMAA Java language binding library is located in the directory /lib/drmaa.jar The documentation can be found in /doc/javadocs 2. Man pages ------------ - The following man pages have been added to the distribution: sge_qstat(5) - new default request file for qstat(1) gethostbyaddr(1) - man page for commands in /utilbin/ gethostbyname(1) - man page for commands in /utilbin/ gethostname(1) - man page for commands in /utilbin/ getservbyname(1) - man page for commands in /utilbin/ qping(1) - man page for utility to monitor Grid Engine daemon communication - Renamed man pages: sge_h_aliases.z -> host_aliases.z sge_h_aliases.5 -> host_aliases.5 - Pre formatted and uncompressed man pages have been added to /catman/cat/cat{1,3,5,8} - Various fixes for man pages 3. Installation Improvements ---------------------------- - Berkeley DB (BDB) RPC server auto installation and de-installation is now supported - Backup/restore for classic and BDB RPC server spooling supported - Daemon startup scripts create Linux LSB conforming "lock" file - Improved diagnosis messages during auto installation - Execution daemon un-installation leaves no references to de-installed execution host README -- Last modified date: Thursday, April 28, 2005