Skip to main content

Creating a New Database in System Explorer

  1. Open the System Explorer.

    From the WindowsStart menu, select All Programs > PI SystemPI System Explorer to open the PI System Explorer window.

    If this is the first time you have opened an AF client application, the system prompts you to select a database directly.

  2. In the PI System Explorer window, select File > Database, or

    click the Database button on the toolbar.

    The Select Database window opens.Figure 78: Select Database window

    Before creating a new database, you need to connect to the Sigmafine server where you want the new database to reside.

  3. Click the Asset server down arrow and select the server.

    If the server you need is not listed, click the ellipsis button to open a server selection window where you can locate and select the server.

    If the server you want is not listed in the window:

  4. Either click the Add Asset Server button, or

    right-click on the list of servers (as shown above) and select Add Asset Server from the pop-up menu.Figure 79: PI AF Server window

  5. After entering / selecting the server information, click OK.

    You are returned to the Select Database window.

  6. After selecting or adding a server, click Connect to list the databases available on the server.

    The Databases list is populated with the databases on the server you selected.

    If the System is connected, one default database named “configuration” is displayed. This is used by the Data Directory clients as they use the Data Directory. Do not use this for your own application.

    Warning: Do not Edit/Delete the ‘Configuration’ Database.Figure 80: Select Database - Databases list populated

  7. Click on theNew Database button.

    The Database Properties window opens.Figure 81: Database Properties window

  8. In the Name box, type a name for the database.

    The name can imply the scope of the Sigmafine model, for example "Plant-wide Model" or "Unit Model".

  9. (Optional) In the Description box, type a meaningful description for the database.

  10. Click OK to create the database and close the Database Properties window.

    You are returned to the PI System Explorer window.

  11. Import the Unit-of-Measure classes:

  12. In the navigation pane on the left, select Unit of Measure.Figure 82: Navigation pane - select Unit of Measure

    .

  13. Select File > Import from File....Figure 83: PI System Explorer - select Import from File

    Note: This is done just once to obtain the UOMs used by the Sigmafine Library. The UOM is stored on the server and is same for all the databases. More UOMs can be added at any time.

  14. Select the file to import and click OK.

  15. Import the Library:

  16. In the navigation pane on the left, select Library.Figure 84: Navigation pane - select Library

  17. In the Library pane, right-click on the database name and select Import from File....Figure 85: Library - Import from File

    Alternatively, you can select File > Import from File... from the menu at the top of the window.

  18. Browse to and select the Sigmafine.xml (or SigmafineSI.xml) library file from Sigmafine\Library folder.

  19. Click OK to choose the file and close the window.

    The Import from File window opens.Figure 86: Library - Import from File window

  20. Ensure that the Import Options are selected as shown in Figure 86.

    Note: Sigmafine.xml defaults to units for North American standards, while SigmafineSI.xml defaults to units for SI standards.

  21. Click OK to import the Sigmafine Library in the selected server.

  22. Check-in the changes.

  23. While in the Library, select FileSave as Library... from the menu.Figure 87: Library - Save as Library

    The Save Database as Library window opens.

    Figure 88; Save Database as Library window

  24. In the Library Name box, type a name for the library.

    Saving the library is useful because it is saved on the Sigmafine server and can be used again when creating another database. The library is then

    available from the Load Library box in the Database Properties window.

    ClosedEXAMPLE: Database Properties - Load Library optionFigure 89: Database Properties - Load Library

    Also, when you need to load a library for an existing database, the File-Load Library option opens the "Load Library into Database" window where the saved library is displayed in the list of existing Sigmafine libraries.

    ClosedEXAMPLE: Load Library into Database - library optionFigure 90: Load Library into Database - library option

  25. Click OK to save the library and close the Save Database as Library window.

  26. Click OK to save the new database.

  27. (Optional) To set this new database as the Sigmafine Default Database for the server:

  28. Click on the Database to open the Select Database window.

  29. Click the Default Database option to set this database as the default.

  30. Click OK to save your selection and close the Select Database window.

Note: The Database templates have default units in the templates and some global settings that can be changed. For more information about changing the units of measure in templates, see the [Editing a Unit of Measure](/DocumentDepot/DocSFHub/docs_2026/docs-sf-system/SERVER-CLIENT/Model%20Building/UOM/edit-a-uom) topic under UOM.