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 physical nodes with an operating system such +as; windows Red Hat, CentOS, ESX, SLES on x86 based hardware. This +guide will discuss adding support to VCL for kickstart based or diskfull +installs. + +Prerequisites are that you need to have a working xCAT install. Please +see xCAT installation guide in order to install and configure xCAT. +* xCAT main page: [http://xcat.sourceforge.net/](http://xcat.sourceforge.net/) +* xCAT Getting Started guide: [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 "></a> +### Adding kickstart based install to the VCL database + +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.* + +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 *rhel5-base25-v0.* 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:} Again, the xCAT template .tmpl file must match the the +entry VCL database entry of image.name. {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. {color} +* {color:#222222}Go to Manage images {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 physical 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 {color}{color:#222222}physical 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. It's OK if the computer +needs to reboots. 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 software from your local computer to the remote computer +by sharing your local drives through Remote Desktop Connection. The +shared drives show up in Windows Explorer on the remote machine. +Do not run the software's installation program directly from the shared +drive. 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. 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. When the installation is +done, unmount the drive and delete the ISO file from the remote +machine. 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 to the network filespace and access them from +the remote machine. +1. * Copy the media contents using SCP from the remote computer. If you +have a personal machine running an SSH server you can use this +method. 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 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 [mailto:[email protected]](mailto:[email protected]) +* Development List [[email protected]](mailto:[email protected]) + +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/) + 5.0 or later ([PHP License|http://www.php.net/license/3_01.txt]) +* PHP 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
