Application Maintenance

Application Maintenance

Taking a backup of your Analytics Plus data

It is recommended to take a regular backup of your Analytics Plus data and configuration.

  • Stop the ManageEngine Analytics Plus service.

  • Open the command prompt (as administrator) and change the directory to <Analytics Plus home>\bin

  • Run the command backupDB.bat and wait for the script to take a complete backup of your installation.

  • A compressed ZIP file will be created in the location <Analytics Plus home>\Backup

The following are some additional parameters that can be included with the backupDB command:

  • -t d : By including this parameter with the backupDB.bat command, you can specify the backup to be a dump file.

  • -t b : By including this parameter with the backupDB.bat command, you can specify the backup to be a binary file.

  • -t fb : By including this parameter with the backupDB.bat command, you can specify the backup to be a file backup.

  • -f : This parameter allows you to provide a name for the backup file.

  • -d : This parameter allows you to specify the directory that the backup file has to be saved in. 

  • -p : This allows you to specify a password for the backup file.

Here are some examples of the above scripts:

backupDB -f test -d ../Backup -t b -p Test123

backupDB -p Test123

backupDB -f test

Recovering your Analytics Plus data

  • Install a new copy of Analytics Plus. The new copy should be of the same build number as your original installation.

  • Start the ManageEngine Analytics Plus service and make sure the application is accessible.

  • Stop the ManageEngine Analytics Plus service.

  • Open the command prompt (as administrator) and change the directory to <Analytics Plus home>\bin

  • Run the command restoreDB.bat <full directory path of your backup ZIP file>

Note:

By default, Analytics Plus sets a password for the backup file, which will be the reverse of the file's name. For instance, the 'Test123' backup file would have '321tesT' as its default password. This can be modified while taking a backup, using this command

Therefore, while restoring a backup, the following command has to be included with the restoreDB command:

  • -p : This parameter, followed by the password, allows you to restore the password protected backups. 

Here are some examples:

restoreDB test.ezip -p 321tseT

restoreDB OfflineBackup235161 -p 321tseT

restoreDB test.ezip -p tset 

Once the recovery is complete, start the ManageEngine Analytics Plus service

Performance fine tuning

In most cases, you wouldn't need to increase the memory used by the Analytics Plus processes. But if you feel the application is slowing down, you can increase the heap memory allocated to it.

Open the Wrapper.conf file present in the <Analytics Plus home>\reports\conf directory and search for the string Maximum Java Heap Size (in MB). Change the value of wrapper.java.maxmemory= from 1024 to a maximum of 4096. This allocates 4GB of memory to the Analytics Plus processes.

Make sure that you do not allocate all available memory on the server to Analytics Plus.

  

Upgrading to the latest version

  • It is recommended to upgrade to newer versions of the software at least once every 2 months. Check announcements on our user community regularly for news about latest versions.
  • To upgrade to the latest version, stop Analytics Plus, take a folder backup of the Analytics Plus installation directory and then run UpdateManager.bat file present in the <Analytics Plus home>\bin directory.

Important Note: Open the command prompt as administrator and then run the UpdateManager.bat script to avoid upgrade failures due to insufficient permissions.

 

Change the web server port

Follow the steps given below to change the web server port where Analytics Plus is running.

  • Go to Start --> Services.msc and stop ManageEngine Analytics Plus service.

  • Navigate to <Analytics Plus_Home>\bin directory from command prompt or terminal in administrator mode.
  • Execute the changeHostPort.bat using the following syntax.

changeHostPort.bat <new port number> true

  • Once the script gets executed successfully, start the ManageEngine Analytics Plus service.

Note: On Linux servers, run sh changeHostPort.sh

Moving Analytics Plus from one server/folder to another

  • Go to Start --> Services.msc and stop the ManageEngine Analytics Plus service.

  • Take a backup of the entire <Analytics Plus_Home> directory and then move it to the new server. 
  • On the new server, navigate to <Analytics Plus_Home>\bin directory from command prompt or terminal in administrator mode.
  • Run ServerMigration.bat
  • If the port that Analytics Plus was running on, in the old server is occupied in the new one, the script will prompt for a new port number.

Note: On Linux installations, Run sh ServerMigration.sh 

If you have not integrated Analytics Plus with ServiceDesk Plus, ServiceDesk Plus MSP or SupportCenter Plus, start your Analytics Plus service to complete the migration.

If you have integrated Analytics Plus with any of the above, there are a few more steps. Click the respective version to continue.

 

Share this post : FacebookTwitter