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! |