Chapter 3. Configuring Organizations, Locations and Life Cycle Environments

Procedure 3.1. To Create an Organization:

1. Navigate to Administer Organizations.
2. Click New Organization.
3. In the Name field, insert the name of the new organization.
4. In the Label field, insert the label of the new organization.
5. In the Description field, insert a description of the new organization.
6. Click Submit.
7. Select the hosts to assign to the new organization.
   • Click Assign All to assign all hosts with no organization to the new organization.
   • Click Manually Assign to manually select and assign the hosts with no organization.
   • Click Proceed to Edit to skip assigning hosts.
8. Specify the configuration details of the organization such as Capsule Servers, subnets or compute resources. You can modify these settings later as described in Section 3.1.4, “Editing an Organization”.
9. Click Submit.

Procedure 3.2. To Create a New Organization Debug Certificate:

1. Navigate to Administer Organizations.
2. Select an organization for which you want to generate a debug certificate.
3. Click Generate and Download. This generates a debug certificate.
4. Save the certificate file in a secure location.

Procedure 3.3. To Use an Organization Debug Certificate in Firefox:

1. Create and download an organization certificate as described in Procedure 3.2, “To Create a New Organization Debug Certificate:”.
2. Open the X.509 certificate, for example, for the default organization:

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

   Copy to Clipboard Toggle word wrap
3. Copy the contents of the file from -----BEGIN RSA PRIVATE KEY----- to -----END RSA PRIVATE KEY----- inclusive, into a file called key.pem.
4. Copy the contents of the file from -----BEGIN CERTIFICATE----- to -----END CERTIFICATE----- inclusive, into a file called cert.pem.
5. Enter a command as follows to create a PKCS12 format certificate and enter a password or phrase when prompted:

   $ openssl pkcs12 -keypbe PBE-SHA1-3DES -certpbe PBE-SHA1-3DES -export -in cert.pem -inkey key.pem -out organization_label.pfx -name 'organization_name'
   Enter Export Password:
   Verifying - Enter Export Password:

   Copy to Clipboard Toggle word wrap
6. Using the preferences tab, import the resulting pfx file into your browser: Navigate to Edit Preferences Advanced Tab. Select View Certificates in the Certificates view to open the Certificate Manager. On the Your Certificates tab, click Import and select the pfx file to load. You will be prompted for the password or phrase used when making the certificate.
7. Enter a URL in the following format into your browser's address bar to begin browsing for repositories:

   http://satellite.example.com/pulp/repos/organization_label

   Copy to Clipboard Toggle word wrap

   Pulp uses the organization label so the URL must use the organization label too.

Procedure 3.4. To Use an Organization Debug Certificate with curl:

1. Create and download an organization certificate as described in Procedure 3.2, “To Create a New Organization Debug Certificate:”.
2. Open the X.509 certificate, for example, for the default organization:

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

   Copy to Clipboard Toggle word wrap
3. Copy the contents of the file from -----BEGIN RSA PRIVATE KEY----- to -----END RSA PRIVATE KEY----- inclusive, into a file called key.pem.
4. Copy the contents of the file from -----BEGIN CERTIFICATE----- to -----END CERTIFICATE----- inclusive, into a file called cert.pem.
5. Find a valid URL for a repository. You can use the browsing method described in the previous procedure or use the web UI. For example, using the web UI, navigate to Content Products and select a Product by name. On the Repositories tab, select a repository by name and look for the Published At entry.
6. To use curl to access a repository, use a command as follows:

   $ curl -k --cert cert.pem --key key.pem http://satellite.example.com/pulp/repos/Default_Organization/Library/content/dist/rhel/server/7/7Server/x86_64/sat-tools/6.2/os/

   Copy to Clipboard Toggle word wrap

   Ensure the paths to cert.pem and key.pem are the correct absolute paths otherwise the command will fail silently.

Procedure 3.5. To Edit an Organization:

1. Navigate to Administer Organizations.
2. Click the name of the organization to be edited.
3. Select the resource to edit from the list on the left.
4. Click the name of the desired items to add them to the Selected Items list.
5. Click Submit.

Procedure 3.6. To Remove an Organization:

1. Navigate to Administer Organizations.
2. Select Delete from the drop-down menu to the right of the name of the organization you want to remove.
3. An alert box appears:

   Delete Organization?

   Copy to Clipboard Toggle word wrap
4. Click OK to delete the organization.