Rename a User in SmarterMail

On occasion, a system administrator may need to rename a user in SmarterMail. This is a useful feature in the event that an employee has a name change due to marriage or if email naming conventions change in a company.

Applies to SmarterMail 15.x

Follow these steps to rename a SmarterMail user:
  1. Log into SmarterMail as the System or Domain Administrator. (If logged in as the System Admin, manage/impersonate the domain of the user who will be renamed.)
  2. Click on the Settings icon.
  3. Expand the Domain Settings folder in the navigation pane.
  4. Click Users. A list of users will load in the content pane.
  5. Select the user and click Edit in the content pane toolbar. 
  6. In the content pane toolbar, click Rename.
  7. In the New Username field, enter the new username and click OK. (Clicking OK will confirm and process the name change.)
  8. Adjust any other desired user settings.
  9. Click Save

 

Applies to SmarterMail 11.x - 14.x

Follow these steps to rename a SmarterMail user:

NOTE: These instructions include modifications to XML files within a SmarterTools product. Modifications to XML files can result in performance issues, functionality problems, data loss, and could cause this product to fail. Such modifications should only be made by IT professionals aware of these risks and after industry-standard backups have been successfully completed and restore procedures are in place. Modified XML files may not be supported by SmarterTools.

  1. Stop the SmarterMail service in the Services control panel on the server where SmarterMail is installed.
  2. Open the domain's accountList.xml file in Notepad. By default, this file is stored at C:\SmarterMail\Domains\[Domain Name]\accountList.xml). NOTE: Before making any changes, it is recommended to backup the file.
  3. Locate the user in the file and rename it.
  4. Save the file.
  5. Navigate to the Users folder. By default this folder is stored at C:\SmarterMail\Domains\[Domain Name]\Users)
  6. Locate the folder with the old username.
  7. Rename this folder to the new username.
  8. Open the renamed folder and open the userConfig.xml file in Notepad.
  9. Locate the following line:
    <username>username</username>
    
    and rename the value to the new username.
  10. Next, you'll want to modify the user's Display Name. So find the following section:
      <Contact>
        <ID>FF7FFBB7-9EE2-4CD5-MORE-D1G1T5</ID>
        <Indexed>False</Indexed>
        <DisplayAs>user@testdomain.com</DisplayAs>
        <EmailAddress>user@testdomain.com</EmailAddress>
        <HideFromLdap>False</HideFromLdap>
        <LastModifiedUTC>635554655537028796</LastModifiedUTC>
      </Contact>
    and modify the <DisplayAs> and <EmailAddress> fields to match the new username.
  11. Save the file.
  12. In the main domain folder (C:\SmarterMail\Domains\[Domain Name]), open the accountList.xml file.
  13. Locate the following lines 
    <AddressList>
    <Address type="User" name="OldUsername">
    </AddressList>
    and update the OldUsername with the NewUsername, then save the file. 
  14. Restart the SmarterMail service.
  15. Verify that the new name is now displayed in the Email User List for the domain.

 

Applies to SmarterMail 8.x - 10.x

Follow these steps to rename a SmarterMail user:

NOTE: This article contains instructions that include modifications to XML files within a SmarterTools product. Modifications to XML files can result in performance issues, functionality problems, data loss, and could cause this product to fail. Such modifications should only be made by IT professionals aware of these risks and after industry-standard backups have been successfully completed and restore procedures are in place. Modified XML files may not be supported by SmarterTools.

  1. Stop the SmarterMail service in the Services control panel on the server where SmarterMail is installed.
  2. Open the domain's accountList.xml file in Notepad. By default, this file is stored at C:\SmarterMail\Domains\[Domain Name]\accountList.xml). NOTE: Before making any changes, it is recommended to backup the file.
  3. Locate the user in the file and rename it.
  4. Save the file.
  5. Navigate to the Users folder. By default this folder is stored at C:\SmarterMail\Domains\[Domain Name]\Users)
  6. Locate the folder with the old username.
  7. Rename this folder to the new username.
  8. Open the renamed folder and open the userConfig.xml file in Notepad.
  9. Locate the following line:
    <username>username</username>
  10. Rename the value to the new username.
  11. Save the file.
  12. Restart the SmarterMail service.
  13. Verify that the new name is now displayed in the Email User List for the domain.

For more information, please refer to the SmarterMail Online Help.

 

Learn more about SmarterMail's enterprise email features and benefits.

Feedback

Add Feedback
steps 2, 3 and 4 are the same as step 11 and 12
Richard Frank (January 6, 2015 at 4:03 AM)
This is great, however... Why not just add this as a feature in the server? Seems like you should be able to "Rename a User Account" Then specify old name, new name. Just a thought.
Tim DeMeza (February 24, 2015 at 12:00 PM)
+1 for this... surely you can rename an account and have the server work out reloading the domain's config without restarting the server... surely that's just an object call to override the config in memory?
Christopher Dawes (April 1, 2015 at 6:47 PM)
In SmarterMail 15.x, the ability to rename a user and domain within the Web interface (and without stopping the SmarterMail service) is now available!
Andrea Rogers (February 19, 2016 at 12:28 PM)

Add Feedback