Issue

• Errors such as the following occur:

  • Revspec 'abcdefgh123..' not found

  • refs/heads/master not found

  • Project file with guid <nnnn> does not exist

  • 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.

• Root issue usually due to a corrupted local repo and/or the repos being out of sync

Cause

• Improper procedure when migrating or upgrading Iguana, or if there was a change in the working directory

• Improper alteration of local repo files (see https://help.interfaceware.com/v6/causes-of-iguana-local-repo-corruption)

• Windows update causing Iguana to not shut down gracefully (#36737)

Possible Solutions

1. Refer client to https://help.interfaceware.com/v6/fix-local-repository-corruption-after-upgrading-migrating-iguana and/or https://help.interfaceware.com/v6/causes-of-iguana-local-repo-corruption

2. Whenever moving working directories, ensure proper backup and restore procedures is followed as per our documentation here: http://help.interfaceware.com/v6/backup-and-restore

3. If the error persists, most likely client has messed something, could be upgrading incorrectly or changing the working directories

   1. Ask them to go into their working directory and zip up/send over their IguanaMainRepo, edit, and IguanaConfigurationRepo folders so we can have a look and diagnose what could be wrong. 

   2. You can forward to dev team the folders for analysis and restoring IguanaMainRepo to a working state.

   3. Dev team usually gives support team a zip file of IguanaMainRepo.zip file. The steps to follow in order to get your installation back up and working: 

      • Stop the Iguana service

      • Navigate to your new working directory location

      • Backup then remove the following folders:

        • IguanaMainRepo

        • IguanaConfigurationRepo

        • edit

        • run

      • Once those are removed, unzip the attached file. 

      • Copy and paste the resultant IguanaMainRepo folder into the new working directory location.

      • Start the Iguana service again.

Adapted from Amandeep Aujla’s article in Basecamp.