Issue

• Issue related to Git and it caused corruption in one of the repositories

• Iguana will not start, it starts up but shuts down

• Crash dumps may or may not be produced

• ServiceErrorLogs are Git related errors

• NotFoundError: The requested reference “HEAD” was not found.

• In ServiceErrorLog:
   [ERROR] Remotes repo reference file doesn't exist yet. It must be created before retrieving it.
  Remotes repo reference file doesn't exist yet. It must be created before retrieving it.

• Usually seen in Iguana version 6, Iguana 7 should not have these issues since git is being rebuilt

Possible Causes

• The repository somehow got corrupted

• There is a bug in Iguana and it cannot handle the corrupted repo gracefully, causing a crash

• Git garbage collection failed

• Improper migration process

Possible Solutions

You will need to rebuild their Iguana but only do the following if you are certain they have a corrupted Iguana. The edit and IguanaConfigurationRepo are the main culprits for corruption, but other files can cause the issue as well.

Case 1: Quick Rebuild

1. Backup the “edit” and “IguanaConfigurationRepo”

2. Stop Iguana service

3. Delete the edit, run, and IguanaConfigurationRepo folders

4. Restart Iguana

This method deletes the problem folders but does not touch other files in the working directory. These folders will get rebuilt using the IguanaMainRepo on startup.

Case 2: Rebuild the working directory

Rebuild the working directory, this removes the dependencies on other files in the Iguana working directory. This process also works if the customer’s working directory is the same as their install directory

1. Backup the Iguana directory

2. Update the iguana_service.hdf to point to a working_dir
   (e.g. command_line=iguana.exe -working_dir "C:\Users\obner\Documents\Test\IguanaConfig")

3. In the command line, reinstall the service
   iguana_service --install

4. Copy these files to the working dir:
   - data folder
   - IguanaMainRepo
   - IguanaEnv.txt (File for environment variable, might not be present)
   - Any files ending with .sqlite (might not be present)

5. Start Iguana, you will notice some folders get rebuilt in the working directory (edit, IguanaMainRepo)

6. The service should start and you will be able to get in, if there is anything wrong with their channels, there might be a file the client needs from their backup. Make sure they do not delete the backup.

NOTE: If the client does not want to change their working directory, follow Case 3

Case 3: Delete all files

1. Backup the working directory

2. Delete all files EXCEPT
   - data folder
   - IguanaMainRepo
   - IguanaLicense
   - IguanaEnv.txt (File for environment variable, might not be present)
   - Any files ending with .sqlite (might not be present)

3. Start Iguana, you will notice some folders get rebuilt in the working directory (edit, IguanaMainRepo)

4. The service should start and you will be able to get in, if there is anything wrong with their channels, there might be a file the client needs from their backup. Make sure they do not delete the backup.

You can move back dependant files from the backup back into the working directory.