Previous Topic: Example ConfigurationNext Topic: Verify the Configuration


Configure CA Cloud Storage for System z

Configure CA Cloud Storage for System z Linux Server with two z/OS LPARs communicating with a CA Cloud Storage for System z server.

Follow these steps:

  1. Use a telnet session to log in to Linux on System z.
  2. Run the following command and provide a root password, to open the Setup menu:
    sudo cacloud setup
    root's password:
    
  3. To modify syslog permissions, select Setup, ACL from the menu.
  4. Add the following line in the editor:
    /usr/bin/setfacl -m g:cacloud:r /var/log/messages
    

    This example adds the setfacl statement. Lines starting with '#' are comments.

    # the firewall,acpid,NetworkManager log files
    # are used by syslog-ng and rsyslog only, the
    # other by all syslog daemons.
    /var/log/warn /var/log/messages /var/log/allmessages /var/log/localmessages /var/log/firewall /var/log/acpid /var/log/NetworkManager {
    
    compress
    dateext
    maxage 365
    rotate 99
    missingok
    notifempty
    
    size +4096k
    create 640 root root
    sharedscripts
    postrotate
     /etc/init.d/syslog reload
     /usr/bin/setfacl -m g:cacloud:r /var/log/messages   <- Added line.
    endscript
    
    }
    
  5. Save your changes and exit the editor.
  6. Select Setup > CONFIG to configure the CTC and other Linux Server settings.

    An editor screen opens for the file /etc/cacloud/subsystems.conf. To change the port where the TCP/IP listener looks to accept connection requests from CA Vtape, use the following panel:

  7. Page down to change the CTC definitions.
  8. Type the CTC addresses that you use to communicate with the instance of CA Vtape on z/OS.
  9. Save your changes and exit the editor.

    You return to the Setup main menu.

  10. Select Setup > FSTAB to update the files table. The Linux system mounts the mount points you defined in Mount Point Planning.

    The file FSTAB contains information about the read-only file systems.

  11. Add your NFS mount point similar to the last line in the example:
    /dev/disk/by-path/ccw-0.0.0200-part1 swap                 swap       defaults              0 0
    /dev/disk/by-path/ccw-0.0.0201-part1 /                    ext3       acl,user_xattr        1 1
    /dev/disk/by-path/ccw-0.0.0202-part1 /usr                 ext3       acl,user_xattr        1 2
    proc                 /proc                proc       defaults              0 0
    sysfs                /sys                 sysfs      noauto                0 0
    debugfs              /sys/kernel/debug    debugfs    noauto                0 0
    devpts               /dev/pts             devpts     mode=0620,gid=5       0 0
    
    ip_address:/nfs_export_name /var/lib/cacloud/vault_01/mp_nn nfs rsize=131072,tcp,nolock,wsize=131072,intr,nfsvers=3
    
    
    ip_address

    Indicates the IP address of the NFS device.

    nn

    Indicates the mount point number.

  12. Save your changes and exit the editor.

    You return to the Setup main menu.

  13. Select Setup > JOBS to verify that the cacloud definitions were automatically set up in the crontab file by the rpm.

    The crontab file instructs the cron daemon to run this command at this time on this date. For more details type man crontab, 5, and press Enter.

    ##
    ## (Cron table entries used for cacloud
    ##
    
    5 4 * * 1-6 test -x /usr/local/bin/cacloud && /usr/local/bin/cacloud --text scr_sync --live --verbose 2>&1 >> /var/lib/cacloud/reports/scr_sync   # Run scratch sync  Mon-Sat @ 4:05am
    5 5 * *  *  test -x /usr/local/bin/cacloud && /usr/local/bin/cacloud --text mp_stats                  2>&1 >> /var/lib/cacloud/reports/mp_stats   # mountpoint stats  daily   @ 5:05am
    35 5 * *  *  test -x /usr/local/bin/cacloud && /usr/local/bin/cacloud --text vol_stats                 2>&1 >> /var/lib/cacloud/reports/vol_stats  # Get volume stats  daily   @ 5:35am
    
    ## | | | |  |  |
    ## | | | |  |  +- command to be executed  ## optional comments
    ## | | | |  +---- day of week (0 - 6) (Sunday=0)
    ## | | | +------- month (1 - 12)
    ## | | +--------- day of month (1 - 31)
    ## | +----------- hour (0 - 23)
    ## +------------- min (0 - 59)
    
  14. Save your changes and exit the editor.

    You return to the Setup main menu.

  15. Select Setup > MISC to update the system.

    This command starts the Linux Server when the Linux system initializes.

  16. Type Y to set up automatic start and return to the Setup main menu.
    cacloud-app-server  on
    Start cacloud-app-server on boot, Y|N?
    
  17. Select Setup > REPORTS to verity that the rpm set up the report log rotations.

    The CA Cloud Storage for System z server creates a log file as part of its ongoing operations.

    This code is an example of the Scratch Sync log rotation instructions:

    #  Rotate cacloud logfiles
    #
    /var/lib/cacloud/reports/scr_sync {
            nocompress
            dateext
            maxage 120
            rotate 12
            missingok
            notifempty
            size 4096k
            create
            sharedscripts
            weekly
    }
    
  18. Exit the editor environment to return to the Setup main menu.
  19. Select Setup > SITEINFO and enter information about your installation site. The CA Cloud Storage for System z Server uses this information in reports for billing services.

    This example shows the SITEINFO information:

    ## Customer Information
    CustomerInfo() {
    ##
    ## PURPOSE: Describe contact information
    ##
    ## CA Assigned Customer Site id, e.g. CUSTOMER_SITE_ID="12345"
       CUSTOMER_SITE_ID="EVAL Site"
    
    ## CA Assigned Customer SAP Contract Number, e.g. CUSTOMER_SAP="CS4Z-12345"
       CUSTOMER_SAP_CONTRACT="Unlicensed evaluation copy"
    
    ## The name of your company, e.g. CUSTOMER_NAME="CA Technologies"
       CUSTOMER_NAME="Your Company Name"
    ## Customer contact information, e.g. CUSTOMER_CONTACT="John Doe"
       CUSTOMER_CONTACT="John Doe"
    
    ## Customer contact email address, e.g. CUSTOMER_EMAIL="John.Doe@anycompany.com"
       CUSTOMER_EMAIL="john.doe@mycompany.com"
    ## Customer misc notes, e.g. CUSTOMER_NOTES="Phone# (111) 222-3333"
    #  CUSTOMER_NOTES="uncomment to enter one additional line of information here"
    }
    
  20. Exit the editor environment to return to the Setup main menu.
  21. Select Setup > Quit to leave the setup session.

You completed the setup tasks for CA Cloud Storage for System z Linux Server. The final customization task is to define the VOLSER ranges that match what you define on CA Vtape on z/OS.