You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@vcl.apache.org by jf...@apache.org on 2013/01/08 17:37:56 UTC

svn commit: r1430372 [2/11] - /vcl/site/trunk/content/confluence_export/

Added: vcl/site/trunk/content/confluence_export/adding-new-os-module.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/adding-new-os-module.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/adding-new-os-module.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/adding-new-os-module.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,60 @@
+Title: Adding New OS Module
+This is a short guide on how to set up development environment for a OS
+Module.
+
+<a name="AddingNewOSModule-InstallVCL"></a>
+# Install VCL
+
+* ...
+
+<a name="AddingNewOSModule-SettingupanewOSModule"></a>
+# Setting up a new OS Module
+
+* Start by creating a Module/OS/...pm file.
+** See the other OS Module for examples.
+** Set the package path in the file
+package VCL::Module::OS::...;
+
+* Add an entry to the module table pointing to your new module with the
+package path mentioned above.
+
+* Add an entry to the OS table pointing to the entry you add to the module
+table.
+
+* Add entries to the image and imagerevision table for a base new image,
+with image.OSid pointing to the entry you add to the OS table.
+
+* Enter the computer information for a loaded new machine into VCL and make
+sure that the management node can access this machine via SSH.
+
+* Insert the code you want to test at the
+beginning of the process() subroutine in new.pm, followed by a call to
+exit:
+
+
+    sub process {
+    my $self = shift;
+    
+    my $request_data = $self->data->get_request_data();
+    ...
+    my $imagerevision_id = $self->data->get_imagerevision_id();
+    
+    
+    print "\n\n---\n\n";
+    
+    my $ip = $self->os->get_public_ip_address();
+    print "IP: $ip\n";
+    
+    print "\n\n---\n\n";
+    exit;
+    ...
+
+
+* To test things over and over again, run a script which inserts entries
+into the request and reservation tables with the request state and
+laststate set to 'new'.  vcld picks up the reservation, configures
+everything as it would for a normal reservation, calls new.pm::process(),
+test code is executed, then the process exits.
+
+* Once this is set up, it should be pretty efficient to test all of the
+subroutines in OS module.

Added: vcl/site/trunk/content/confluence_export/adding-xcat-kickstart-based-image.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/adding-xcat-kickstart-based-image.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/adding-xcat-kickstart-based-image.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/adding-xcat-kickstart-based-image.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,104 @@
+Title: Adding xCAT kickstart based image
+<a name="AddingxCATkickstartbasedimage-GuideforaddingkickstartinstallsusingxCATtotheVCLdatabase."></a>
+### Guide for adding kickstart installs using xCAT to the VCL database.
+
+
+xCAT is the bare-metal provisioning tool primarily used within VCL. It has
+the ability to install&nbsp;physical nodes with an operating system such
+as; windows Red Hat, CentOS, ESX, SLES on x86 based hardware.&nbsp; This
+guide will discuss adding support to VCL for kickstart based or diskfull
+installs.&nbsp;
+
+Prerequisites&nbsp;are that you need to have a working xCAT install. Please
+see xCAT installation guide in order to install and configure xCAT.&nbsp;
+* xCAT main page:&nbsp;[http://xcat.sourceforge.net/](http://xcat.sourceforge.net/)
+* xCAT Getting Started guide:&nbsp;[http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_Documentation](http://sourceforge.net/apps/mediawiki/xcat/index.php?title=XCAT_Documentation)
+
+<a name="AddingxCATkickstartbasedimage-KickstartTemplatefiles"></a>
+### Kickstart Template files
+
+The template files used by xCAT reside in
+/opt/xcat/share/xcat/install/<distro>. distro can be rh, centos, fedora,
+esx, etc. Make sure to have a working template file. There are several
+examples in either of the distro directories that can used as a starting
+point. Once you have a working template, proceed to adding to the VCL
+database.
+
+<a name="AddingxCATkickstartbasedimage-AddingkickstartbasedinstalltotheVCLdatabase&nbsp;"></a>
+### Adding kickstart based install to the VCL database&nbsp;
+
+The name of the template file and the image.name must match. VCL uses this
+name to check for and properly load using kickstart method. The xcat name
+will have the .tmpl, for example the vcl image.name entry of
+*rhel5-base25-v0* the template file for xcat will be
+*rhel5-base25-v0.tmpl.*&nbsp;
+
+There are three tables that need to have entries before you can start using
+the image through the VCL web interface. The tables used are:
+* image
+* imagerevision
+* resource
+
+Depending on your OS and the version of VCL, you might need to also create
+a new entry in the OS table. An example of adding a new OSid is discussed
+below.
+
+In our sql statement examples we will use RedHat 5 and the image id of 25
+as above&nbsp;*rhel5-base25-v0.* &nbsp;In the below sql statement make any
+changes as needed such as ownerid, in this example it is set to 1 or the
+admin user id.
+
+
+
+{tip:icon=false}{color:#222222}INSERT INTO `image` (id, `name`,
+`prettyname`, `ownerid`, `platformid`, `OSid`, `minram`, `minprocnumber`,
+`minprocspeed`, `minnetwork`,{color}
+{color:#222222}`reloadtime`, `deleted`, `lastupdate`, `forcheckout`,
+`maxinitialtime`,`project`, `size`) VALUES (25, 'rhel5-base25-v0', 'RHEL 5
+base', 1, 1, 19, 1024, 1, 0, 10, 14, 0, NOW(), 1, 0, 'vcl',
+1045);{color}{tip}
+
+
+{tip:icon=false}INSERT INTO `imagerevision` (`imageid`, `revision`,
+`userid`, `datecreated`, `deleted`, `production`,
+`comments`, `imagename`) VALUES (25, 0, 1, NOW(), 0, 1, NULL,
+'rhel5-base25-v0');{tip}
+{tip:icon=false}
+
+{color:#222222}INSERT INTO `resource` (`resourcetypeid`, `subid`) VALUES
+(13, 25);{color}
+
+{tip} {color:}&nbsp;Again, the xCAT template .tmpl file must match the the
+entry VCL database entry of image.name. &nbsp;{color}
+{color:}{color}
+VCL image.name = rhel5-base25-v0 {color:}xCAT template file name =
+rhel5-base25-v0.tmpl{color}
+{color:}At this point you will be able to manage this image through the VCL
+interface.&nbsp;{color}
+* {color:#222222}Go to Manage images&nbsp;{color}
+* {color:#222222}Edit image grouping{color}
+* {color:#222222}Select image group mapped to load onto your bare-metal blades. See{color} {color:#222222}[adding computers to VCL](https://cwiki.apache.org/VCL/vcl-221-further-steps-if-using-xcat.html)
+{color} {color:#222222}if you have not added any&nbsp;physical&nbsp;nodes
+yet.{color}
+* {color:#222222}Add '{color}{color:#222222}RHEL 5 base' to the desired
+image group{color}
+
+<a name="AddingxCATkickstartbasedimage-{color:#222222}Testingkickstartfile{color}"></a>
+### {color:#222222}Testing kickstart file{color}
+
+{color:#222222}Test the load, by either making a reservation for the new
+environment or try to reload
+a&nbsp;{color}{color:#222222}physical&nbsp;node through manage computers
+computer utilities. Watch the vcld.log file to view the processing and to
+debug any issues that may occur.{color}
+
+<a name="AddingxCATkickstartbasedimage-ExtendingtheOStable"></a>
+### Extending the OS table
+
+If VCL supports the OS, extending the OS table for a new OS is fairly
+straight forward. In this example we will use Red Hat 6.
+
+{tip:icon=false}INSERT INTO `OS` (`name`, `prettyname`, `type`,
+`installtype`, `sourcepath`, `moduleid`) VALUES('rhel6','RedHat Enterprise
+6','linux','kickstart','rhel6',(SELECT `id` FROM `module` WHERE `name` LIKE
+'os_linux'));{tip}

Added: vcl/site/trunk/content/confluence_export/additional-steps-for-linux-images.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/additional-steps-for-linux-images.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/additional-steps-for-linux-images.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/additional-steps-for-linux-images.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,30 @@
+Title: Additional Steps for Linux Images
+On the *Connect\!* page, the following connection information will be
+displayed:
+* The remote VCL computer's IP address
+* The userid to use (it should be your own)
+* The password to use when connecting
+
+Log in using ssh. You can use X11 forwarding (and if not connecting from
+unix, an X11 server on your own machine) to run graphical applications.
+
+After you have logged in to the remote machine, you can gain root access by
+running the command *sudo bash*
+
+You have up to 8 hours to configure and save your image before the
+reservation expires and the node is wiped clean.
+
+The following steps form a good guideline of what to do while creating your
+image:
+1. Install your applications. Here are some suggestions/tips on loading
+software to the remote machine:
+1. * If you have access to enough network storage, it may be easiest to copy
+the software installation files in network filespace and access them from
+the remote machine.
+1. * Copy the media to the remote machine using SCP (WinSCP is a good and
+simple SCP application for Windows)
+1. Post install of software:
+1. * remove any copies of software media (needlessly takes up space in the
+image which increases the loading time for new reservations of the image)
+1. * Configure any application customizations
+1. [Save the Image](save-the-image.html)

Added: vcl/site/trunk/content/confluence_export/additional-steps-for-windows-images.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/additional-steps-for-windows-images.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/additional-steps-for-windows-images.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/additional-steps-for-windows-images.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,58 @@
+Title: Additional Steps for Windows Images
+On the *Connect\!* page, the following connection information will be
+displayed:
+* The remote VCL computer's IP address
+* The user ID you will use: Administrator
+_Note: the user ID is always Administrator for Windows imaging
+reservations_
+* A one-time password for the Administrator account
+
+Log in using Remote Desktop Connection. You can either enter the connection
+information manually after launching the Remote Desktop Connection program
+or you can use a pre-configured RDP file:
+* Click the Get RDP File button
+* Save the RDP file to your computer
+* Double-click the RDP file to launch the Remote Desktop Connection program
+with the VCL connection information pre-configured
+
+You have up to 8 hours to configure and save your image before the
+reservation expires and the node is wiped clean.
+
+The following steps form a good guideline of what to do while creating your
+image:
+1. Run Windows Update before saving an image.&nbsp; It's OK if the computer
+needs to reboots. &nbsp;It can take 4-6 minutes for the computer to reboot
+before you can connect via RDP again.
+1. Install your applications. Here are some suggestions/tips on loading
+software to the remote machine:
+1. * Copy the&nbsp;software from your local computer to the remote computer
+by sharing your local drives through Remote Desktop Connection.&nbsp; The
+shared drives show up in Windows Explorer on the&nbsp;remote machine.&nbsp;
+Do not run the software's installation program directly from the shared
+drive.&nbsp; Copy it to the remote computer first, run the setup program,
+then delete the installation files.
+1. * If you have an ISO image of the software, copy the ISO file to the
+remote machine using a shared drive then mount the ISO image as a drive
+letter.&nbsp; The freeware program MagicDisc does this very well:
+[http://www.magiciso.com/tutorials/miso-magicdisc-overview.htm](http://www.magiciso.com/tutorials/miso-magicdisc-overview.htm)
+Install MagicDisc, mount the ISO file, and then run the application's
+installation program from the mounted drive.&nbsp; When the installation is
+done, unmount the drive and delete the ISO file from the remote
+machine.&nbsp; Uninstall MagicDisc before saving your image if you don't
+want it included.
+If you have a physical CD or DVD, you can create an ISO image using a
+program such as LC ISO Creator:
+[http://www.lucersoft.com/freeware.php](http://www.lucersoft.com/freeware.php)
+1. * If you have access to enough network storage, you can copy the software
+installation files&nbsp;to the&nbsp;network filespace and access them from
+the remote machine.
+1. * Copy the media contents using SCP from the remote computer.&nbsp; If you
+have a personal machine running an SSH server you can use this
+method.&nbsp; You could also do the same thing using FTP.
+1. Post install of software:
+1. * Remove any copies of software media (needlessly takes up space in the
+image which increases the loading time for new reservations of the image)
+1. * make sure all wanted desktop icons are in "All users" desktop.
+1. * Configure any application customizations
+1. * [perform customizations to the default user profile](configure-the-default-profile.html)
+1. [Save the Image](save-the-image.html)

Added: vcl/site/trunk/content/confluence_export/advanced-image-options.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/advanced-image-options.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/advanced-image-options.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/advanced-image-options.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,71 @@
+Title: Advanced Image Options
+There are several advanced options for each image that can be modified.
+Normally, they can be left alone. However, there are times where it is
+useful to set them. These are the advanced options and their descriptions.
+They are listed in the same order they appear on the Edit Image page.
+
+The following advanced options are compared directly to corresponding
+computer attributes of the VCL computers. Configuring these fields
+restricts which computers can be assigned to run the image based on
+computer specs.
+<table>
+<tr><th>Minimum RAM (MB)</td><td>This is the minimum RAM required for the image to
+function and is specified in MB. This is useful if the image has software
+installed that will not function without at least some specific amount of
+RAM. The VCL scheduler will not assign a user a computer to run the image
+that has less RAM than what is specified here.</td></tr>
+<tr><th>Minimum Num of Processors</td><td>This is the minimum number of processors
+required for the image to function. This is useful if the image has
+software installed that will not function without at least some specific
+number of processors. The VCL scheduler will not assign a user a computer
+to run the image that has fewer processors than what is specified here.
+*NOTE*: It is up to the VCL site administrators to determine if this field
+and the corresponding *No. Processors* computer field mean actual
+processors or processor cores. Most often, it makes the most sense to have
+it mean processor cores.</td></tr>
+<tr><th>Minimum Processor Speed (MHz)</td><td>This is the minimum processor speed
+required for the image to function and is specified in MHz. This is useful
+if the image has software installed that will not function without at least
+a specific processor speed. The VCL scheduler will not assign a user a
+computer to run the image that has a slower processor speed than what is
+specified here.</td></tr>
+<tr><th>Minimum Network Speed (Mbps)</td><td>This is the minimum network speed required
+for the image to function and is specified in Mbps. This is useful if the
+image has software installed that will not function without at least a
+specific network speed. The VCL scheduler will not assign a user a computer
+to run the image that has a slower network speed than what is specified
+here. This only refers to the speed at which the VCL computer is connected
+to the network. It is not related to the end user's network connection.</td></tr>
+</table>
+
+These advanced options are only related to the image itself.
+
+<table>
+<tr><th>Maximum Concurrent Usage</td><td>This field allows the concurrent usage of the
+image to be limited. It is very useful if you only have a fixed number of
+licenses for an application installed in the image, but no network license
+manager to limit concurrent use. Leave the field empty for unlimited use.
+Enter a number to limit concurrent use of the image to that number.</td></tr>
+<tr><th>Estimated Reload Time (min)</td><td>This is the estimated amount of time it will
+take the image to be loaded. It is only relevant for the first few
+reservations of an image. After that, historical data is used to estimate
+the load time.</td></tr>
+<tr><th>Available for checkout</td><td>This field controls whether this image can show up
+on the New Reservations page (if set to yes, the appropriate permissions
+still need to be set for it to show up). The intended use of this field is
+for cluster environments where an image will have several sub images. In
+some of those cases, it doesn't make sense for end users to be able to make
+a reservation for the sub  images directly. In those cases, set this field
+to *No*. Otherwise, you should leave it as *Yes*.</td></tr>
+<tr><th>Check for logged in user</td><td>If set to *yes*, VCL will perform checks to see
+if a user is connected to a reservation for this image. If a user has
+connected, but disconnects and stays disconnected for 15 minutes, then VCL
+will consider the reservation to be inactive. It will time out the
+reservation and reclaim the machine for someone else to use. Setting this
+option to *no* disables this check, causing the reservation to exist until
+its end time, even if no one is connected to it.</td></tr>
+<tr><th>User group allowed to log in</td><td>This options is antiquated and should be
+left as *Any*.</td></tr>
+<tr><th>Subimages</td><td>This is used to create [Cluster Environments](cluster-environments.html)
+. Any subimages listed here will be checked out in addition to this image
+when a reservation is made for this image.</td></tr>

Added: vcl/site/trunk/content/confluence_export/apache-derby-database.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/apache-derby-database.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/apache-derby-database.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/apache-derby-database.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,107 @@
+Title: Apache Derby Database
+<a name="ApacheDerbyDatabase-UsingApacheDerbyDatabase"></a>
+# Using Apache Derby Database
+
+h4.{color:red} NOTE: The current code in the trunk does not support Derby
+(21 Aug 2009) {color}
+
+<a name="ApacheDerbyDatabase-*Prerequisites*"></a>
+## *Prerequisites*
+
+You should have installed:
+* JDK (it is maybe possible to work with jre only)
+
+<a name="ApacheDerbyDatabase-*DownloadingandSettingUptheDatabaseforVCL*"></a>
+## *Downloading and Setting Up the Database for VCL*
+
+1. Download Apache Derby and install it.
+
+    cd ~
+    wget
+http://apache.g5searchmarketing.com/db/derby/db-derby-10.5.1.1/db-derby-10.5.1.1-bin.tar.gz
+    tar -xzf db-derby-10.5.1.1-bin.tar.gz
+    mkdir /opt/Apache
+    mv db-derby-10.5.1.1-bin /opt/Apache/derby
+    export DERBY_HOME="/opt/Apache/derby"
+    export
+CLASSPATH="${DERBY_HOME}/lib/derby.jar:${DERBY_HOME}/lib/derbytools.jar:${CLASSPATH}"
+    PATH="$DERBY_HOME/bin:$PATH"
+
+1. Create a database in Apache Derby. The database has to be placed in the
+path _/opt/_.
+  Replace _'vcluser'_ and _'vcluserpassword'_ with the user and password
+you want.
+
+    cd /opt/
+    ij
+    connect
+'jdbc:derby:vcl1;create=true;user='vcluser';password='vcluserpassword';';
+    exit;
+
+1. Download _'vcl.sql'_ file and the _'derby-parser.pl'_.
+  The _'derby-parser.pl'_ can be found as an attachment to this page and
+_'vcl.sql'_ fron repositories.
+  Edit the file _'derby-parser.pl'_. the variables corresponding to the
+_'user'_ and _'password'_ should match your database.
+
+    svn export https://svn.apache.org/repos/asf/vcl/trunk/mysql/vcl.sql
+    chmod a+x derby-parser.pl
+    ./derby-parser.pl
+
+1. Import vcl-derby.sql file into database. It is a good idea to direct the
+output to file and check if there were any errors.
+
+    ij vcl-derby.sql > import.log
+
+
+<a name="ApacheDerbyDatabase-Settingupthedbd_jdbcServer"></a>
+## Setting up the dbd_jdbc Server
+1. Install log4j
+
+    cd ~
+    wget
+http://www.apache.org/dyn/closer.cgi/logging/log4j/1.2.15/apache-log4j-1.2.15.tar.gz
+    tar -zxf apache-log4j-1.2.15.tar.gz
+    mv apache-log4j-1.2.15 /opt/Apache/derby/lib/
+
+1. When installing the perl modules using the _'install_perl_libs.pl'_
+(_/usr/local/vcl/bin/install_perl_libs.pl_) two extra modules need to the
+installed for Derby. Open the file _'install_perl_libs.pl'_ and in the list
+of modules to download add the following two modules.
+
+    http://search.cpan.org/CPAN/authors/id/G/GB/GBARR/Convert-BER-1.3101.tar.gz
+    http://search.cpan.org/CPAN/authors/id/V/VI/VIZDOM/DBD-JDBC-0.71.tar.gz
+
+1. Run the scrips as normal
+
+    perl /usr/local/vcl/bin/install_perl_libs.pl
+
+1. Copy some file from the modules to Derby directory
+
+    cp /tmp/perl-modules/DBD-JDBC-0.71/dbd_jdbc.jar /opt/Apache/derby/lib/
+    cp /tmp/perl-modules/DBD-JDBC-0.71/log4j.properties
+/opt/Apache/derby/lib/apache-log4j-1.2.15
+
+1. Create a script file which will launch the dbd_jdbc Server. Save it under
+any name and directory (e.g. /opt/server.sh), only remember that this
+scrips needs to be executed every time you start up the server. The file
+should contain
+
+    #!/usr/bin/bash
+    java -Djdbc.drivers=org.apache.derby.EmbeddedDriver -Ddbd.port=12345
+-classpath
+/opt/Apache/derby/lib/derby.jar:/opt/Apache/derby/lib/dbd_jdbc.jar:/opt/Apache/derby/lib/apache-log4j-1.2.15/log4j-1.2.15.jar:/opt/Apache/derby/lib/apache-log4j-1.2.15/
+ com.vizdom.dbd.jdbc.Server &
+
+Note1: if some of your paths are different you need make the changes in
+this scrips file as well
+Note2: currently port 12345 is used for connecting to Derby, this is hard
+coded. Can be changed on a later stage.
+1. Make the script executable
+
+    chmod a+x /opt/server
+
+1. Start the Server
+
+    /opt/server
+

Added: vcl/site/trunk/content/confluence_export/apache-vcl.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/apache-vcl.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/apache-vcl.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/apache-vcl.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,240 @@
+Title: Apache VCL
+<a name="ApacheVCL-ApacheVCL"></a>
+# Apache VCL
+
+The Apache VCL project.
+
+VCL, Virtual Computing Lab. The VCL can be many things, first and foremost
+it is a open-source system used to dynamically provision and broker remote
+access to a dedicated compute environment for an end-user. The provisioned
+computers are typically housed in a data center and may be physical blade
+servers, traditional rack mounted servers, or virtual machines. VCL can
+also broker access to standalone machines such as a lab computers on a
+university campus.
+
+One of the primary goals of VCL is to deliver a dedicated compute
+environment to a user for a limited time through a web interface. This
+compute environment can range from something as simple as a virtual machine
+running productivity software to a machine room blade running high end
+software (i.e. a CAD, GIS,statistical package or an Enterprise level
+application) to a cluster of interconnected physical (bare metal) compute
+nodes.
+
+Also using the scheduling API it can be used to automate the provisioning
+of servers in a server farm or HPC cluster.
+
+<a name="ApacheVCL-UserDocumentation"></a>
+# User Documentation
+
+* [Overview for VCL Users](for-vcl-users.html)
+ (those doing daily management of a VCL installation)
+** [Making a Reservation](making-a-reservation.html)
+** [Creating a New Image from a Base Image](creating-a-new-image-from-a-base-image.html)
+** [Granting Access to a New Image](granting-access-to-a-new-image.html)
+** [Example - Granting Two Sets of Users Access to Two Different Sets of Images](example---granting-two-sets-of-users-access-to-two-different-sets-of-images.html)
+** [managegroups.py - Remotely managing user groups](managegroups.py---remotely-managing-user-groups.html)
+** The VCL [XMLRPC API](http://people.apache.org/~jfthomps/vcl_xmlrpc_api.html)
+* Documentation for VCL Administrators (those doing a VCL installation)
+** [VCL&nbsp;Architecture](https://cwiki.apache.org/confluence/display/VCL/VCL+Architecture)
+** [Administrator's FAQ](administrator's-faq.html)
+** [VCL Installation (Current Release)](vcl-2.3-installation.html)
+*** [VCL 2.3 Database Installation](vcl-2.3-database-installation.html)
+*** [VCL 2.3 Web Code Installation](vcl-2.3-web-code-installation.html)
+*** [VCL 2.3 Management Node Installation](vcl-2.3-management-node-installation.html)
+*** [Adding support for partimage and partimage-ng to xCAT 2.x (unofficial)](adding-support-for-partimage-and-partimage-ng-to-xcat-2.x-(unofficial).html)
+*** [Creating a Base Image](base-image-creation.html)
+*** [Troubleshooting](troubleshooting.html)
+*** [Terms](terms.html)
+
+<a name="ApacheVCL-Community"></a>
+# Community
+
+Interested in joining the community or giving back to open source? There
+are several ways to assist:
+* Join the mailing lists below and discuss ideas.
+* Contribute bug-fixes or get involved in development.
+** [How to Become a committer](vcl:becoming-a-committer.html)
+* Help with the documentation, both end-user and installation.
+* Help improve the website.
+
+Mailing lists
+* User mailing list&nbsp; [mailto:user-subscribe@vcl.apache.org](mailto:user-subscribe@vcl.apache.org.html)
+* Development List [dev-subscribe@vcl.apache.org](mailto:dev-subscribe@vcl.apache.org.html)
+
+Archives
+* Search: [http://markmail.org/set/jlmr2rdvup4w2](http://markmail.org/set/jlmr2rdvup4w2)
+* User (old): [http://mail-archives.apache.org/mod_mbox/incubator-vcl-user](http://mail-archives.apache.org/mod_mbox/incubator-vcl-user)
+* User (current): [http://mail-archives.apache.org/mod_mbox/vcl-user](http://mail-archives.apache.org/mod_mbox/vcl-user)
+* Development (old): [http://mail-archives.apache.org/mod_mbox/incubator-vcl-dev](http://mail-archives.apache.org/mod_mbox/incubator-vcl-dev)
+* Development (current): [http://mail-archives.apache.org/mod_mbox/vcl-dev](http://mail-archives.apache.org/mod_mbox/vcl-dev)
+
+<a name="ApacheVCL-ProjectResources"></a>
+# Project Resources
+
+<table>
+<tr><td> Confluence </td><td> [http://cwiki.apache.org/confluence/display/VCL](http://cwiki.apache.org/confluence/display/VCL)
+ </td></tr>
+<tr><td> Subversion Repository </td><td> [https://svn.apache.org/repos/asf/vcl](https://svn.apache.org/repos/asf/vcl)
+ </td></tr>
+<tr><td> JIRA </td><td> [http://issues.apache.org/jira/browse/VCL](http://issues.apache.org/jira/browse/VCL)
+ </td></tr>
+<tr><td> Current version </td><td> [VCL 2.2.1](vcl-2.2.1.html)
+ </td></tr>
+<tr><td> Release Roadmap </td><td> [ASF VCL JIRA Roadmap](https://issues.apache.org/jira/browse/VCL?report=com.atlassian.jira.plugin.system.project:roadmap-panel)
+ </td></tr>
+  
+  
+  
+  
+<tr><td> IRC </td><td> [\#asfvcl on Freenode](irc://irc.freenode.net/asfvcl.html)
+ </td></tr>
+</table>
+
+<a name="ApacheVCL-ConceptualOverview"></a>
+# Conceptual Overview
+
+The conceptual overview below shows that remote users connect to the VCL
+Scheduling Application (the web VCL portal) and request access to a desired
+application environment. The application environment consists of an
+operating system and a suite of applications. The computer types are
+machine room blade servers, vmware virtual machines, and standalone
+machines.
+<table>
+<tr><td> !VCLconceptoverview.gif</td><td>align=left! </td></tr>
+</table>
+
+<a name="ApacheVCL-VCLFeatureList"></a>
+# VCL Feature List
+
+* Automated provisioning, on-demand or future based
+* Brokers user sessions
+* Block allocations - provisioning larger number of compute environments
+for a specific event
+** For the class room
+** For a conference workshop
+* Physical ([bare-metal](#baremetal.html)
+) provisioning using xCAT
+* Virtual machine provisioning on VMware ESXi, VMware ESX Standard server,
+VMware Free Server
+* Image creation - allow end-users to create custom environments
+* Image revision control - create multiple revisions of an image
+* Statistics of environment usage
+* Privilege control - grant varying levels of control to end-users through
+web interface
+** Image checkout, image creation, manage users, manage [resources](#resource.html)
+, manage resource schedules
+* Set available/unavailable schedules for [nodes](#node.html)
+* Multiple [Management Nodes](#managementnode.html)
+ for scalability
+* API support for making requests and provisioning resources
+
+{panel}
+*Terminology*:{anchor:baremetal}Bare-metal = a physical server (such as a
+blade server) as opposed to a virtual machine{anchor:node}Node = a
+computer{anchor:resource}Resource = a compute node, an image, a management
+node, or a schedule{anchor:managementnode}Management Node = a process
+server or the machine where vcld is running; processes user requests
+assigned by the scheduler; does the provisioning
+{panel}
+
+<a name="ApacheVCL-SystemRequirements"></a>
+# System Requirements
+
+See the [VCL Installation](http://cwiki.apache.org/confluence/display/VCL/VCL+Installation)
+ documentation for more information
+
+<a name="ApacheVCL-WebFrontend"></a>
+#### Web Frontend
+
+* [Apache HTTP Server](http://httpd.apache.org/)
+ 1.3 or 2.x with SSL enabled ([Apache
+License|http://www.apache.org/licenses/LICENSE-2.0])
+* [PHP](http://www.php.net/)
+&nbsp;5.0 or later ([PHP License|http://www.php.net/license/3_01.txt])
+* PHP&nbsp;modules ([PHP License](http://www.php.net/license/3_01.txt)
+):
+** php-gd
+** php-json
+** php-mcrypt
+** php-mysql
+** php-openssl
+** php-sysvsem
+** php-xml
+** php-xmlrpc
+* [libmcrypt and mcrypt](http://sourceforge.net/projects/mcrypt/)
+ libraries installed for php-mcrypt
+([GPL|http://www.opensource.org/licenses/gpl-license.php])
+* [Dojo Toolkit](http://dojotoolkit.org/)
+ 0.4.0 and 1.1.0 ([modified BSD license or the Academic Free License
+version 2.1|http://dojotoolkit.org/license])
+
+<a name="ApacheVCL-Database"></a>
+#### Database
+
+* [MySQL](http://dev.mysql.com)
+ 5.0 or later ([GPL|http://www.opensource.org/licenses/gpl-license.php])
+
+<a name="ApacheVCL-ManagementNodeBackend"></a>
+#### Management Node Backend
+
+* Operating system - tested on CentOS 5 ([GPL](http://www.opensource.org/licenses/gpl-license.php)
+), RedHat Advanced Server 4 and 5 ([Red
+Hat|http://www.redhat.com/licenses/advancedservereula.html]), and RedHat
+Fedora Core 7 and 9
+([GPL|http://www.opensource.org/licenses/gpl-license.php])
+* perl-DBD-MySQL ([Artistic](http://dev.perl.org/licenses/artistic.html)
+ and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+* MySQL 5 client ([GPL](http://www.opensource.org/licenses/gpl-license.php)
+)
+* [Nmap](http://nmap.org/)
+ security scanner ([Nmap|http://nmap.org/svn/COPYING] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+* [OpenSSH](http://www.openssh.org/index.html)
+ client (BSD)
+* Perl 5.8.x ([Artistic](http://dev.perl.org/licenses/artistic.html)
+ and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+* Perl modules available from CPAN
+** [Class-Data-Inheritable](http://search.cpan.org/dist/Class-Data-Inheritable/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [Compress-Raw-Zlib](http://search.cpan.org/dist/Compress-Raw-Zlib/)
+([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [Crypt-SSLeay](http://search.cpan.org/dist/Crypt-SSLeay/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [DBI](http://search.cpan.org/dist/DBI/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [Devel-StackTrace](http://search.cpan.org/dist/Devel-StackTrace/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [Exception-Class](http://search.cpan.org/dist/Exception-Class/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [HTML-Parser](http://search.cpan.org/dist/HTML-Parser/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [IO-Compress](http://search.cpan.org/dist/IO-Compress/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [libwww-perl](http://search.cpan.org/dist/libwww-perl/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [MailTools](http://search.cpan.org/dist/MailTools/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [Object-InsideOut](http://search.cpan.org/dist/Object-InsideOut/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [RPC-XML](http://search.cpan.org/dist/RPC-XML/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [LGPL|http://www.opensource.org/licenses/lgpl-2.1.php]
+)
+** [XML-Parser](http://search.cpan.org/dist/XML-Parser/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)
+** [YAML](http://search.cpan.org/dist/YAML/)
+ ([Artistic|http://dev.perl.org/licenses/artistic.html] and [GPL|http://www.opensource.org/licenses/gpl-license.php]
+)

Added: vcl/site/trunk/content/confluence_export/automated-installation-of-vcl-and-xcat.mdtext
URL: http://svn.apache.org/viewvc/vcl/site/trunk/content/confluence_export/automated-installation-of-vcl-and-xcat.mdtext?rev=1430372&view=auto
==============================================================================
--- vcl/site/trunk/content/confluence_export/automated-installation-of-vcl-and-xcat.mdtext (added)
+++ vcl/site/trunk/content/confluence_export/automated-installation-of-vcl-and-xcat.mdtext Tue Jan  8 16:37:53 2013
@@ -0,0 +1,9 @@
+Title: Automated installation of VCL and Xcat
+This is a work in progress describing the development of an automatic
+installation for VCL and Xcat.
+
+The precursor work is available on this site at
+https://cwiki.apache.org/confluence/display/VCL/Automated+Installation+of+VCL
+
+An overview is available here:
+https://cwiki.apache.org/confluence/download/attachments/30739464/vcl_autoconfig_overview.pdf