Documentation

Adds a metadata location to a server group in a PyramidInfo.

The PyramidInfo structure contains all of the information required to describe a single instance of a pyramid, be it on local disk or on a DPSS. In particular, a single pyramid can have a number of different server configurations.

This function lets you add a metadata location (URL) to the list of metadata locations for any server group of a Pyramid. Metadata means tspec data in terms of the TerraVision application. In each case, the metadata array of the specific server group will be grown by one for you automatically and the new data added.

You specify which server group configuration of the pyramid you want to update by giving the server_group number. Internally, the PyramidInfo structure holds an array of ServerGroup structures - this function will automatically grow this server array if you specify a server_group number larger than the number of ServerGroups currently allocated, e.g. if you have not previously added any information to the ServerGroup array (i.e. the array is size 0), and you specify that you want to update the contents of server_group 2, then this function will add two new ServerGroup entries to the array, clear the contents of both to 0, then add the specified information to the second of these.