TCP/IP for VM Secure Socket Layer (SSL) Server
Rebuilding the vmsock Module

    Rebuilding the vmsock Module

  1. Install the appropriate SSL server source RPM

    Before the vmsock module can be rebuilt, the appropriate SSL source RPM must first be installed, with the necessary source files then obtained and made accessible for use.

    Notes

    • The Linux kernel source for the subject distribution must also be installed. The vmsock module cannot be rebuilt if the Linux source is not available. If necessary, install the Linux source, then continue with the procedure described herein.

    • The steps outlined below should be performed via the Linux root user on the selected Linux system.

    • The source files provided by a given source RPM are themselves contained within a compressed archive file — a Linux tar file that has been compressed by the gzip command. By convention, the names of such files end with the string .tgz.

         SSL Server for z/VM - Source RPM and tar File Location Information

    The SSL server Linux source RPM (SRPM) package files, their counterpart z/VM CMS files, and the location of corresponding source tar files are listed in the table that follows.

    Linux Distribution z/VM-Supplied
    RPM File         		Source RPM
    Package File         		Archive (tar) File Location
    SSL Server for z/VM 5.3
    Redhat Enterprise
    Linux AS4 U4 (31 bit)     		VMSR4S RPMBIN vmssld-2.6.9-2.srpm /usr/src/redhat/SOURCES/*.tgz
    Redhat Enterprise
    Linux AS4 U4 (64 bit)     		VMSR4XS RPMBIN vmssld-2.6.9-2.srpm /usr/src/redhat/SOURCES/*.tgz
    SUSE SLES 9 SP3
    (31 bit)     		VMSS9S RPMBIN vmssld-2.6.5-2.srpm /usr/src/packages/SOURCES/*.tgz
    SUSE SLES 9 SP3
    (64 bit)     		VMSS9XS RPMBIN vmssld-2.6.5-2.srpm /usr/src/packages/SOURCES/*.tgz
    SSL Server for z/VM 5.2
    Redhat Enterprise
    Linux AS3 U3 (31 bit)     		VMSR3S RPMBIN vmssld-2.24.21-1.srpm /usr/src/redhat/SOURCES/*.tgz
    Redhat Enterprise
    Linux AS3 U3 (64 bit)     		VMSR3XS RPMBIN vmssld-2.24.21-1.srpm /usr/src/redhat/SOURCES/*.tgz
    Redhat Enterprise
    Linux AS4 U2 (31 bit)     		VMSR4S RPMBIN vmssld-2.6.9-1.srpm /usr/src/redhat/SOURCES/*.tgz
    Redhat Enterprise
    Linux AS4 U2 (64 bit)     		VMSR4XS RPMBIN vmssld-2.6.9-1.srpm /usr/src/redhat/SOURCES/*.tgz
    SUSE SLES 8 SP3
    (31 bit)     		VMSS8S RPMBIN vmssld-2.24.21-1.srpm /usr/src/packages/SOURCES/*.tgz
    SUSE SLES 9 SP2
    (31 bit)     		VMSS9S RPMBIN vmssld-2.6.5-1.srpm /usr/src/packages/SOURCES/*.tgz
    SUSE SLES 9 SP2
    (64 bit)     		VMSS9XS RPMBIN vmssld-2.6.5-1.srpm /usr/src/packages/SOURCES/*.tgz

    To install a source package, use the same information previously used to install it's non-source counterpart RPM, while adapting the package file name as needed.

  2. Extract the vmsock source files from the SSL source archive file

    After the subject source RPM has been installed, the use the Linux tar command (with the -z option) to restore all archived source files. If necessary, consult appropriate Linux documentation for details about the tar command. 

      cd /usr/src/packages/SOURCES/
  tar -zvxf source-archive-file.tgz

    where source-archive-file is an applicable tar file name for the distribution in use (as listed in the table that follows).

    Upon extraction, the vmsock source files will reside in a directory that has been created based on the SOURCES directory path for the applicable distribution.

         SSL Server for z/VM - Source tar File Names and Source Directory Information

    The tar files and source directories that correspond to a given SSL source RPM are listed in the table that follows.

    Linux Distribution Source RPM
    Package File         		Archive (tar) File Source File Directory
    SSL Server for z/VM 5.3
    Redhat Enterprise
    Linux AS4 U4 (31 bit)     		vmssld-2.6.9-2.srpm /usr/src/redhat/SOURCES/vmssld-2.6.9.tgz /usr/src/redhat/SOURCES/vmssld-2.6.9/
    Redhat Enterprise
    Linux AS4 U4 (64 bit)     		vmssld-2.6.9-2.srpm /usr/src/redhat/SOURCES/vmssld-2.6.9.tgz /usr/src/redhat/SOURCES/vmssld-2.6.9/
    SUSE SLES 9 SP3
    (31 bit)     		vmssld-2.6.5-2.srpm /usr/src/packages/SOURCES/vmssld-2.6.5.tgz /usr/src/packages/SOURCES/vmssld-2.6.5/
    SUSE SLES 9 SP3
    (64 bit)     		vmssld-2.6.5-2.srpm /usr/src/packages/SOURCES/vmssld-2.6.5.tgz /usr/src/packages/SOURCES/vmssld-2.6.5/
    SSL Server for z/VM 5.2
    Redhat Enterprise
    Linux AS3 U3 (31 bit)     		vmssld-2.24.21-1.srpm /usr/src/redhat/SOURCES/vmssld-2.24.21.tgz /usr/src/redhat/SOURCES/vmssld-2.24.21/
    Redhat Enterprise
    Linux AS3 U3 (64 bit)     		vmssld-2.24.21-1.srpm /usr/src/redhat/SOURCES/vmssld-2.24.21.tgz /usr/src/redhat/SOURCES/vmssld-2.24.21/
    Redhat Enterprise
    Linux AS4 U2 (31 bit)     		vmssld-2.6.9-1.srpm /usr/src/redhat/SOURCES/vmssld-2.6.9.tgz /usr/src/redhat/SOURCES/vmssld-2.6.9/
    Redhat Enterprise
    Linux AS4 U2 (64 bit)     		vmssld-2.6.9-1.srpm /usr/src/redhat/SOURCES/vmssld-2.6.9.tgz /usr/src/redhat/SOURCES/vmssld-2.6.9/
    SUSE SLES 8 SP3
    (31 bit)     		vmssld-2.24.21-1.srpm /usr/src/packages/SOURCES/vmssld-2.24.21.tgz /usr/src/packages/SOURCES/vmssld-2.24.21/
    SUSE SLES 9 SP2
    (31 bit)     		vmssld-2.6.5-1.srpm /usr/src/packages/SOURCES/vmssld-2.6.5.tgz /usr/src/packages/SOURCES/vmssld-2.6.5/
    SUSE SLES 9 SP2
    (64 bit)     		vmssld-2.6.5-1.srpm /usr/src/packages/SOURCES/vmssld-2.6.5.tgz /usr/src/packages/SOURCES/vmssld-2.6.5/

  3. Run appropriate Linux make commands

    With the vmsock source files now available, run the following Linux commands to ensure the proper Linux modules and build environment exist:

    • make menuconfig
    • make install
    • make modules
    • make modules_install

    After the preceding commands have completed successfully, the mkvmsock shell script can be used to rebuild the vmsock module. This script is located within the applicable SOURCES subdirectory, as cited in the preceding table.

  4. Rebuild the vmsock (and, vmsockdb) modules

    Run the mkvmsock script, to rebuild the vmsock module and its debug counterpart, vmsockdb: 

      cd vmsock_source_directory
  ./mkvmsock
  ./mkvmsock -d

    Though not required for running the SSL server, the vmsockdb module should be rebuilt at the same time as vmsock. This will ensure that the vmsockdb module can be used in diagnosing SSL server communication problems, in consultation with the IBM support center, should this need arise.

    The vmsock and vmsockdb object files that result will then reside in the same directory as the mkvmsock shell script. These object files must be copied to the appropriate SSL server directory for use by the SSL server: 

      cp -p vmsock{qualifier} /opt/vmssl/lib
  cp -p vmsockdb{qualifier} /opt/vmssl/lib

    For the SUSE SLES 8 and Redhat AS3 distributions, the {qualifier} portion of the object file name is: .o

    For the SUSE SLES 9 and Redhat AS4 distributions, the {qualifier} portion of the object file name is: .ko