What steps are needed when moving Foglight to a different hardware? (4310144)

Move Unix/Linux based FMS:

1. Stop the FMS and back up the $FMS_Home directory (this directory includes the embedded database if applicable)

2. Restore the $FMS_Home to the new server to whatever drive/directory you wish. See note below about updating startup files.

NOTE: If the directory structure/path where the newly restored FMS resides does not match the previous directory structure/path, you must update the /fms_home/bin/ fmsStartup.sh and fmsShutdown.sh script files (if they are being used) to reflect the new directory path.

3. You can skip this step if you're not using embedded MySQL or PostgreSQL database. Make sure the embedded database is not started, in order to do this run "ps -ef  ｜ grep -i Foglight" and verify if you see any line that mention the embedded database (mysql or postgres) if the database is still running go to the bin folder in the foglight home directory and run "$FMShome/bin/shutdownDb.sh".

4. Start FMS with "$FMS_Home/bin/fmsStartup.sh"

5. Once it's started, log in and install new Foglight license (if FMS hostname has changed)

6. Verify that Foglight Agent Manager are connecting and agents are starting up.  
NOTE:  If FMS hostname has changed, each FglAm client fglam.config.xml file will require a change to connect to the 'new' FMS hostname.

7. Verify no host name or IP address related errors are seen in the FMS logs ($FMS_Home/logs/) as a result of the move.


Move Windows based FMS:

1. Stop the FMS and back up the $FMS_Home directory (this directory includes the embedded database if applicable). 

2. Restore the $FMS_Home to the new server to whatever drive/directory you wish. See note A below about updating startup files.  If directly copying from source to target, we recommend to use Robocopy to avoid errors such as "File name(s) would be too long for the destination folder".  When running Robocopy, be sure to run it on a command prompt that is opened as "Run as administrator".

NOTE: Windows has a limitation where the entire path to a file cannot be over 255 characters.  Microsoft has a command line copy program named "Robocopy" which can copy files without this limitation. Robocopy will accept UNC pathnames including UNC pathnames over 256 characters long.

Example:

robocopy \\sourcehost\Quest_Software\Foglight E:\Quest_Software\Foglight /E /ZB /V /COPYALL /DCOPY:DAT /LOG:"E:\Quest_Software\log.txt" /TEE 

3. Start up the FMS - from $FMS_Home\bin run: fms.exe -s

4. Once it is started, log in and install new Foglight license (if FMS hostname has changed)

5. Verify that Foglight Agent Manager are connecting and agents are starting up

6. Verify no hostname or IP address related errors are seen in the FMS logs ($FMS_Home\logs\) as a result of the move.

Additional steps:

7. May want to install Foglight as a Windows Service on the new server. To do so, run command line command
    \FMS_Home\bin\fms.exe -i
    then configure the service from Windows Services (services.msc)

8. The shortcuts that exist on the old Windows FMS location can be copied over and the paths changed to point to the correct location of the FMS

9. Be aware that when upgrading this newly moved Foglight FMS, a Windows registry entry will be missing that tells a Foglight installer that a current Foglight install exists. Please point the Foglight installer to the existing Foglight FMS home directory.

10. Please also verify the firewall setting on new FMS server. Make sure all requested port are open between FglAM and new FMS server

NOTE: Moving the FMS installation between different Operating System types is not supported.
 

If the FMS hostname/ IP address has changed, change the FMS' embedded (or externally moved) FglAM "fglam.config.xml" file so it does not start up and check into the FMS using the old FMS/FglAM hostname:

If the FMS hostname/IP address changes, the existing FglAM needs to the new location.

For this procedure see solution 50479

Check the Foglight Server URL Registry Variable

Once the FMS has been moved and is up and running, a Foglight registry variable needs to be changed so the server knows the URL has changed.

1. Log in to your FMS.
2. Under "Dashboards" navigate to "Administration | Rules & Notifications | Manage Registry Variables"
3. Locate the variable "CATALYST_URL" and open it by clicking on its name.
4. If necessary, change the variable to reflect the updated FQDN, hostname or IP of the server.