Project

General

Profile

LocationsAndOrganizations » History » Version 2

Sam Kottler, 01/31/2013 10:56 PM

1 1 Sam Kottler
h1. Locations and organizations
2 1 Sam Kottler
3 1 Sam Kottler
h2. Summary
4 1 Sam Kottler
5 1 Sam Kottler
The Foreman supports locations and organizations for managing different resources inside of a single instance and granting users specific access to those resources, including hosts, hostgroups, domains, subnets, and compute resources, environments, and others. Locations and organiztions can be enabled independently of one other; for example if your installation only requires locations then there is no need to have organizations on.
6 1 Sam Kottler
7 1 Sam Kottler
h2. The basics
8 1 Sam Kottler
9 1 Sam Kottler
Locations and/or organizations are disabled by default, but can be enabled by setting the following values in config/settings.yml:
10 1 Sam Kottler
11 1 Sam Kottler
<pre>
12 1 Sam Kottler
:locations_enabled: true
13 1 Sam Kottler
:organizations_enabled: true
14 2 Sam Kottler
</pre>
15 1 Sam Kottler
16 1 Sam Kottler
You should restart Foreman after changing these values. Additionally, the "login" setting must be set to true to use locations & orgs. 
17 1 Sam Kottler
18 1 Sam Kottler
h2. Setting up locations & orgs
19 1 Sam Kottler
20 1 Sam Kottler
Once you've enabled locations or organizations and set login to true you will see new menu items:
21 1 Sam Kottler
22 1 Sam Kottler
!http://i.imgur.com/qHZ0nwRl.jpg!
23 1 Sam Kottler
24 1 Sam Kottler
Select either locations or organizations to create new ones. For example, choosing to create a new location will bring you to a basic creation form. Name the new location or org and submit it. Next, edit the object you just created; on this page you will be able to select different resources from throughout Foreman to add to a location or org:
25 1 Sam Kottler
26 1 Sam Kottler
!http://i.imgur.com/nvX1uUEl.jpg!
27 1 Sam Kottler
28 1 Sam Kottler
Submit the form once you've added all the resources that are needed for a single org or location. Next, you can add a host to an organization or location, only locations or organizations without the proper resources based on the host's current settings will be excluded from the list of available locations and/or organizations:
29 1 Sam Kottler
30 1 Sam Kottler
!http://i.imgur.com/eBQ1KQq.png!
31 1 Sam Kottler
32 1 Sam Kottler
h2. Usage
33 1 Sam Kottler
34 1 Sam Kottler
There is a gravatar on each page and clicking on the image next to it will allow you to switch into a specific context based on either a location/organization or combination of the two:
35 1 Sam Kottler
36 1 Sam Kottler
!http://i.imgur.com/7BwE2GRl.jpg!