Defining valid administrator email addresses
Edit configuration property settings to change the default email addresses from which system notifications, such as a request to join a community, are sent. Notifications are sent from generic administrator email addresses if you do not take action. Default email addresses are initially set during installation, so use this procedure only if you want to change them.
Before you begin
- Important: Starting from HCL Connections 6.0 CR4, a new template version is provided and you can enable it by editing configuration. Go to Enabling the new notification templates for details. With the new template, you can define administrator email addresses and several other properties from one .json properties file. Before doing so, back up your original notifications folder. In addition, ensure that any customized files are backed up before performing a product upgrade or applying a cumulative refresh or fix pack, as you might need to merge your changes again manually after making updates.
- If you plan to prevent user email addresses from being displayed in the product, define a valid email address for the global administrator. When you hide emails, this global administrator address is specified as the sender even in emails generated by user actions that would normally specify that user as the sender. The global sender email address is only used if you configure HCL Connections to prevent emails from being displayed.
- If you provide additional administrator email addresses for the
different types of notifications, those settings take precedence over
the global address. If you want the global administrator address to
be used for a specific notification, comment out the sender property
currently specified for that notification type. For example:
<!--<property name="sender">files_admin@example.com</property>-->
About this task
- Global sender. Change the default email address of the global sender into one with the correct domain for your enterprise and a name that your users will recognize and trust.
- Specific notification types. Edit the administrator addresses used when different types of notifications are sent.
Procedure
- Start the wsadmin client from the
following directory of the system where you installed the deployment
manager:
app_server_root\profiles\dm_profile_root\bin
Note: You must start the client from this directory or subsequent commands that you try to run will not execute properly. For more information, see the Starting the wsadmin client topic. - Use the following command to access the HCL Connections configuration files:
execfile("connectionsConfig.py")
If you are prompted to specify a service to connect to, type 1 to select the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file by using a local file path, you must select the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.
- Check out the notification-config.xml file
by using the following command:
where temp_dir is a temporary directory and cell_name is the WebSphere® Application Server cell to which you installed Activities. When you specify a path to the working directory on a system running Microsoft™ Windows™, use a forward slash for the directory. For example: "C:/temp".LCConfigService.checkOutNotificationConfig("temp_dir","cell_name")
Note: AIX® and Linux™: The directory you specify as the temporary directory must grant write permissions. - From the temporary directory to which you checked out the notification-config.xml file, open it in a text editor.
- Specify a valid internet-style email address containing
no spaces for the global sender by editing the globalSenderEmailAddress property
in the following section of the notification-config.xml file:
<properties> <property name="globalSenderName">HCL Connections Administrator</property> <property name="globalSenderEmailAddress">global-admin@example.com</property> </properties>
- Optional: If you want to force the email address
that you specify in the globalSenderEmailAddress to be used as the
sender of all notifications, add the following property to the <properties>
element previously listed, and set it equal to true.
<property name="alwaysUseGlobalSender">true</property>
- Optional: By default, the email address of
the original sender is set as the reply-to address. If you do not
want the original sender to appear as the reply-to address, then add
the following property to the <properties> element previously listed,
and set it equal to false.
<property name="includeOriginalSenderAsReplyTo">false</property>
If the alwaysUseGlobalSender property is set to false, then the includeOriginalSenderAsReplyTo property is ignored. If the alwaysUseGlobalSender property is set to true, then the includeOriginalSenderAsReplyTo is optional. The default value for this property is true if the property is added, but no value is defined for it.
- Optional: To specify different administrator
email addresses for different notifications types per application,
search for the notification types you want to change, and then change
the value of the sender properties. If there is no sender property,
add one.Note: If a type element is present, the email address specified for it is used instead of the global administrator address. If you want the global sender address to be used instead of the address specified here, comment out the associated type element. For example, if you want to change the address from which notifications that inform people that they have been added to an activity are sent, edit the value of the sender property in the following notification type:
- add-member
- For example:
<type name="add-member"> <channel name="email" enabled="true"> <property name="senderName">Activities Admin</property> <property name="sender">activities-admin@example.com</property> <property name="ftl">addMemberMail.ftl</property> </channel> </type>
Note: No notifications are sent from the Home page application. - Save and close the notification-config.xml file.
- Check in the configuration files using the following command:
LCConfigService.checkInNotificationConfig("<temp_dir>","<cell-name>")