Chapter 7. Managing organizations

Procedure

1. In the Satellite web UI, navigate to Administer > Organizations.
2. Click New Organization.
3. In the Name field, enter a name for the organization.
4. In the Label field, enter a unique identifier for the organization. This is used for creating and mapping certain assets, such as directories for content storage. Use letters, numbers, underscores, and dashes, but no spaces.
5. Optional: In the Description field, enter a description for the organization.
6. Click Submit.
7. If you have hosts with no organization assigned, select the hosts that you want to add to the organization, then click Proceed to Edit.
8. In the Edit page, assign the infrastructure resources that you want to add to the organization. This includes networking resources, installation media, Kickstart templates, and other parameters. You can return to this page at any time by navigating to Administer > Organizations and then selecting an organization to edit.
9. Click Submit.

Procedure

1. Create an organization:

   $ hammer organization create \
   --name "My_Organization" \
   --label "My_Organization_Label" \
   --description "My_Organization_Description"

2. Optional: To edit an organization, enter the hammer organization update command. For example, you can assign a compute resource to the organization:

   $ hammer organization update \
   --name "My_Organization" \
   --compute-resource-ids 1

Procedure

1. In the Satellite web UI, navigate to Administer > Organizations.
2. Select an organization that you want to generate a debug certificate for.
3. Click Generate and Download.
4. Save the certificate file in a secure location.

Procedure

1. Split the private and public keys from the certificate into two files.

   1. Open the X.509 certificate, for example, for the default organization:

      $ vi 'Default Organization-key-cert.pem'

   2. Copy the contents of the file from -----BEGIN RSA PRIVATE KEY----- to -----END RSA PRIVATE KEY-----, into a key.pem file.
   3. Copy the contents of the file from -----BEGIN CERTIFICATE----- to -----END CERTIFICATE-----, into a cert.pem file.

2. To use the organization debug certificate with a browser, you must first convert the X.509 certificate to a format your browser supports and then import the certificate. For example, for Mozilla Firefox users:

   1. Convert the certificate into the PKCS12 format using the following command:

      $ openssl pkcs12 -keypbe PBE-SHA1-3DES -certpbe PBE-SHA1-3DES -export -in cert.pem -inkey key.pem -out My_Organization_Label.pfx -name My_Organization

   2. In the Mozilla Firefox browser, navigate to Edit > Preferences > Advanced Tab.
   3. Select View Certificates and click the Your Certificates tab.
   4. Click Import and select the .pfx file to load.

   5. Enter the following URL in the address bar to browse the accessible paths for all the repositories and check their contents:

      https://satellite.example.com/pulp/content/

3. To use the organization debug certificate with CURL:

   $ curl -k --cert cert.pem --key key.pem \
   https://satellite.example.com/pulp/content/My_Organization_Label/Library/content/dist/rhel/server/7/7Server/x86_64/os/

   Ensure that the paths to cert.pem and key.pem are the correct absolute paths otherwise the command fails silently. Pulp uses the organization label, therefore, you must enter the organization label into the URL.

Procedure

1. In the Satellite web UI, navigate to Administer > Organizations.
2. From the list to the right of the name of the organization you want to delete, select Delete.
3. Click OK to delete the organization.

Procedure

1. View all organizations:

   $ hammer organization list

   From the output, note the ID of the organization that you want to delete.

2. Delete an organization:

   $ hammer organization delete --id My_Organization_ID