21 Oct 2016

Migrate objects to CloudPanel

CloudPanel has the ability to import existing objects in Active Directory and Exchange into the CloudPanel database so you can manage.

Before performing these steps there are important things to note to make sure you have a functioning environment.

icon-support
CloudPanel will only import the values currently in Active Directory into the database and will not modify anything on the backend. If you are migrating from another control panel you will need to make sure the backend is ready and correct before importing. Compsys/Know More IT is not responsible for any issues that arise from an improper import process.

Import Companies

You can import companies in Active Directory into the CloudPanel database by going to: /CloudPanel/import/[ResellerCode]

Before importing the companies you must make sure the organizational unit is located in the reseller organization unit that is under the Hosting OU you specified in the CloudPanel settings.

Make sure the uPNSuffixes attribute on the company’s organizational unit contains the domains that are part of the company. If you forget to do this then it will result in an error.

There are some important things to note when importing companies:

  • During the import process the system will create the security groups and organizational units that are missing. Do not pre-create these objects because it will cause the import process to fail. These objects include the Applications and Exchange OU’s and the AllUsers and AllTSUsers security groups.
  • You must choose an organization plan in the drop down list to assign to the company when importing
  • The name of the organizational unit will be used as the Company Code during the import process. You must make sure the name does not contain any special characters (whitespace is OK) or it will cause an error when trying to access the company.
  • If you have whitespace in the organizational unit name you may need to check the security groups being created and remove whitespace from the name in the group
  • If you do not remove the “Protect object from accidental deletion” from the organizational unit then you will be unable to delete this company completely from CloudPanel
  • During the import process if you select that the company is already Exchange enabled then you MUST make sure all the Exchange objects that CloudPanel would normally create already exist in Exchange. If you want to let CloudPanel create these for you and move your users to the new Address Book Policy that CloudPanel creates then you can import the company without checking Exchange enabled and go into the company and enable Exchange (this will create the objects for you)

Importing Users

You can import users from Active Directory into the CloudPanel database by going to: /CloudPanel/company/[CompanyCode]/import/users

When importing users you must make sure that the users are already configured properly on the backend. CloudPanel will just read the data from the Active Directory user and place it in the database without making any modifications to Exchange or anything else on the backend.

Important notes about importing users:

  • The import user page may show other objects in Active Directory that are not users. Pay special attention to what you are importing
  • The users need to have their UserPrincipalName using a domain that is part of the company already
  • If the user already has a mailbox you must select a Mailbox plan that matches the settings. Choosing the Mailbox plan will not update the user’s settings in Exchange which is why you must make sure the CustomAttribute1 value contains the company code, the correct Address Book Policy is set and the other Exchange properties match the plan. If you choose a Mailbox plan and the user doesn?t have a mailbox then CloudPanel will detect this and import the user into the database without a mailbox.
  • If the user already has an archive mailbox you must choose the archive plan that matches the settings.

Importing Other Objects

You can import other objects into CloudPanel by browsing to: /CloudPanel/company/[CompanyCode]/import

Any object you import will need to already be configured on the backend proeprly. Skipping this step will cause an unstable environment.

icon-support
If you need assistance with importing or migrating to CloudPanel then please contact support.