Creating and Editing Actions in the CLI

1. The same progress information can be displayed in the CLI, with the state sending shown for a replication in progress:

   otoro:shares otoro-proj-01 action-000> show
   Properties:
                      id = 80a96f4f-93fe-4abd-eb54-fb82e7f8c69f
                  target = chutoro
              continuous = false
           include_snaps = true
           max_bandwidth = unlimited
              bytes_sent = 505M
          estimated_size = 3.0G
     estimated_time_left = 00:00:41
      average_throughput = 63MB/s
                 use_ssl = false
                   state = sending
       state_description = Sending update
             next_update = Sync now
               last_sync = Sun Jul 14 2013 06:04:38 GMT+0000 (UTC)
                last_try = Sun Jul 14 2013 06:04:38 GMT+0000 (UTC)
             last_result = success
   

2. Note: Replication can take a long time to complete, depending on the size of the data being replicated. Use the progress information to determine the update status. For initial replication, it is important to not interrupt it, including, but not limited to, restarting the ZFSSA or canceling the update; otherwise, the entire initial replication must be restarted.
3. Replication target information can be displayed in the CLI with the state actions:

   otoro:configuration services replication targets> show
   
   Targets:
        TARGET        LABEL            ACTIONS
        target-000    oakmeal          1
   
   otoro:configuration services replication targets> select target-000
   
   otoro:configuration services replication target-000> show
   Properties:
                  address = 10.153.34.167:216
                    label = oakmeal
                 hostname = oakmeal-7320-167
                      asn = 4913649f-7549-6d2a-866b-987ddbc4e163
                  actions = 1
   
   oakmeal-7320-167:configuration services replication target-000> actions 
        POOL          PROJECT          SHARE 
        pool1         project1         (multiple) 
   
   

4. When using the CLI, it can be helpful to know the ID of the newly created replication action. The ID is used later to select the correct replication action node. To view the ID of the newly created action, use the command last to navigate to the node with the new replication action. Then use the command get id to retrieve the action ID:

   otoro:> shares
   otoro:shares> select p1
   otoro:shares p1> replication
   otoro:shares p1 replication> create
   otoro:shares p1 action (uncommitted)> set target=oakmeal
                          target = oakmeal (uncommitted)
   otoro:shares p1 action (uncommitted)> set pool=p
                            pool = p (uncommitted)
   otoro:shares p1 action (uncommitted)> set use_ssl=false
                         use_ssl = false (uncommitted)
   otoro:shares p1 action (uncommitted)> commit
   otoro:shares p1 replication> last
   otoro:shares p1 action-001> get id
                              id = fb1bb3fd-3361-42e1-e4a1-b06c426172fb
   otoro:shares p1 action-001> done
   otoro:shares p1 replication>