Difference between revisions of "Vnx-autoconf"

From VNX
Jump to: navigation, search
(Executing commands: tag)
(Executing commands: tag      )
Line 41: Line 41:
 
=== Executing commands: <exec> tag &nbsp; &nbsp; &nbsp; ===
 
=== Executing commands: <exec> tag &nbsp; &nbsp; &nbsp; ===
  
<exe> tag is used to execute commands on the virtual machines. The commands to be executed are  
+
<exe> tag is used to execute commands on the virtual machines. The commands to be executed are specified in the tag value. The way commands are specified depends on the value of '''type''' attribute:
 
+
<ul>
Depending on the '''type''' attribute  
+
<li>'''verbatim''', in this case, the tag value directly specifies the commands to execute, in one or several lines</li>
 
+
<li>'''file''', in this case, the tag value specifies the name of a file which contains the commands to execute.</li>
The commands to execute or the name
+
</ul>
  
 
=== Creating composed command sequences: <cmd-seq> tag ===
 
=== Creating composed command sequences: <cmd-seq> tag ===

Revision as of 00:29, 27 August 2015

Autoconfiguration and Command Execution (ACE)

Command execution

Users can directly interact with virtual machines through their consoles or management interfaces. However, in order to automate the execution of commands in virtual machines, VNX provides three tags for that purpose:

  • <filetree>, to copy of files from the host to the virtual machines,
  • <exec>, to execute commands inside virtual machines, and
  • <cmd-seq>, to create composed command sequences.

All of them have an attribute named "seq" that allows to associate a string identifier to them. This identifier is used to invoke the execution of that commands from the VNX command line. For example:

vnx -f tutorial_lxc_ubuntu.xml --execute start-www

will execute all the commands defined in 'tutorial_lxc_ubuntu.xml' with the attribute seq='start-www'. The parameter passed to '--execute' option can be a comma-separated list of seq identifiers to allow executing several set of commands. For example:

vnx -f tutorial_lxc_ubuntu.xml --execute stop-www,start-www

will execute in sequentially the set of commands identified by 'stop-www' and 'start-www'.

For a given seq value, all <filetree> commands are always executed before <exec> ones.

Copying files: <filetree> tag    

<filetree> tag is used to copy files from the host to a virtual machine. The value inside the tag specifies the file or directory to be copied to the virtual machine.

The destination directory or filename inside the virtual machine where the file(s) will be copied is specified using the 'root' attribute.

By convention, directory names have to be terminated with an '/' to distinguis them from filenames.

The attributes user, group and perms can be used to specify respectively the owner, group and permisions of the files copied. Permissions have to be specified using linux numerical style (i.e. '644').

Examples:

  • Copy all the files and directories under host directory conf/R1/1 (relative path to the directory where the XML file resides) to /etc/quagga directory of VM:
  • <filetree seq='copy1' root='/etc/quagga/'>conf/R1/1/</filetree>
    
  • Copy the host file conf/H2/test-page.html to /var/www/html directory, change its name to index.html, change its owner:group to www-data:www-data and change its permissions to 644
  • <filetree seq='copy2' user='www-data' group='www-data' perms='644' root='/var/www/html/index.html'>
      conf/H2/test-page.html
    </filetree>'
    

Executing commands: <exec> tag      

<exe> tag is used to execute commands on the virtual machines. The commands to be executed are specified in the tag value. The way commands are specified depends on the value of type attribute:

  • verbatim, in this case, the tag value directly specifies the commands to execute, in one or several lines
  • file, in this case, the tag value specifies the name of a file which contains the commands to execute.

Creating composed command sequences: <cmd-seq> tag

The "ostype" attribute is used to specify the type of command included in <exec> tag, either command line (CLI) or graphical (GUI), and whether vnx tool waits for command execution end or not. For values are posible:

ostype Type of commands Waits for command execution end
system CLI YES
exec CLI NO
xsystem GUI YES
xexec GUI NO

Autoconfiguration

To be completed....