8.4.1 Changing the Mail Server Information Registered on the Management Server

If the mail server information (such as the host name or port number of the SMTP server) has changed, the information registered on the Management Server must be changed.

This section explains the procedure for changing information about the mail server (SMTP server).

Note

Refer to "Setting Up Mail Notification" in the Systemwalker Runbook Automation Operation Guide for information on email notification.

List of setting items

The following table lists the items that can be set up as the mail server information.

Item name	Description
SMTPServerHost	Specify the host name or IP address for the SMTP server for sending e-mail messages.
SMTPServerPort	Specify the port number for the SMTP server for sending e-mail messages.
SMTPUserName	Specify the name of the user responsible for authenticating with the SMTP server when e-mail messages are sent. If you do not perform authentication with the SMTP server when e-mail messages are sent, specify "\ " (a backslash followed by a space).
SMTPPassword	Specify the password of the user responsible for authenticating with the SMTP server when e-mail messages are sent. If you do not perform authentication with the SMTP server when e-mail messages are sent, specify "\ " (a backslash followed by a space).
ServerEmailAddress	Specify the sender (the "from" address), who will be assigned to the e-mail messages that are sent, using the e-mail address format. Note that this address will be used as the address for receiving error e-mail messages when the notification e-mails that are sent bounce because the recipient cannot be found. Specify the e-mail address of someone who can respond to problems promptly.
ServerBaseURL	Specify the URL for the Web console. Specify the URL using the following format: http://<host name of the Management Server>:<port number for the Management Server (Web server)>/console/ Ensure you specify a URL that can be accessed externally. Specifically, for environments that use the Interstage Single Sign-On, ensure you specify the host name in the FQDN format.
ServerEmailBaseURL	Specify the URL for the Management Server that will appear in e-mail messages. Set the same value as the ServerBaseURL.

Setup procedure

It is recommended that a backup be taken before starting this procedure. Refer to "8.3 Backup and Restoration" for information on the backup method.

Check the operational status of Systemwalker Runbook Automation.
Check the operational status of Systemwalker Runbook Automation by executing the swrba_status command. If Systemwalker Runbook Automation is not running, start it using the swrba_start command.
Refer to the Systemwalker Runbook Automation Reference Guide for information on the swrba_status and swrba_start commands.
To authenticate with the SMTP server when email messages are sent, encrypt the password of the user responsible for authenticating with the SMTP server. Use the following command to encrypt the password.
This step is not required if authentication with the SMTP server is not performed when email messages are sent, or if the password is not to be changed.
[Windows]
```
> [Interstage BPM installation directory]\client\samples\configuration\EncryptPassword.bat -e "password"
-------ENCRYPTED PASSWORD-------
Encrypted password
```
[Linux]
```
# /opt/FJSVibpm/client/samples/configuration/EncryptPassword.sh -e "password"
-------ENCRYPTED PASSWORD-------
Encrypted password
```
Prepare definition files for the mail server and mail sender.
Create the following two types of files. The files can be created in any location. In these files, specify only the items that will be changed. In the following example, all the parameters will be changed.
1. Configuration file for the SMTP server (smtpserver.conf)
  Example of configuration file settings for authenticating with the SMTP server when email messages are sent.
```
SMTPServerHost=swrba.mail.server
SMTPServerPort=25
SMTPUserName=swrbamailuser
SMTPPassword=encrypted password
ServerBaseURL=http://ssoserver.example.com:80/console/
ServerEmailBaseURL=http://ssoserver.example.com:80/console/
```
  Example of configuration file settings for not performing the authentication with the SMTP server when email messages are sent.
```
SMTPServerHost=swrba.mail.server
SMTPServerPort=25
SMTPUserName=\ (*1)
SMTPPassword=\ (*1)
ServerBaseURL=http://ssoserver.example.com:80/console/
ServerEmailBaseURL=http://ssoserver.example.com:80/console/
```
  *1: Ensure you insert a space after the "\" symbol.
2. Configuration file for the mail sender (emailaddress.conf)
```
ServerEmailAddress=swrbamailuser@swrba.mail.server
```

Register the mail server and mail sender information with Systemwalker Runbook Automation. Register both the mail server and mail sender definitions.

Registering the SMTP server:

[Windows]

> [Interstage BPM installation directory]\server\deployment\bin\importProperties.batsmtpserver.conf [the account for accessing the Process Management Database] [password for the account for accessing the Process Management Database]

[Linux]

# /opt/FJSVibpm/server/deployment/bin/importProperties.sh smtpserver.conf [the account for accessing the Process Management Database] [password for the account for accessing the Process Management Database]

Registering the mail sender:

[Windows]

> [Interstage BPM installation directory]\server\deployment\bin\importProperties.batemailaddress.conf [the account for accessing the Process Management Database] [password for the account for accessing the Process Management Database] Default

[Linux]

# /opt/FJSVibpm/server/deployment/bin/importProperties.sh emailaddress.conf [the account for accessing the Process Management Database] [password for the account for accessing the Process Management Database] Default

Ensure you specify the "Default" option at the end.

Restart Systemwalker Runbook Automation.
To reflect the information that has been set up, stop Systemwalker Runbook Automation using the swrba_stop command, and then, restart it again using the swrba_start command.
1. Stopping Systemwalker Runbook Automation:
  [Windows]
```
> [Installation directory for the Systemwalker Runbook Automation Management Server]\bin\swrba_stop
```
  [Linux]
```
# /opt/FJSVswrbam/bin/swrba_stop
```
2. Starting Systemwalker Runbook Automation:
  [Windows]
```
> [Installation directory for the Systemwalker Runbook Automation Management Server]\bin\swrba_start
```
  [Linux]
```
# /opt/FJSVswrbam/bin/swrba_start
```