Skip to main content

Documentation Portal

PI Vision

Login

  1. Visit https://[THE URL]/PIVision/#/

    • Replace [THE URL] with the actual URL/domain on which PI Vision is installed. E.g. https://tm-pi2018.trendminer.net/PIVision/#/

  2. Login with the credentials for a domain user that has access to the server on which PI Vision is installed.

    PI_Vision_41.png

    Note

    The URL, domain and user will be different compared to this image

Make database visible

  1. Go to https://[THE URL]/PIVision/Admin and login

    • Replace [THE URL] with the actual URL/domain on which PI Vision is installed. E.g. https://tm-pi2018.trendminer.net/PIVision/Admin

  2. In the left panel, click on 'Configuration'.

  3. Choose the 'Asset Servers' tab.

    PI_Vision_42.png

  4. In the 'Databases' column, toggle on the databases you want to be visible in PI Vision and hit Save (bottom right).

    PI_Vision_43.png

  5. Visit https://[THE URL]/PIVision/ and login.

    • Replace [THE URL] with the actual URL/domain on which PI Vision is installed. E.g. https://tm-pi2018.trendminer.net/PIVision/

  6. Click on:

    PI_Vision_44.png

    in the top bar.

  7. In the left panel the database is now visible to use.

    PI_Vision_45.png
Re-index

In adding tags and attributes assets and attributes/tags got added to a database.

In Make database visiblethe database was made visible to use in PI Vision.

This indexed the assets and attributes/tags.

In the scenario where you decide to add more assets or attributes/tags to the database that has already been indexed, a re-indexing of the database is required.

  1. 1. Go to https://[THE URL]/piwebapi/admin/search/database.html and login.

    • Replace [THE URL] with the actual URL/domain on which PI Vision is installed. E.g. https://tm-pi2018.trendminer.net/piwebapi/admin/search/database.html

      PI_Vision_46.png

  2. Click on 'Rebuild Index' of the database and wait until it has a green check mark again, this can take a while.

    PI_Vision_47.png

    Note

    The AF elements did not change, because in this scenario I added 2 extra attribute/tags and 0 assets.

  3. Go to https://[THE URL]/PIVision and click:

    PI_Vision_48.png

    in the top bar.

    • Replace [THE URL] with the actual URL/domain on which PI Vision is installed. E.g. https://tm-pi2018.trendminer.net/PIVision

  4. Navigate in the database.

    PI_Vision_49.png

  5. Select the asset, this will now show the indexed attributes.

    PI_Vision_50.png
PI Vision & PI Web API & PI Web Crawler - Troubleshooting

In any of the following scenarios:

  • Able to see the database in PI Vision, unable to access PI Web API (Unauthorized).

  • Unable to see the database in PI Vision, able to access the database through PI Web API.

  • Re-indexing does not add assets and attributes/tags to PI Vision.

Use the following steps to make sure everything is configured correctly:

PI System Explorer - Attributes must be of type 'Configuration Item'

  1. Open PI System Explorer and drill down to the System Configuration in the left panel.

    PI_Vision_51.png
    PI_Vision_52.png

  2. Open the Attributes tab and check that all the attributes are a 'Configuration Item' in the right side panel.

    WRONG (Properties has the value '<None>')

    PI_Vision_53.png

    RIGHT (Properties has the value 'Configuration Item'.

    PI_Vision_54.png

Authorization

Normally the Authentication of PI Vision and the PI System Explorer are configured to use 'Windows Authentication' and 'Kerberos'. However, in a situation (like ours) where devices other than a Windows system need to authenticate, another option needs to be available. There are two options that would work. The first option is Basic Authentication and the other option is Anonymous Authentication. Because Anonymous Authentication does not require any credentials, it is preferred to use Basic Authentication.

Note

Windows Authentication + Kerberos is necessary for PI Vision and both the PI Web services to work properly. Never delete Kerberos as an authentication method.

IIS Manager - Verify Authentication settings

  1. Open IIS Manager and in the left panel drill down to 'Default Web Site' and double click on 'Authentication' in the right side.

    PI_Vision_55.png
    PI_Vision_56.png

  2. Verify that both Windows Authentication and Basic Authentication are Enabled.

    PI_Vision_57.png

    Note

    To set the status to 'Enabled', right click on 'Disabled' and click on 'Enabled'.

PI System Explorer - Verify Authentication settings

  1. Open PI System Explorer, drill down to the System Configuration in the left panel. Select the 'Attributes' tab.

    PI_Vision_58.png
    PI_Vision_59.png

  2. In the right side panel click on

    PI_Vision_60.png

    at the end of the 'Value' property.

    PI_Vision_61.png

  3. Verify that both Kerberos and Basic are in Values.

    PI_Vision_62.png

    Note

    Kerberos must always be in here!

    Note

    If Basic is not in here, click on 'Add' and change the Value in the field next to 'Value'.

    Note

    Check In your changes!

Verify user attached to PI Web Crawler and PI Web API service is a domain user

  1. Open Services.

    PI_Vision_63.png
    PI_Vision_64.png

  2. Verify that the user in the 'Log On As' column, is a Domain User, for both the PI Web Crawler as well as the PI Web API.

    1. Open up User Accounts and click on 'Manage User Accounts'.

      PI_Vision_65.png
      PI_Vision_66.png

    2. Confirm that the user has the following icon, this means it is a Domain User.

      PI_Vision_67.png

    Note

    The following image is the icon for a Local User:

    PI_Vision_68.png

    For this example, we can see that TRENDMINER\PIVisionService is the user attached to both the PI Web Crawler and PI Web API and that it is a Domain User.

    PI_Vision_69.png

    Alternative way is to open 'Edit local users and groups', click on 'Users' and confirm that the user (e.g. TRENDMINER\PIVisionService) is NOT in this list.

    PI_Vision_70.png
    PI_Vision_71.png

Verify the group of the domain user

The user attached to the services in ' Verify user attached to PI Web Crawler and PI Web API service is a domain user' needs to be in the correct group. Confirm this by:

  1. Open 'Edit local users and groups' and click on 'Groups'.

    PI_Vision_72.png
    PI_Vision_78.png

  2. Double click on 'PI Web API Admins' and confirm that the user is in the 'Members' list.

    PI_Vision_79.png

    Note

    If this is not the case, click on 'Add...', type in the name of the user and click on 'Check Names', then click 'OK'.

    PI_Vision_80.png

  3. Do step 2. for PI Vision Admins as well (not sure if necessary, but in the current configuration this is the case).

In this section: