Creating a preconfigured Iguana install

Creating an initial repository from scratch

In this example, we will use both Iguana and standalone fossil executable to create a repository file with our own set of examples.

  1. Create a new Iguana working directory my_working_dir. Run iguana with ‘iguana –run –working dir my_working_dir
  2. Create a channel that you want to use an example. The name you give to the channel will be shown in the list of existing projects when importing.
  3. Edit the script. Add any required shared modules and other support files (such as VMD’s)
  4. When you are ready to add the channel to a repository, copy my_working_dir/edit/<user name> into a temporary directory (tmp_dir).
  5. Remove tmp_dir/_FOSSIL_
  6. From within the tmp_dir, do the following set of commands:
    1. fossil new initial.sqlite
    2. fossil open initial.sqlite
    3. fossil add <CHANNEL_GUID>
    4. fossil add shared
    5. fossil add other
    6. fossil commit -f -m “My Initial Revision Name” –tag “My Example Name”
    7. fossil close
      Note: The CHANNEL_GUID is a 32 character hexadecimal ID unique for each channel. The mapping from channel names to GUIDs can be observed in IguanaConfiguration.xml.
  7. Add initial.sqlite to your Iguana manual installation zip file. If initial.sqlite already exists inside the zip file, remove it first.