User Tools

Site Tools


Sidebar

Announcement

Ahsay Backup Software

Backup Set Types

Supported Storage

Features in OBM / ACB

Features in CBS

Brand and Customize

License

Documentation

Performance Testing

FAQs and Known Issues

Can't Find What You Need?

public:users

This is an old revision of the document!


Users Management

Through AhsayCBS (logged in as administrator) > Backup / Restore > Users, Groups & Policies > Backup User > Manage Backup User, administrator is able to manage all the users. With the function icons displayed under Manage Backup User, you can perform the following action.

Add new backup user

A new backup user can be created. Following properties can be configured for a backup user

  • Login name
  • Password
  • User Group
  • Alias
  • Home Directory
  • Subscription Type
  • Suspend At
  • Status
  • Upload Encryption Key (this field is hidden in branded AhsayCBS)
  • Language
  • Timezone
  • Notes
  • Backup Client Type (AhsayOBM / AhsayACB)
  • Add-on Modules
  • Quota
  • Client Host Limit
  • Manage Contact Information

Add new backup user

A new backup user can be created. Following properties can be configured for a backup user

Move / Import / Export Users

This function handles export users to a file, import users from a file, and export user’s home directory to another user home. You may use this function to migrate a user from an AhsayCBS to another AhsayCBS, migrate a user from the user home to another user home on the same machine. This function is limited to system user with admin role.

  • Move user home to – Export user from a user home to another user home.
  • (v7 users) Import users to – Import a previous exported user zip file into the user home.
  • (v6 users) Import users from previous versions – Import a v6 user profile from user home. (Move v6 user folder into v7 user home then enter the page, do not required restart services, will skip empty named user / existing users in CBS for selection)
  • Export users to file – Export user profile and backup files to a zip file format.

Note : Please schedule a time with your users when you need to migrate their user home to another user home/AhsayCBS. It is better to suspend the user, stop any running backup, and close the client interface before you perform the user export.

Since the move of a user from a user home to another user home would export the whole user profile and the backup data from a user to another user home. When moving a user account with large backup sets, it is expected to wait for a long period of time. So, it is suggested to perform 1 user export at a time, and during the export, please do not restart service or server. In case of power failure or server shutdown, the move user’s process would become fail.


Export Users' Usage Statistics to CSV

To export user' usage statistic to a CSV (Comma Separated Values) file. Which you can import/concert to other tools such as Excel or database for further purpose.

In exported CSV file:
Name: User name
Alias: Alias of user
Owner: Owner of user
Usage (Bytes): To convert back to K/M/G/TB, divided by 1024
Quota (Bytes): To convert back to K/M/G/TB, divided by 1024. Limitation: Standard quota before migrating to >=v7.15.6.38 is shown in this field, which may be out sync with the current quota settings in CBS >= v7.15.6.38
(Refer to 21064 [KB ER] Able to show the quota of destinations for exporting CSV)


Broadcast Message

Send broadcast message to contact email address of backup user(s) in text / html format (with / without attachment)


Save Button

After clicked the save buttons, the backup users (users.xml), user groups (userGroup.xml) and policy groups (policyList.xml) are updated.

  • Avoid concurrent modification to autoUpdate.bdb, the page is blocked when clicked the save / cancel button.

Cancel Button

After clicked the cancel button, the add user list and delete user list is cleared


Manage Windows Active Directory Integration

When this feature is enabled and AhsayCBS fails to authenticate a user logon using its own records, a user authentication will be dispatched to Windows Active Directory automatically. This means that if an AD is presented in the network, it is only required to create a user account once in the Windows Active Directory. The same user account can also be used on the AhsayCBS server. This is because AhsayCBS will create this user account automatically after authenticating this logon using AD. The user account created will be of the type Paid and of backup client AhsayACB (unless the user logon using AhsayOBM).

  • Note that the whole page will wait for this tab to be loaded before displaying the page for non-re-seller system users.

Expected Behaviors

  1. Backup User List
    1. Filter
      1. Client Type: Filter the backup users by the client type (OBM / ACB) and customized client type should be shown (%OBM_SHORT_NAME%, %ACB_SHORT_NAME%)
    2. Export user's usage statistics to CSV
      1. Exports the used online quota (i.e. exclude local destination) and remaining online quota of the user in .CSV format.
    3. Backup User
      1. Trigger the backup job running in OBC after selected the destination(s) where the destination ID(s) are saved in users.xml as follows. Make sure the scheduler service in client machine is started.
<Key name="com.ahsay.obx.cxp.cloud.RunBackupSettings" content="">
	<Value data="Y" name="enable" type="boolean" />
	<Value data="" name="backup-type" type="string" />
	<Value data="2017-05-21-22-02-45" name="backup-job-id" type="string" />
	<Value data="-1495245989958" name="destination-id-1" type="string" />
	<Value data="-1495246372172" name="destination-id-2" type="string" />
	<Value data="-1495375276154" name="destination-id-3" type="string" />
</Key>

Troubleshooting Guide

User owned by sub-admin disappear when save button is clicked in [User, Groups & Policies]

When v6 users in OBS owned by sub-admin are migrated to newly installed CBS by moving the user folders {username}#{sub-admin ID}, and a new sub-admin is created in CBS instead of migrated from the OBS, ID of the sub-admin will not be align and upon clicking the save button in [User, Groups & Policies], checking will be done to remove the mismatched users. User setting changes and encryption key may be loss together.

Solution

1. Stop CBS services

2. Change the system user ID in cbs.json(“ID”=XXXXX) and /branding to align with the #ID in user home

3. Start CBS services

Move User Home (Replication)

If a partner has replication enabled and moved their user homes on CBS, the user home folder will be automatically replicated to the new user home on the replication server. However, they will have a duplicated user home folder in the old user home of the replication server. If there are any snapshots that have not been copied over, try the following:

1. Check that the new user home does not have the same retention snapshot folder.

2. If it does not have the same retention snapshot folder, copy it from the old user home.

3. If it does have the same retention snapshot folder, do not try to merge the two together as this could lead to data corruption.


Below are the FAQs / Issues related to AhsayCBS Users Management feature.

Issues

public/users.1565579071.txt.gz · Last modified: 2019/08/12 11:04 by ronnie.chan

Page Tools