Run Chef Recipes

After enabling the SA Server to run Chef Recipes, and after importing a Chef Cookbook, you can easily run a Chef Recipe on any Chef-enabled SA managed server.

To run Chef Recipes from SA Devices tab:

1. From the SA Client navigation pane, access the list of managed servers or device groups and perform one of the following actions:
   1. Select Devices > Servers > All Managed Servers to view the server list.
   2. Select Devices > Device Groups to view the device group list.
2. From the content pane, select the servers or device groups.
3. From the Actions menu, select Run > Chef Recipe.
   
   
4. Click Select Recipe to find the desired recipe.
5. Select the specific Chef Recipe you wish to run and click Select.
6. From the Run Chef Recipe window, review the additional options:
   1. Scheduling: specify to run the recipe at a schedule time. By default, it will run immediately.

   2. Notifications: specify e-mail notifications be sent when the job succeeds or fails. By default, no e-mails are sent.

      Note
      You can override the chef command options. For example, you can use the Options window to specify any Runtime or Output options.

7. When you are satisfied with the job settings, click Start Job to run the recipe.

To run Chef Recipes from the SA Library:

You can also run Chef Recipes by selecting the recipe from the SA Library.

1. From the SA Client navigation pane, access the list Chef Cookbooks in the SA Library:
   Library > By Type > Chef Cookbooks
2. Select the platform and version you want.
3. From the content pane, select the cookbook you want.
4. In the View list, select Recipes.
5. From the list of recipes in the detail pane, select the recipe or recipes that you want to run.
   Library > By Type > Chef Cookbooks:
   
   
   
6. Select Action > Run Chef Recipe...
7. In the Recipes step, the selected recipes appear. You can add or remove using the or icons.
   The Server group calculation option enables you to choose whether to calculate the device group servers “Now” or “At runtime.”
   
   
   

   The Server group calculation option enables you to choose whether to calculate the device group servers “Now” or “At runtime.”

   • Select “Now” to calculate the servers that comprise the device groups now, while you define the job.
   • Select “At runtime” to defer calculating the servers that comprise the selected device groups to when the Run Chef Recipe job is run.
8. Step through the additional settings in the Run Chef Recipe window before starting the job:
   
   
   1. In the Devices step, select the servers or device groups where you want to run the recipe.
   2. In the Options step, specify any Runtime or Output options. You can override the chef command options at run time or control whether to retain job output. (See Retaining the job output for information about how and where the output log files are stored.)
   3. In the Scheduling step, specify to run the recipe at a schedule time. By default, it will run immediately.
   4. In the Notifications step, specify e-mail notifications be sent when the job succeeds or fails. By default, no emails are sent.
9. When you are satisfied with the job settings, click Start Job to run the recipe.