5.1

Using the Mail Plug-In 7
You can send email messages from workflows by using the Mail plug-in, which uses the Simple Mail Transfer
Protocol (SMTP). For example, you can create a workflow to send an email to a given address if the workflow
requires user interaction or when it completes its run.
This chapter includes the following topics:
n
“Define the Default SMTP Connection,” on page 61
n
“Mail Plug-In Scripting API,” on page 62
n
“Email Scripting Examples,” on page 62
n
“Using the Mail Plug-In Sample Workflows,” on page 63
Define the Default SMTP Connection
The Mail plug-in is installed with Orchestrator Server and is used for email notifications. The only option
available for this plug-in is to use default values for new mail messages. You can set the default email account.
Avoid load balancers when configuring mail in Orchestrator. You might receive SMTP_HOST_UNREACHABLE error.
Procedure
1 Log in to the Orchestrator configuration interface as vmware.
2 Click Mail.
3 Select the Define default values check box and fill in the required text boxes.
Text box Description
SMTP host
Enter the IP address or domain name of your SMTP server.
SMTP port
Enter a port number to match your SMTP configuration.
The default SMTP port is 25.
User name
Enter a valid email account.
This is the email account Orchestrator uses to send emails.
Password
Enter the password associated with the user name.
From name and address
Enter the sender information to appear in all emails sent by Orchestrator.
4 Click Apply changes.
VMware, Inc.
61