You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@vcl.apache.org by bu...@apache.org on 2012/12/19 21:17:29 UTC
svn commit: r843153 - in /websites/staging/vcl/trunk/content: ./
docs/authorization/example2users2images.html
Author: buildbot
Date: Wed Dec 19 20:17:29 2012
New Revision: 843153
Log:
Staging update by buildbot for vcl
Added:
websites/staging/vcl/trunk/content/docs/authorization/example2users2images.html
Modified:
websites/staging/vcl/trunk/content/ (props changed)
Propchange: websites/staging/vcl/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Dec 19 20:17:29 2012
@@ -1 +1 @@
-1424075
+1424076
Added: websites/staging/vcl/trunk/content/docs/authorization/example2users2images.html
==============================================================================
--- websites/staging/vcl/trunk/content/docs/authorization/example2users2images.html (added)
+++ websites/staging/vcl/trunk/content/docs/authorization/example2users2images.html Wed Dec 19 20:17:29 2012
@@ -0,0 +1,222 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<!--
+
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE- 2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+ <link href="/css/vcl.css" rel="stylesheet" type="text/css">
+ <link href="/css/code.css" rel="stylesheet" type="text/css">
+ <title>Apache VCL - Example - Granting Two Sets of Users Access to Two Different Sets of Images</title>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+</head>
+
+<body>
+ <div id="sitetitle">
+ <table width="100%" border="0" cellspacing="0" cellpadding="5">
+ <tr>
+ <td><a href="/index.html"><img src="/img/vcl-logo.png" height="100" align="left" alt="Apache VCL logo"></a></td>
+ <td><a href="http://www.apache.org"><img src="/img/asf-logo.png" align="right" alt="Apache Software Foundation logo"></a></td>
+ </tr>
+ </table>
+ </div>
+
+ <div id="navigation">
+ <ul>
+<li>Information<ul>
+<li><a href="/info/about.html">What is VCL?</a></li>
+<li><a href="/info/features.html">Features</a></li>
+<li><a href="/info/architecture.html">Architecture</a></li>
+<li><a href="/info/use-cases.html">Use Cases</a></li>
+<li><a href="/downloads/download.cgi">Download</a></li>
+<li><a href="http://www.apache.org/licenses/LICENSE-2.0.html">License</a></li>
+<li><a href="/info/faq.html">FAQ</a></li>
+</ul>
+</li>
+<li><a href="/docs/index.html">Documentation</a><ul>
+<li><a href="/docs/using-vcl.html">Using VCL</a></li>
+<li><a href="/docs/image-creation.html">Image Creation</a></li>
+<li><a href="/docs/administration.html">Administration</a></li>
+<li><a href="/docs/installation.html">Installation</a></li>
+<li><a href="/docs/deployment-planning.html">Deployment Planning</a></li>
+</ul>
+</li>
+<li><a href="/comm/index.html">Community</a><ul>
+<li><a href="/comm/index.html#getInvolved">Getting Involved</a></li>
+<li><a href="/comm/index.html#mail-list">Mailing Lists</a></li>
+<li><a href="/comm/index.html#how-do-i-join-the-project">How can I Join</a></li>
+<li><a href="/comm/wiki.html">Wiki</a></li>
+<li><a href="/dev/index.html">Development</a><ul>
+<li><a href="/dev/jira.html">Issue Tracking</a></li>
+<li><a href="/dev/code-documentation.html">Code Documentation</a></li>
+<li><a href="/dev/roadmap.html">Roadmap</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="http://www.apache.org">Apache Software Foundation</a><ul>
+<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+<li><a href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a></li>
+</ul>
+</li>
+</ul>
+ </div>
+
+ <div id="content">
+ <h1 class="title">Example - Granting Two Sets of Users Access to Two Different Sets of Images</h1>
+ <p>This page explains how to grant one groups of users access to one set of images,
+and another set of users access to a separate set of images.</p>
+<p>After looking over these steps, you can watch a <a href="example2users2images-video.html">video</a> of the steps being performed.</p>
+<div class="toc">
+<ul>
+<li><a href="#create-a-user-group-for-each-set-of-users">Create a User Group for Each Set of Users</a></li>
+<li><a href="#add-users-to-each-group">Add Users to Each Group</a></li>
+<li><a href="#create-an-image-group-for-each-set-of-images">Create an Image Group for Each Set of Images</a></li>
+<li><a href="#add-images-to-each-group">Add Images to Each Group</a></li>
+<li><a href="#map-the-image-groups-to-computer-groups">Map the Image Groups to Computer Groups</a></li>
+<li><a href="#create-a-two-privilege-nodes">Create a Two Privilege Nodes</a></li>
+<li><a href="#assign-rights-at-each-node">Assign Rights at Each Node</a></li>
+<li><a href="#summary">Summary</a></li>
+</ul>
+</div>
+<h2 id="create-a-user-group-for-each-set-of-users">Create a User Group for Each Set of Users</h2>
+<p>First, you need to create two user groups - one for each set of users.</p>
+<ol>
+<li>Click Manage Groups</li>
+<li>Under the User Groups section (at the top):
+ <ol type="a">
+ <li>Enter a name for the group (it can include spaces)
+ <li>(Optionally, if it shows up) select an affiliation for the group
+ <li>Enter an owner of the group - probably yourself
+ <li>Select a group allowed to edit the user group
+ <li>The rest of the fields can be left as defaults
+ </ol></li>
+<li>Click Add</li>
+<li>Repeat the steps for the second group</li>
+</ol>
+<p>For the rest of the page, I'll call the groups <strong>faculty</strong> and <strong>student</strong></p>
+<h2 id="add-users-to-each-group">Add Users to Each Group</h2>
+<p>You need to add users to each of the groups.</p>
+<ol>
+<li>Click Manage Groups if you're not still on that page</li>
+<li>Click Edit next to the <strong>faculty</strong> group</li>
+<li>Enter a userid in the box next to the Add button (NOTE: if you are not using
+LDAP authentication, the users' accounts will already need to exist in VCL)</li>
+<li>Click Add</li>
+<li>Repeat for all users you wish to add to the <strong>faculty</strong> group</li>
+<li>Repeat these steps for the <strong>student</strong> group</li>
+</ol>
+<h2 id="create-an-image-group-for-each-set-of-images">Create an Image Group for Each Set of Images</h2>
+<p>Next, you need to create an image group for each set of images.</p>
+<ol>
+<li>Click Manage Groups if you're not still on that page</li>
+<li>Under the Resource Groups section (further down the page):
+ <ol type="a">
+ <li>Select Image as the type
+ <li>Enter a name for the group (it can contain spaces)
+ <li>Select a user group that will own the resource group (this user group
+will have access to manage some aspects of the resource group)
+ </ol></li>
+<li>Click Add</li>
+<li>Repeat the steps for the second group</li>
+</ol>
+<p>For the rest of the page, I'll call the groups <strong>faculty images</strong> and <strong>student images</strong></p>
+<h2 id="add-images-to-each-group">Add Images to Each Group</h2>
+<p>Now, you need to add the desired images to each group.</p>
+<ol>
+<li>Click Manage Images</li>
+<li>Select the Edit Image Grouping radio button</li>
+<li>Click Submit</li>
+<li>Click the <strong>By Group</strong> tab</li>
+<li>Select <strong>faculty images</strong></li>
+<li>Click Get Images</li>
+<li>Select any images you want to be available to the <strong>faculty</strong> user group
+in the list on the right (Ctrl+click to select multiple images)</li>
+<li>Click the <-Add button</li>
+<li>Repeat steps for the <strong>student images</strong> group</li>
+</ol>
+<h2 id="map-the-image-groups-to-computer-groups">Map the Image Groups to Computer Groups</h2>
+<p>In order for VCL to know on which computers the images can run, you must map
+the image groups to computer groups. I'll assume you already have one or more
+computer groups that contain computers.</p>
+<ol>
+<li>Click Manage Images</li>
+<li>Select the Edit Image Mapping radio button</li>
+<li>Click Submit</li>
+<li>Select the <strong>faculty images</strong> group</li>
+<li>Click Get Computer Groups</li>
+<li>Select at least one computer group to map it to from the list on the right</li>
+<li>Click the <-Add button</li>
+<li>Repeat for the <strong>student images</strong> group (NOTE: It is okay to map both image
+groups to the same computer group. That will not affect what images the users
+have access to.)</li>
+</ol>
+<h2 id="create-a-two-privilege-nodes">Create a Two Privilege Nodes</h2>
+<p>Now, you need to create one node for each user group to separate their access.</p>
+<ol>
+<li>Click Privileges</li>
+<li>In the tree at the top of the page, click a node under which you'll create
+the two new nodes</li>
+<li>Click the Add Child button</li>
+<li>Enter a name for the new node (spaces are allowed)</li>
+<li>Click Create Child</li>
+<li>Repeat for the second node for the other user group</li>
+</ol>
+<p>I'll refer to these nodes as <strong>faculty access</strong> and <strong>student access</strong></p>
+<h2 id="assign-rights-at-each-node">Assign Rights at Each Node</h2>
+<p>Finally, you need to give each user group the <strong>imageCheckOut</strong> privilege at
+their respective nodes, and give each image group the <strong>available</strong> attribute
+at their respective nodes.</p>
+<ol>
+<li>Click on the <strong>faculty access</strong> node</li>
+<li>Under User Groups, click Add Group</li>
+<li>Select the <strong>faculty</strong> group</li>
+<li>Select the checkbox for the <strong>imageCheckOut</strong> privilege</li>
+<li>Click Submit New User Group</li>
+<li>Scroll down to the Resources section and click Add Resource Group</li>
+<li>Select the <strong>image/faculty images</strong> group</li>
+<li>Select the checkbox for the <strong>available</strong> attribute</li>
+<li>Click Submit New Resource Group</li>
+<li>Click on the <strong>student access</strong> node</li>
+<li>Under User Groups, click Add Group</li>
+<li>Select the <strong>student</strong> group</li>
+<li>Select the checkbox for the <strong>imageCheckOut</strong> privilege</li>
+<li>Click Submit New User Group</li>
+<li>Scroll down to the Resources section and click Add Resource Group</li>
+<li>Select the <strong>image/student images</strong> group</li>
+<li>Select the checkbox for the <strong>available</strong> attribute</li>
+<li>Click Submit New Resource Group</li>
+</ol>
+<h2 id="summary">Summary</h2>
+<p>Now, users in the <strong>faculty</strong> user group will have access to check out images
+in the <strong>faculty images</strong> image group, and users in the <strong>student</strong> user group
+will have access to check out images in the <strong>student images</strong> image group.</p>
+ </div>
+
+ <div id="footer">
+ <div class="copyright">
+ <p>
+ Copyright © 2012 The Apache Software Foundation, Licensed under
+ the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
+ <br />
+ Apache and the Apache feather logo are trademarks of The Apache Software Foundation.
+ </p>
+ </div>
+ </div>
+
+</body>
+</html>