Moving the Data Directory

This article explains how to change the location of the Angelfish Data Directory after installation.

If you want to move Angelfish to another server, we have a separate help article for that!

The Angelfish Data Directory contains configuration and report data files. The default location is in "/data/" underneath the Angelfish Installation Directory. 

We don't recommend moving the Data Directory to a network drive, as network i/o can cause significant performance problems.

Here's how to move the Angelfish Data Directory:

  • Stop Angelfish
  • Copy the Data Directory to the new location
  • Update agf.conf with the new location
  • Start Angelfish
  • Update License

Before proceeding, it's a good idea to open a support ticket and let us know you are moving the data directory.  We might need to unlock your Server ID or provide a manual license after the move.
 

STEPS


1) Stop Angelfish
On Linux, run "./agfsctl --stop"

On Windows, use the Start Menu shortcut to stop Angelfish.


2) Copy the Data Directory to the New Location

If you don't have enough free storage, you can substitute "move" for "copy".

Make sure the user account that owns Angelfish has full access permissions for the new location.

Once the copy is complete, please verify everything is working correctly before removing the "old" data directory.


3) Update agf.conf With the New Location
The agf.conf file is located in the Angelfish Installation directory. Please update the "datadir" variable with the new location of the Angelfish data directory.

Linux Example: 

# Angelfish Data Directory Location
datadir=/var/ssd/data

 
Windows Example:

# Angelfish Data Directory Location
datadir="d:\agfs\data"



4) Start Angelfish
On Linux, run "./agfsctl --start"

On Windows, use the Start Menu shortcut to Start Angelfish.
 

5) Update License
When you connect to the UI after starting Angelfish, you will see a screen saying the license is expired.  Click the Update License button: if your server is able to contact our licensing server, the instance will unlock.

If you have a secure instance (i.e. not able to contact our licensing server), please request a manual license by clicking the support link on the screen.
Creation date: 4/18/2022 10:44 PM      Updated: 5/21/2022 6:41 PM