Superfiles allow you to create very large databases. It allows you to create a series of database files with a specific size. The size of these files are dependent on your situation, such as available space (no so much of an issues these days), back up sizes, etc.
The following is a quick tutorial of how to convert the ds_gis/gdb.ds file of the Cambridge databse.
Get a handle on a new view and then the gdb.ds file to it
av << database_view.new(:readonly,:searchpath,
Now get a handle on the file and convert it to a superfile with maximum size of 2000MB. Note the maximum size must be greater or equal in size of the current size of the DS dile.
af << av.file("gdb.ds")
Now add a new component to the newly converted superfile. The pathname is local to the server, therefore it should not have a UNC (//server/path) type of format.
The above converts the gdb.ds file into a superfile with the original file maximum size of 2000MB and a component with maximum size of 2000MB. Note that you will not see any data being inserted into the 1st component until the 2000MB maximum of the primary component.