Previous Topic: OverviewNext Topic: Commands


Assumptions

The assumptions are that both CA Vtape and CA Cloud Storage for System z have been installed following the directions in the z/OS Installation Guide and the chapter "Installation" in this guide.

Verify and know the items in the following checklist:

Configuration Procedure

Follow these steps:

  1. Use a telnet session to log on to your 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. Select the ACL option, in the Setup menu, to modify the syslog permissions.
  4. Add the following line in the editor:
    /usr/bin/setfacl -m g:cacloud:r /var/log/messages
    

    The following is an example of adding 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.

    You return to the Setup main menu.

  6. Select CONFIG in the Setup menu to configure the CTC and other Linux Server settings.

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

  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 FSTAB in the Setup menu 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 various file systems and is read only by programs.

  11. Add your NFS mount point similar to the last line in the following:
    /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
    141.202.219.10:/rfs/dev1        /var/lib/cacloud/vault_01/mp_01 nfs     rsize=131072,tcp,nolock,wsize=131072,intr,nfsvers=3,addr=141.202.219.10,bg      0       0
    
  12. Save your changes and exit the editor.

    You return to the Setup main menu.

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

    A crontab file contains instructions to 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 MISC in the Setup menu to update the system.

    This 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 REPORTS in the Setup menu 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.

    The following 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 SITEINFO from the Setup menu, to enter information about your installation site. The CA Cloud Storage for System z Server uses this information in reports for billing services.

    The following is an example of 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 Quit from the Setup menu 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 VOLSER ranges that match what you define on CA VTape on z/OS.