Procedure 1.1. Adding Users

1. In the Users tab, click Create new user to open the Create User page.
   

   Figure 1.1. The Create User page

2. In the Desired Login field, enter a name for the user. The login name must be at least five characters long.
3. In the Desired Password field, enter a password for the user. Re-enter the same password to confirm.
4. In the First, Last Name field, enter a first and last name for the user. Select a suitable prefix (for example: Mr, Miss, Mrs) from the drop-down menu.
5. In the Email field, enter an email address for the user.
6. In the Time Zone section, select an appropriate time zone.
7. In the Interface Language section, select an appropriate language to be used in the RHN Satellite interface.
8. Click Create Login to create the new user. An email will be sent to the user (using the address specified during creation) to inform them of the new account details.
9. Once the account has been successfully created, you will be redirected to the User List page. To change permissions and set options for the new user, select their name from the displayed list to display the User Details page, and navigate to the appropriate tabs to make your changes.

Procedure 1.2. Deactivating Users

1. Select the user's name from the list in the Users tab, to display the User Details page.
2. Check to see if the user is a Satellite administrator.
   If the user is a Satellite administrator, uncheck the box next to that role, and click Submit.
   If the user is not a Satellite administrator, continue to the next step.
3. Click Deactivate User.
   

   Figure 1.2. Deactivating users

   You will be asked to confirm this action, by clicking it again. Check the details, and then click Deactivate User again to confirm.
4. Once the account has been successfully deactivated, the user's name will not appear in the Active Users list. Click the Deactivated link from the User List menu to view deactivated user accounts.
5. To reactivate the user account, view the Deactivated list, check the box next to the user to be reactivate, and click Reactivate.

Procedure 1.3. Deleting Users

1. Select the user's name from the list in the Users tab, to display the User Details page.
2. Check to see if the user is a Satellite administrator.
   If the user is a Satellite administrator, uncheck the box next to that role, and click Submit.
   If the user is not a Satellite administrator, continue to the next step.
3. Click Delete User.
   

   Figure 1.3. Deleting users

   You will be asked to confirm this action, by clicking it again. Check the details, and then click Delete User again to confirm.
4. Once the account has been successfully deleted, the user's name will not appear in the Active Users list. This step is not reversible.

Procedure 3.1. Backing up the Embedded Database

1. Stop the RHN Satellite server using the stop command:

   rhn-satellite stop
   

2. Switch to the Oracle user, and create the backup using the db-control utility:

   su - oracle
   db-control backup [directory]
   

   Replace directory with the absolute path to the location where you want to store your database backup. The process will take several minutes.
3. Switch back to the root user, and start the Satellite:

   exit
   rhn-satellite start
   

4. Switch to the Oracle user, and use the examine option of db-control to check the backup time stamp and to determine if there are any missing files:

   su - oracle
   db-control examine [directory]
   

   You can also use the verify option of db-control to conduct a thorough review, which includes checking the md5sum of each of the files in the backup:

   db-control verify [directory]
   

   If the verification is successful, the contents of directory are safe to be used to restore the database.

Procedure 3.2. Restoring the Embedded Database from Backup

1. Stop the RHN Satellite server using the stop command:

   rhn-satellite stop
   

2. Switch to the Oracle user, and restore the backup using the db-control utility:

   su - oracle
   db-control restore [directory]
   

   Replace directory with the absolute path to the location that contains the backup. This process will verify the contents of the backup before restoring the database. The process will take several minutes.
3. Switch back to the root user, and start the Satellite:

   exit
   rhn-satellite start
   

4. Regardless of whether you are backing up an external or embedded database, when the satellite is restored from a backup, the following command should be run to schedule the recreation of search indexes the next time the rhn-search service is started:

   /etc/init.d/rhn-search cleanindex
   

Procedure 3.3. Automating Backups

#!/bin/bash
{
/usr/sbin/rhn-satellite stop
su - oracle -c'
d=db-backup-$(date "+%F");
mkdir -p /tmp/$d;
db-control backup /tmp/$d
';
/usr/sbin/rhn-satellite start
} &> /dev/null

1. Create a new file called move-files.sh containing the following script. This script will use rsync to move the backup files to a directory to be stored:

   #!/bin/bash
   rsync -avz /tmp/db-backup-$(date "+%F") [destination] &> /dev/null
   

   Replace [destination] with the path to the backup directory.
   Alternatively, the following script uses scp to achieve the same goal:

   #!/bin/bash
   scp -r /tmp/db-backup-$(date "+%F") [destination] &> /dev/null
   

2. Switch to the root user, and open the crontab in a text editor:

   crontab -e
   

   Note

   The crontab will open in vi by default. To change this behavior, change the EDITOR variable to the name of the text editor you prefer.
3. In the crontab, use the first five fields (minute, hour, day, month, and weekday) to schedule the backup scripts to run:

   0 3 * * * backup-db.sh
   0 6 * * * move-files.sh
   

   This crontab entry will run the backup at 03:00, and transfer the backup files at 06:00. Other options can be included as needed. You can also include a clean up script to remove older backup directories and prevent the backup storage from filling up.
4. To save the crontab, simply exit from the text editor. The new cron rules will be put in to place immediately.

Procedure 8.1. Creating an Organization

1. To create a new organization, open the Admin menu, and select Organizations, Create New Organization.
   

   Figure 8.2. Create New Organization

2. Type the organization name into the appropriate text box. The name should be between 3 and 128 characters.
3. Create an administrator for the organization, by providing the following information:
   • Enter a Desired Login for the organization administrator, which should be between 3 and 128 characters long. Consider creating a descriptive login name for the Organization Administrator account that matches administrative login names with the organization.
   • Create a Desired Password and Confirm the password.
   • Type in the Email address for the organization administrator.
   • Enter the First Name and Last Name of the organization administrator.
4. Click the Create Organization button to complete the process.

Procedure 8.2. Establishing an Organizational Trust

1. Select Organizations link on the menu on the Admin main page.
2. Click the name of one of the organizations and within the Details page, click the Trusts tab.
3. On the Trusts tab, there is a listing of all the other trusts on the RHN Satellite. If you have a long list of organizations, use the Filter by Organization text box to sort them.
4. Click the checkbox next to the names of the organizations you want to be in the organizational trust with the current organization.
5. Click the Modify Trusts button to create the trust.

Procedure 8.3. System Migration

1. Execute the command using the following format:

   migrate-system-profile --satellite SATELLITE HOSTNAME OR IP --systemId=SYSTEM ID --to-org-id=DESTINATION ORGANIZATION ID

   For example, the Finance department (created as an organization in RHN Satellite with OrgID 2) wants to migrate a workstation (with SystemID 10001020) from the Engineering department, but the Finance Organization Administrator does not have shell access to the RHN Satellite server. The RHN Satellite hostname is satserver.example.com. The Finance Organization Administrator would type the following from a shell prompt:

   migrate-system-profile --satellite satserver.example.com --systemId=10001020 --to-org-id=2
   

   The utility then prompts for a username and password.
2. The system can then be viewed from the Systems page when logged into the RHN Satellite web interface. The migration process is completed by assigning a base channel and granting entitlements to the client for any other system registered to the organization, available from the system's History page in the Events tab.
   

   Figure 8.4. System History

3. Satellite Administrators that need to migrate several systems at once can use the --csv option of migrate-system-profile to automate the process using a simple comma-separated list of systems to migrate.
   A line in the CSV file should contain the ID of the system to be migrated as well as destination organization's ID in the following format:

   systemId,to-org-id
   

   The systemId, for example could be 1000010000, while the to-org-id could be 3. An example CSV would look like the following:

   1000010000,3
   1000010020,1
   1000010010,4