NetWorker: How to use the DDPCONNCHK tool to test DD ddboost connectivity from NetWorker Hosts

           

   Article Number:     515965                                   Article Version: 4     Article Type:    How To 
   

 


Product:

 

NetWorker,Data Domain,Data Domain Boost

 

Instructions:

 

 

   

      DDPCONNCHK can be used to test ddboost connectivity for NetWorker servers, storage nodes, and clients. This is effective for testing ddboost user credentials and full DD communication from a given host.      
     
      1) Confirm your DDOS as this will depend on the script selected. This can be done from the NMC or by using nsradmin's "print type: nsr data domain; name: DD_NAME"   

   
      [root@nwserver ~]# nsradminNetWorker administration program.Use the "help" command for help, "visual" for full-screen mode.nsradmin> show os versionnsradmin> p type: nsr data domain; name: dd.lab.emc.com                  OS version: Data Domain OS 5.5.0.1-419976;    
    2) From a machine with FTP access navigate to: ftp://nwc:nwc@ftp.emc.com/ddpconnchk/   
    3) Click on the version that corresponds to your DD OS (or closest release)   
    4) Download the DDPCONNCHK package for your NetWorker host OS.   
      On Linux/UNIX hosts with FTP access this can be done by using the wget command.     
      On Windows hosts with FTP access the package can be downloaded through your web browser.   
   
    Linux/UNIX Hosts   
    1) Change to root user: sudo su -   
    2) Set the permissions of DDPCONNCHK so that root can execute: chmod 755 ddpconnchk_name   
      [root@nwserver ~]# chmod 775 ddpconnchk_linux_64[root@nwserver ~]# ls -l | grep ddpconnchk-rwxrwxr-x. 1 root     root        7283830 MM DD HH:MM ddpconnchk_linux_64    
    3) Run the DDPCONNCHK script against your Data Domain using your ddboost user configured for backups and password: ./ddpconnchk -s datadomain_name -u ddboost_user -T writeimage   
    note: When prompted enter the ddboost user password. The "-T writeimage" is optional this will test/confirm whether you are able to write to the device from the host you are running the command on.   
              Also note: the default size is 256KB.  Thus if the desire is to test performance, you will need to use a higher file size if 256KB is transferred too quickly to get a valid speed.   
              example: -i 10m  (means file size of 10MB.   Max file size is 1 GB)   
      [root@nwserver ~]# ./ddpconnchk_linux_64 -s ddve.lab.emc.com -u sysadmin -T writeimageEnter password for primary server ddve.lab.emc.com:DDP CLIENT LIBRARY VERSION 3:0:2:0-480717SERVER: ddve.lab.emc.com-----------------------------*** BASIC CONNECTIVITY TEST, ddve.lab.emc.comDDLOG: ERR: [6976:1FB2FC0] Pormap trying to connect to address IP_ADDRBasic DDP Connectivity Test PASSED*** CONNECT SERVER TEST, ddve.lab.emc.comDDP Connect Server Test PASSED*** LIST SUs TEST, ddve.lab.emc.com  1 SUs totalList SUs Test PASSEDNo storage-unit specified.Create default storage unit DDPCONNCHK_SU_SRC...Create default storage unit DDPCONNCHK_SU_SRC DONE*** EXTENDED TEST: WRITE IMAGE, ddve.lab.emc.com/DDPCONNCHK_SU_SRC/262144DDLOG: INFO: [6976:1FB2FC0] ddcl_new_client_buffers created private pool with 776 DDCL buffersDDLOG: INFO: [6976:1FB2FC0] vrapid_nfs_connect: ifgroup disabledDDLOG: INFO: [6976:1FB2FC0] JOB END  IMAGE_DELETE ip=IP_ADDR pid=26998 cd=0 enc=offDDLOG: INFO: [6976:1FB2FC0] JOB START  IMAGE_WRITE ip=IP_ADDR pid=26998 cd=0 enc=offDDLOG: INFO: [6976:1FB2FC0] New fingerprint environment.DDLOG: INFO: [6976:1FB2FC0] Segmentation: version [9], min [4096], avg [8192], max [12288], mask = [0x0], skip_first [4096], skip_last [0]DDLOG: INFO: [6976:1FB2FC0] ddcl_new_client_buffers created private pool with 776 DDCL buffersDDLOG: INFO: [6976:1FB2FC0] Allocated read_ctx_pool of size 260736DDLOG: INFO: [6976:1FB2FC0] JOB START  IMAGE_READ ip=IP_ADDR pid=26998 cd=0 enc=offTotal write time: 0 secondsTotal read time: 0 secondsDelete default storage-unit DDPCONNCHK_SU_SRC...Delete default storage-unit DDPCONNCHK_SU_SRC DONEWRITE IMAGE PASSEDSUCCESS: All tests completed    
   
    On Windows Hosts   
    1) Extract the ddpconnchk .zip package   
    2) Open an elevated (Administrator) command prompt and cd to the extracted ddpconnchk directory   
    3) Run the DDPCONNCHK script against your Data Domain using your ddboost user configured for backups and password: ddpconnchk -s datadomain_name -u ddboost_user -T writeimage   
    note: The "-T writeimage" is optional this will test/confirm whether you are able to write to the device from the host you are running the command on.   
              Also note: the default size is 256KB.  Thus if the desire is to test performance, you will need to use a higher file size if 256KB is transferred too quickly to get a valid speed.   
              example: -i 10m  (means file size of 10MB.   Max file size is 1 GB)   
      C:\Users\Administrator\Downloads\win_64>ddpconnchk -s ddve.lab.emc.com -u sysadmin -p Pa$$w0rd01 -T writeimageDDP CLIENT LIBRARY VERSION 3:0:2:0-480717SERVER: ddve.lab.emc.com-----------------------------*** BASIC CONNECTIVITY TEST, ddve.lab.emc.comDDLOG: ERR: [30A8:2D74] Pormap trying to connect to address IP_ADDRBasic DDP Connectivity Test PASSED*** CONNECT SERVER TEST, ddve.lab.emc.comDDP Connect Server Test PASSED*** LIST SUs TEST, ddve.lab.emc.com  1 SUs totalList SUs Test PASSEDNo storage-unit specified.Create default storage unit DDPCONNCHK_SU_SRC...Create default storage unit DDPCONNCHK_SU_SRC DONE*** EXTENDED TEST: WRITE IMAGE, ddve.lab.emc.com/DDPCONNCHK_SU_SRC/262144DDLOG: INFO: [30A8:2D74] ddcl_new_client_buffers created private pool with 776 DDCL buffersDDLOG: INFO: [30A8:2D74] vrapid_nfs_connect: ifgroup disabledDDLOG: INFO: [30A8:2D74] JOB END  IMAGE_DELETE ip=IP_ADDR pid=12456 cd=0 enc=offDDLOG: INFO: [30A8:2D74] JOB START  IMAGE_WRITE ip=IP_ADDR pid=12456 cd=0 enc=offDDLOG: INFO: [30A8:2D74] New fingerprint environment.DDLOG: INFO: [30A8:2D74] Segmentation: version [9], min [4096], avg [8192], max [12288], mask = [0x6d5ef6b5], skip_first [4096], skip_last [0]DDLOG: INFO: [30A8:2D74] ddcl_new_client_buffers created private pool with 776 DDCL buffersDDLOG: INFO: [30A8:2D74] Allocated read_ctx_pool of size 204864DDLOG: INFO: [30A8:2D74] JOB START  IMAGE_READ ip=IP_ADDR pid=12456 cd=0 enc=offCumulative Write Throughput: 0.25 MB/sTotal read time: 0 secondsDelete default storage-unit DDPCONNCHK_SU_SRC...Delete default storage-unit DDPCONNCHK_SU_SRC DONEWRITE IMAGE PASSEDSUCCESS: All tests completed    
   
    The above outputs indicate that the host can communicate with and write to the DD using the the ddboost user and protocols.   
                                                                                                                                

 

 

Notes:

 

 

Usage:     
        ddpconnchk     
         -s <server_name/ip>      # For primary server     
         -u <username>     
         -p <passwd>              # NOTE: will prompt if -u, but not -p, is specified     
         -l <su_name>             # NOTE: Optional. Default for extended tests: DDPCONNCHK_SU_SRC     
         -S <server_addr/ip>      # For secondary server (opt-dup target)     
         -U <username>     
         -P <passwd>              # NOTE: will prompt if -U, but not -P, is specified     
         -L <su_name>             # NOTE: Optional. Default for extended tests: DDPCONNCHK_SU_DST     
         -T optdup | writeimage   # Select extended test     
         -i <image_size in k/m/g> # NOTE: Optional. Default 256kB. Max 1 GB. Only for extended tests.     
         -n <num_streams>         # NOTE: Optional. Default 1. Only for extended tests     
         -D <scan_all | gen_scsi_devname | DFC-server-name>     
                                  # DFC evaluation     
         -v                       # Verbose output     
         -d <log-level>           # DDCL Log messages level. Use 0 - mute, 1 - errors only, 2 - errors and warnings , 3 - errors warnings and info, 4 - all. 2 is the default level     
         -B                       # Use builtin DDP API (not libDDBoost)