This article will describe how to run the FootPrints Service Core Migration Advisor in silent mode from the command line of a system that does not support a graphical user interface (GUI).

By default the FootPrints Migration Advisor shows a graphical user interface (GUI) when it is run.

 Some Linux and Windows systems do not have support for a GUI installed.

Migration Advisor may still be used in these environments by running the tool in silent mode.

 Silent mode requires the manual configuration of an "options" file which contains answers to all the questions the GUI would normally ask.

Once started, the Migration Advisor will continue without the need for any user interaction.

Silent mode is invoked from the command line. The user running the silent install should be familiar with issuing commands from the command line in the environment where FootPrints Migration Advisor will be run. Additionally, these steps must be performed with full Administrator privileges.

When running on a headless Linux system, you may see this error:

Running with DISPLAY environment variable set to:
localhost:0.0

Listening for transport dt_socket at address: 12333
(Jan 01 2016 01:09:50.037 PM -0600),SEVERE,com.bmc.install.product.base.project.runner.ProjectRunner,
THROWABLE EVENT {Description=[Error]},
Throwable=[java.lang.NoClassDefFoundError: Could not initialize class sun.awt.X11GraphicsEnvironment

1. Create an options file to use during the silent mode running of the Migration Advisor.
   1. Download the default options file attached to this article.
   2. Rename the downloaded options file to "options.txt".
   3. Copy "options.txt" to the system where FootPrints 11.x is installed.
   4. Edit the options.txt file and review each setting in the file and verify the value is appropriate for the environment where FootPrints 11.x is installed. Make changes as necessary.
      Notes:
      1. Special characters, such as backslash (\), forward slash (/), double quote ("), etc., do not need to be escaped in the options.txt file.
      2. Lines which start with a hash character (#) are comments and are ignored.
2. Copy the FootPrints Migration Advisor to the system where FootPrints 11.x is installed.
   Notes:
   1. If you have downloaded the compressed version of the Migration Advisor, e.g., the .zip or .tar.gz, you must extract the archive before running the Migration Advisor.
3. Run the Migration Advisor in silent mode with the following command line. Choose the appropriate command line based on your operating system. Note: The setup.exe or setup.sh file will be located in the "Disk1" or root folder of the extracted Migration Advisor folder.
4. Windows: setup.exe -i silent -DOPTIONS_FILE=options.txt      Note: You may use a relative or a fully qualified path to specify the location of the setup.exe and/or the options.txt file. C:\path\to\Disk1\setup.exe -i silent -DOPTIONS_FILE=C:\path\to\options\options.txt         
   Linux setup.sh -i silent -DOPTIONS_FILE=options.txt     Note: You may use a relative or a fully qualified path to specify the location of the setup.bin and/or the options.txt file. /path/to/Disk1/setup.sh -i silent -DOPTIONS_FILE=/path/to/options/options.txt
5. The Migration Advisor will generate a log file in the temporary folder of the user running the tool, for example, %TEMP% in Windows, /tmp in Linux. The Migration Advisor log file is named:
   footprints_install_log.txt  Note: The Migration Advisor may take several minutes to complete and is not done until the command returns.
6. Review the generated log file to ensure the Migration Advisor completed successfully. The end of the log file should indicate the tool finished successfully. There should be a message similar to this near the end of the log file:
   -------------------------------------------------------- Service Core 12 Migration Advisor 1.0.00 install succeeded. --------------------------------------------------------
7. The Migration Advisor will create a report in the FootPrints Service Core folder specified in the "options.txt" file:
   Example: C:\FootPrintsServiceCore\MigrationAdvisorReports\Analysis_2014-05-08-11-20.html   Note: The Migration Advisor may be run multiple times. Each time the tool is run a new report is generated. If the tool is run more than one time there will be multiple reports in the MigrationAdvisorReports folder.