How to modify IguanaConfiguration.xml
Summary
Iguana configurations (e.g. logs, iguana dashboard ports) are stored in IguanaConfigurations.xml located in Iguana Working Directory
Most of Iguana configurations can be updated via Iguana Dashboard except some specific configurations such as Log directory path, Iguana dashboard port
Moreover, IguanaConfiguretion.xml can used for Iguana auto installation and deployment
Where to Find Configurations
The IguanaConfiguration.xml is located in Iguana Working Directory → IguanaConfiguraitonRepo folder
Common Changes in IguanaConfiguration.xml
Iguana Dashboard Port
This Setting can be changed within Iguana Dashboard. However ,If you are running two instances of iguana in the same machine this will result in a port conflict which will prevent Iguana from starting, because by default both iguana instance are set to use Port 6543.
To change the port manually open your IguanaConfiguration.xml in a text editor and look for a “web_config” tag ,
Under the “web_config” tag you can see a setting “port” . There you change from the default 6543 to any port based on your requirements.
Iguana Logs Directory
By default Iguana will store logs inside the working directory under the logs folder .
If you would want Iguana to generate and store log file in a different directory you can use the steps below to change the configuration.
Simply, open your IguanaConfiguration.xml in a text editor and look for a “log_config” tag ,
Look for log_directory , and change the directory path.
However you will also need to change the index_directory path , which should be inside whichever directory your logs will be stored. For example if your log_directory path is “C:\Program Files\Iguana\Logs” then your log_index must be “C:\Program Files\Iguana\Logs\index”.
Other Considerations
Always Commit After Making IguanaConfiguration.xml Change
Since the configuration xml in IguanaConfigurationRepo has been changed, it is a good practice to make any commitment in order for IguanaConfigurationRepo to push the changes into the IguanaMainRepo.
If you do not make any commit in Iguana after editing in the IguanaConfiguration.xml Iguana will not force the changes to the Main repo which means both IguanaConfigurationRepo and IguanaMainRepo will be out of sync, which can lead to Errors on Iguana startup, In order to fix the errors Iguana config will have to be rebuild using the IguanaMainRepo. Since the changes were not pushed into the main repo your Iguana will revert back to your previous settings and you will end up loosing all the changes that were made.