lspacket

Describes contents of a packet

Applicability

Product Command type
MultiSite multitool subcommand
Platform
UNIX®
Linux
Windows®

Synopsis

lspacket
[ –l/ong [ –endrange ] | –s/hort ] [ pname ... ]

Description

This command lists a summary of the contents of one or more files that contain replica-creation or update packets. By default, the lspacket output includes this information:

  • Pathname of each packet
  • Type of each packet (Replica Creation or Update)
  • VOB family to which the packet applies
  • Creation comment for the packet
  • Replicas for which the packet is intended; if the VOB tag is available, lspacket displays it.

    An asterisk after a replica name indicates that the packet can be imported immediately because it does not depend on any other packet. (This applies only for replicas listed in the host's VersionVault registry.) For example, if there are two packets waiting to be imported at a replica, the first packet has an asterisk and the second doesn't, because the second packet depends on the first.

  • Packet sequence number (for one part of a logical packet with multiple physical packets)

Restrictions

None.

Options and arguments

Listing format

Default
Includes the information listed in the Description section.
–l/ong
In addition to the default information, lists the following information:
  • Name or OID of the replica where the packet was created
  • Oplog IDs that indicate the contents of the packet
  • Recovery incarnation of the sending replica (an internal value used by MultiSite)
  • Major and minor packet versions (internal values used by MultiSite)
–endrange
In addition to the starting values listed by –l/ong, this option lists the ending oplog IDs, if they are available (that is, if they were created using syncreplica –endrange).
–s/hort
Lists only the pathname of a packet.

Specifying the packets to be listed

Default
Lists all packets in all storage bays on the current host.
pname ...
One or more pathnames of files and/or directories.

Each file you specify is listed if it contains a physical packet. For each directory you specify, lspacket lists packets stored in that directory.

Examples

In these examples, the lines are broken for readability. You must enter each command on a single physical line.

  • List a single replica-creation packet.



    multitool lspacket
    /opt/hcl/ccm/versionvault/shipping/ms_ship/incoming/
    repl_boston_15-Aug-00.17.07.20_7865_1

    Packet is: /opt/hcl/ccm/versionvault/shipping/ms_ship/incoming/
    repl_boston_15-Aug-00.17.07.20_7865_1
    Packet type: Replica Creation
    VOB family identifier is: 94be56a1.0dd611d1.a0df.00:01:80:7b:09:69
    Comment supplied at packet creation is:
    Packet intended for the following targets:
      buenosaires
    The packet sequence number is 1

  • List a single update packet.



    multitool lspacket /usr/tmp/packet1



    Packet is: /usr/tmp/packet1
    Packet type: Update
    Packet fragment 1 of 8
    VOB family identifier is: c3f47cf3.71b111cd.a4f2.00:01:80:31:7a:a7
    Comment supplied at packet creation is:
    Packet intended for the following targets:
    sanfran_hub [ local to this network ] tag: /vobs/tests


  • List all packets in all of the local host's storage bays.



    multitool lspacket



    Packet is: c:\Program Files\HCL\CCM\VersionVault\var\shipping
    \ms_ship\incoming\packet1
    ...
    Packet is: c:\Program Files\HCL\CCM\VersionVault\var\shipping
    \ms_ship\incoming\packet2

  • List all packets in a specific storage bay.



    multitool lspacket "c:\Program Files\HCL\CCM\VersionVault\var\shipping\to_boston"



    Packet is: c:\Program Files\HCL\CCM\VersionVault\var\shipping
    \to_boston\outgoing\packet1
    Packet type: Update
    ...

  • List an update packet in long format.



    multitool lspacket –long /usr/tmp/packet1



    Packet is: /usr/tmp/packet1
    Packet type: Update
    Packet fragment 1 of 8
    Packet identifier is: 946c832c.13d811da.9af0.00:01:80:fd:d8:5d
    Packet fragment identifier is: 946c8330.13d811da.9af0.00:01:80:fd:d8:5d
    VOB family identifier is: c3f47cf3.71b111cd.a4f2.00:01:80:31:7a:a7
    Comment supplied at packet creation is:
    Packet intended for the following targets:
    sanfran_hub [ local to this network ] * tag: /vobs/tests
    Originating replica is: sydney
    The following replicas are referenced by this packet:
    f3b1cd51.04b111d3.b2f0.00:c0:4f:96:17:d8
      first oplog id is 10
      incarnation is 06/29/95 12:18:09
    3f370590.04b211d3.b2f0.00:c0:4f:96:17:d8
      first oplog id is 0
      incarnation is 0
    8b354320.04c218k3.b5r0.00:c0:4f:99:27:f7
      first oplog id is 1
      incarnation is 07/21/95 11:45:20
    The major packet version is 4, the minor packet version is 0
    Packet is uncompressed.