Project

General

Profile

LocationsAndOrganizations » History » Version 3

Tomer Brisker, 09/04/2019 12:11 PM

1 3 Tomer Brisker
h1. *+THIS PAGE IS OUT OF DATE. PLEASE REFER TO THE "FOREMAN MANUAL":https://theforeman.org/manuals/latest/index.html+*
2 3 Tomer Brisker
3 3 Tomer Brisker
4 1 Sam Kottler
h1. Locations and organizations
5 1 Sam Kottler
6 1 Sam Kottler
h2. Summary
7 1 Sam Kottler
8 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.
9 1 Sam Kottler
10 1 Sam Kottler
h2. The basics
11 1 Sam Kottler
12 1 Sam Kottler
Locations and/or organizations are disabled by default, but can be enabled by setting the following values in config/settings.yml:
13 1 Sam Kottler
14 1 Sam Kottler
<pre>
15 1 Sam Kottler
:locations_enabled: true
16 1 Sam Kottler
:organizations_enabled: true
17 2 Sam Kottler
</pre>
18 1 Sam Kottler
19 1 Sam Kottler
You should restart Foreman after changing these values. Additionally, the "login" setting must be set to true to use locations & orgs. 
20 1 Sam Kottler
21 1 Sam Kottler
h2. Setting up locations & orgs
22 1 Sam Kottler
23 1 Sam Kottler
Once you've enabled locations or organizations and set login to true you will see new menu items:
24 1 Sam Kottler
25 1 Sam Kottler
!http://i.imgur.com/qHZ0nwRl.jpg!
26 1 Sam Kottler
27 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:
28 1 Sam Kottler
29 1 Sam Kottler
!http://i.imgur.com/nvX1uUEl.jpg!
30 1 Sam Kottler
31 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:
32 1 Sam Kottler
33 1 Sam Kottler
!http://i.imgur.com/eBQ1KQq.png!
34 1 Sam Kottler
35 1 Sam Kottler
h2. Usage
36 1 Sam Kottler
37 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:
38 1 Sam Kottler
39 1 Sam Kottler
!http://i.imgur.com/7BwE2GRl.jpg!