Points to be noted before moving SharePoint Manager Plus to a new location:
Note: The following steps are applicable only if your SharePoint Manager Plus installation uses pgSQL database.
Method 1: Moving the existing SharePoint Manager Plus installation from the current location to a new location/server.
Method 2: Downloading and installing
SharePoint Manager Plus on the new server and restoring the DB backup taken
from the old instance.
1) Moving the existing
SharePoint Manager Plus installation from the current location to a new
location/server
Follow the steps below to migrate the license, product configurations, and all the data:
Sample code:
path.data :
- <New Location>\ManageEngine\SharePoint
Manager Plus\ES\data
path.repo :
<New Location>\ManageEngine\SharePoint Manager Plus\ES\repo
Note: If you are using MS SQL server as backend DB and if the MS SQL is running in a remote computer, make sure to download and install SQL native client, command line utilities, and ODBC Driver in the new machine in which SharePoint Manager Plus is running.
SQL Server version |
Command Line Utilities (cmdlnutils) |
Native Client (ncli) |
ODBC Driver (odbc) |
2008 |
https://www.microsoft.com/en-in/download/details.aspx?id=44272 |
https://www.microsoft.com/en-in/download/details.aspx?id=44272 |
Not required |
2012 |
https://www.microsoft.com/en-in/download/details.aspx?id=43339 |
https://www.microsoft.com/en-in/download/details.aspx?id=43339 |
Not required |
2014 |
https://www.microsoft.com/en-US/download/details.aspx?id=53164 |
Not required |
https://www.microsoft.com/en-in/download/details.aspx?id=36434 |
2016, 2017, and 2019 |
https://www.microsoft.com/en-us/download/details.aspx?id=56833 |
Not required |
https://www.microsoft.com/en-us/download/details.aspx?id=56833 |
2) Downloading and installing SharePoint Manager Plus in the new server and restoring the DB backup taken from the old instance
Stop SharePoint Manager Plus.
Steps: Start → All Programs → SharePoint Manager Plus → Stop SharePoint Manager Plus (or),
Start → Run → services.msc → Stop ManageEngine SharePoint Manager Plus service.
Navigate to <Installation Directory>\SharePoint Manager Plus\bin and open an elevated Command Prompt (right-click Command Prompt and select Run as administrator).
Run backupDB.bat file to back up the database of your current installation. The backup file can be found inside the folder where SharePoint Manager Plus has been installed (C:\ManageEngine\SharePoint Manager Plus\Backup)(Example: OfflineBackup_20161129235853.ezip).
Note: Make sure that password is configured under Admin → Custom Settings → Database Settings.
3. Download and install SharePoint Manager Plus on the new server.
4. In the new server, start the product and verify the build number. Then, stop the product.
5. Copy the compressed database backup file created in the old server to the following location in the new server: \SharePoint Manager Plus\bin (For example: C:\ManageEngine\SharePoint Manager Plus\bin)
6. In the new server, navigate to \SharePoint Manager Plus\bin and open an elevated command prompt (right-click Command Prompt and select Run as administrator).
7. Execute the restoreDB.bat file from the Command Prompt using the compressed database file. For example: restoreDB.bat "C:\ManageEngine\SharePoint Manager Plus\OfflineBackup_20161129235853.ezip" -p
8. When it prompts for a password, Enter the password you configured under Database Settings.
9. Copy the archive, archive_index and ES folders present in <Installation Directory>\SharePoint Manager Plus and paste them to <New Installation Directory>\SharePoint Manager Plus.
10. Open <New Location>\ManageEngine\SharePoint Manager Plus\ES\config\elasticsearch.yml. Replace path.data and path.repo values with new location.
Sample code:
path.data :
- <New Location>\ManageEngine\SharePoint Manager
Plus\ES\data
path.repo
: <New Location>\ManageEngine\SharePoint Manager Plus\ES\repo
11. Copy the customer-config.xml and database_params.conf files present in <Installation Directory>\SharePoint Manager Plus\conf and paste it to <New Installation Directory>\SharePoint Manager Plus\conf.
12. Apply the original license file sent to your email from licensing@manageengine.com. Alternatively, you can also copy the license folder present in <Installation Directory>\SharePoint Manager Plus\lib and paste it to <New Installation Directory>\SharePoint Manager Plus\lib.
13.
To start the product, click Start → All Programs → SharePoint
Manager Plus → Start SharePoint Manager Plus.
After moving SharePoint Manager Plus to a new location, follow the steps below if you have configured a Microsoft 365 Tenant using Azure Application.
1. Navigate to <Product Location>\bin, where <Product location> is the location where SharePoint Manager Plus has been installed.
2.
Open Command Prompt here and run the following command.
connectDB.bat
3.
Once the Database Console opens, run the below command.
Select
farm_id, cert_path from AzureAppCredentials;
4. You can find the former certificate location under cert_path column.
5.
Find the new location of the certificate and copy its path.
6.
Update the path in the database by running this command in the
database console for each Microsoft 365 Tenant configured.
Update
AzureAppCredentials set cert_path = '<New Certificate Location>' where
farm_id = '<Tenant Admin Url>';