Management of Runtime configuration files

As an administrator, you can adjust the file assignments for the RuntimeConfig.xml file. File assignments refer to the way files are associated with different configurations for each group, user, department, or robot in Pega Robot Manager™. Once an administrator begins creating new Rutime configuration files for an enterprise or Pega Robot Manager applications, the administrator must manage the files to ensure proper assignments as well as an uncluttered portal for ease of use. Managing the various configuration files may require the following actions:

• Add the file assignments to departments, users, work groups, and robots
• Modify the file assignments to departments, users, work groups, and robots
• View file change history and restore previous versions
• Change the default file

Runtime configuration files can be assigned to different departments, users, work groups, or robots, depending on the kinds of configuration variations needed across your organization. For example, your organization may use different package servers to store packages based on geography or function, so the Package Server URL for departments may vary across the organization. You can create or add file assignments only for the entities that belong to the same application, but not the same application stack.

Follow these steps to add new or additional Runtime configuration file assignments.

1. From the Pega Robot Manager dashboard, click Settings.
   
2. In the Settings page, click the Runtime configs tab.
3. 3. Click the name of the file that you want to assign.
   
   4. In the Runtime config drill-in screen, click Assign new.
   
   5. Select the entity to which the file should be assigned, such as User, Department, Work group, or Robot.
   
   6. Click Submit to confirm the assignment. 

Modifying the Runtime configuration file assignment means you either adjust a direct or inherited association. You can perform this adjustment by replacing direct assignments that may override inherited ones.

Follow these steps to update the Runtime configuration file assignments.

1. From the Pega Robot Manager header, click Users or Robots.
2. Navigate to the department, user, work group, or robot you want to edit and locate the Runtime config section
   
3.  To change an existing assignment to an entity, you perform a different set of tasks depending on whether the existing assignment is a default assignment or a direct assignment.
   • To change a default assignment, such as an application default or inherited default:
     1. In the Runtime config section, click Override.
        
     2. Select a Runtime configuration file to set as the entity assignment and click Submit.
   • To change a direct assignment:
     1. In the Runtime config section, click Replace.
        
     2. Select a Runtime configuration file to set as the new assignment and click Submit.
        

Pega Robot Manager retains the history of Runtime configuration files, which allows an administrator to revert to a previous version. When you restore to a previous version of the Runtime configuration file, Pega Robot Manager creates a new version based on the restored settings and identifies it as the active configuration file version to use. 

Follow these steps to restore a previous version of the Runtime configuration file.

1. From the Pega Robot Manager dashboard, click Settings.
   
2. Click the name of the Runtime configuration file to review or restore.
   
3. On the File details page, click the History tab.
   
4. Click a file version row that to preview the file and display the available actions.
   
5. Scroll to the bottom and click Restore.
   
   Note: All departments, users, work groups, or robots that have the configuration file association receive the restored version the next time the run-time desktop application starts on the machine.

If a department, user, work group, or a robot does not have a direct or inherited Runtime configuration file association, Pega Robot Manager uses the configuration file classified as Default.

Follow these steps to change which file is selected as Default.

1. From the Pega Robot Manager dashboard, click Settings.
   
2. In the Settings screen, click theRuntime configs tab.
3. Click the More icon in the row that corresponds to an existing file and select Set as default.