Chapter 7. Configuring the systems and running tests using Cockpit To run the certification tests using Cockpit, you must first set up the Cockpit, add systems, upload the test plan to Cockpit. 7.1. Setting up the Cockpit server Cockpit is a RHEL tool that lets you change the configuration of your systems as well as monitor their resources from a user-friendly web-based interface. The Cockpit uses RHCert CLI locally and through SSH to other hosts. Note You must set up Cockpit on the same system as the test host. Ensure that the Cockpit can access both the Controller and Compute nodes. For more information on installing and configuring Cockpit, see Getting Started using the RHEL web console on RHEL 8, Getting Started using the RHEL web console on RHEL 9 and Introducing Cockpit . Prerequisites You have installed the Cockpit plugin on the test host. You have enabled the Cockpit service. Procedure Log in to the test host. Install the Cockpit RPM provided by the Red Hat Certification team. You must run Cockpit on port 9090. Verification Log in to the Cockpit web application in your browser, http://<Cockpit_system_IP>:9090/ and verify the addition of Tools Red Hat Certification tab on the left panel. 7.2. Adding the test systems to Cockpit Adding the test host, Controller, and Compute nodes to Cockpit establishes a connection between the test host and each node. Note Repeat the following process for adding each node. Prerequisites You have the IP address of the test host, Controller, and Compute nodes. Procedure Enter http:// <Cockpit_system_IP> :9090/ in your browser to launch the Cockpit web application. Enter the username and password, and then click Login . Click the down-arrow on the logged-in cockpit user name-> Add new host . The dialog box displays. In the Host field, enter the IP address or hostname of the system. In the User name field, enter from one of the three applicable accounts: Note Enter "tripleo-admin" if you use RHOSP 17.1 or later. Enter "heat-admin" if you use RHOSP 17 or earlier. Enter "root" if you have configured root as the ssh user for Controller and Compute nodes. Click Accept key and connect . Optional: Select the predefined color or select a new color of your choice for the host added. Click Add . Verification On the left panel, click Tools -> Red Hat Certification . Verify that the system you just added displays under the Hosts section on the right. 7.3. Getting authorization on the Red Hat SSO network Procedure Enter http://<Cockpit_system_IP>:9090/ in your browser's address bar to launch the Cockpit web application. Enter the username and password, and then click Login . Select Tools Red Hat Certification in the left panel. On the Cockpit homepage, click Authorize , to establish connectivity with the Red Hat system. The Log in to your Red Hat account page displays. Enter your credentials and click . The Grant access to rhcert-cwe page displays. Click Grant access . A confirmation message displays a successful device login. You are now connected to the Cockpit web application. 7.4. Downloading test plans in Cockpit from Red Hat certification portal For Non-authorized or limited access users: To download the test plan, see Downloading the test plan from Red Hat Certification portal . For authorized users: Procedure Enter http://<Cockpit_system_IP>:9090/ in your browser's address bar to launch the Cockpit web application. Enter the username and password, and then click Login . Select Tools Red Hat Certification in the left panel. Click the Test Plans tab. A list of Recent Certification Support Cases will appear. Click Download Test Plan . A message displays confirming the successful addition of the test plan. The downloaded test plan will be listed under the File Name of the Test Plan Files section. 7.5. Using the test plan to provision the Controller and Compute nodes for testing Provisioning the Controller and Compute nodes through the test host performs several operations, such as installing the required packages on the two nodes based on the certification type and creating a final test plan to run. The final test plan is generated based on the test roles defined for each node and has a list of common tests taken from both the test plan provided by Red Hat and tests generated on discovering the system requirements. For instance, required OpenStack packages will be installed if the test plan is designed for certifying an OpenStack plugin. Prerequisites You have downloaded the test plan provided by Red Hat . Procedure Enter http:// <Cockpit_system_IP> :9090/ in your browser address bar to launch the Cockpit web application. Enter the username and password, and then click Login . Select Tools -> Red Hat Certification in the left navigation panel. Click the Hosts tab to see the list of systems added. Click the Test Plans tab and click Upload . In the Upload Test Plan dialog box, click Upload , and then select the new test plan .xml file saved on the test host. Click Upload to Host . A successful upload message displays along with the file uploaded. Optionally, if you want to reuse the previously uploaded test plan, then select it again to reupload. Note During the certification process, if you receive a redesigned test plan for the ongoing product certification, then you can upload it following the step. However, you must run rhcert-clean all in the Terminal tab before proceeding. Click Provision beside the test plan you want to use. In the Role field, enter the IP address of the Controller node, and from the Host drop-down menu, select Controller . In the Role field, enter the IP address of the Compute node, and from the Host drop-down menu, select Compute . In the Provisioning Host field, enter the IP address of the test host. Select the Run with sudo check box. Click Provision . The terminal is displayed. 7.6. Running the certification tests using Cockpit Note The tests run in the foreground on the Controller node, they are interactive and will prompt you for inputs, whereas the tests run in the background on the Compute node and are non-interactive. Prerequisites You have prepared the Controller and Compute nodes Procedure Enter http:// <Cockpit_system_IP> :9090/ in your browser address bar to launch the Cockpit web application. Enter the username and password, and click Login . Select Tools Red Hat Certification in the left panel. Click the Hosts tab and click on the host on which you want to run the tests, then click the Terminal tab. Click Run . The rhcert-run command will appear and run on the Terminal window. When prompted, choose whether to run each test by typing yes or no . You can also run particular tests from the list by typing select . 7.7. Reviewing and downloading the test results file Procedure Enter http:// <Cockpit_system_IP> :9090/ in your browser address bar to launch the Cockpit web application. Enter the username and password, and then click Login . Select Tools Red Hat Certification in the left panel. Click the Result Files tab to view the test results generated. Optional: Click Preview to view the results of each test. Click Download beside the result files. By default, the result file is saved as /var/rhcert/save/rhcert-multi-openstack-<certification ID>-<timestamp>.xml . 7.8. Submitting the test results from Cockpit to the Red Hat Certification Portal Procedure Enter http://<Cockpit_system_IP>:9090/ in your browser's address bar to launch the Cockpit web application. Enter the username and password, and then click Login . Select Tools Red Hat Certification in the left panel. Click the Result Files tab and select the case number from the displayed list. For the authorized users click Submit . A message displays confirming the successful upload of the test result file. For non-authorized users see, Uploading the results file of the executed test plan to Red Hat Certification portal . The test result file of the executed test plan will be uploaded to the Red Hat Certification portal. 7.9. Uploading the test results file to Red Hat Certification portal Prerequisites You have downloaded the test results file from the test host. Procedure Log in to Red Hat Certification portal . On the homepage, enter the product case number in the search bar. Select the case number from the list that is displayed. On the Summary tab, under the Files section, click Upload . steps Red Hat will review the results file you submitted and suggest the steps. For more information, visit Red Hat Certification portal .

Commands:
yum install redhat-certification-cockpit