Unified Architecture Training Compliance Test Tool (UACTT) Introduction to the UA CTT for Client...

Unified Architecture TrainingCompliance Test Tool (UACTT)

Introduction to the UA CTTfor Client Testing

Press SPACE to advance through the slides.

• Introduction

• Familiarization of User Interface

• Finding Help

• Test Tool Configuration

• Testing & Debugging

• Script Customization and Advanced Debugging

• Next Steps

UACTT Training - ClientContents

© 2012 OPC Foundation 3

UACTT Training - ClientIntroduction (1 of 3)

What is it? A specialized UA Server & Client (hybrid)

designed to test a UA Client for compliance.

Where is it? http://www.opcfoundation.org/ua/ctt

Who can get it? OPC Foundation Corporate Members

What is tested? UA Servers and/or UA Clients

Coverage? Most base/core services.

Several UA profiles, more coming soon…

Extensible? Yes, you can add your own tests.

Easy to use? Yes, once you’ve learned the basics.

4/19/2012

UACTT

Your UA Server

Your UA Client

You

http://www.opcfoundation.org/ua/ctt



4/19/2012

How it works: Each Service is tested manually to see:

a. if a service-call is made correctly

b. if the client handles valid responses correctly

c. if the client handles invalid responses correctly

Test authors? Compliance Working Group

Developers? Compliance Working Group

Can I help? Absolutely! We always need help creating test-

cases and test-scripts, and for testing.

Contact [email protected]

mailto:[email protected]



How do I pass? Your product must pass all tests in all selected

profiles and/or conformance units.

Am I Certified? Passing the UACTT does not mean you are certified

by the OPC Foundation. It means that your product is

ready for certification in a Test Lab.

CTT used in Lab? The Certification Test Labs use the same

version.

Use CTT When? The best time is during product development. All UA

products must pass the UACTT prior to release.

Additional Help: Complete help-documentation is provided with the

UACTT. Test-case documentation is also provided.

4/19/2012

© 2012 OPC Foundation

6

UACTT Training - ClientLaunching UACTT (1 of 1)

4/19/2012

Windows Vista/7:Start > All Programs > OPC Foundation >Unified Architecture > Compliance Test Tool > Compliance Test Tool (CTT)

Windows 8:Start > Compliance Test Tool (CTT)


UACTT Training - ClientFamiliarization (1 of 4)

4/19/2012

There are (by default) 3 “widgets” to the right:• Help: quick access to documentation• Objects: simple listing of UA object names• Object Properties: simple listing of properties and methods of the currently

selected object.



4/19/2012

There are (by default) 3 “widgets” to the left:• Profiles: A list of all UA Client Profiles.• Conformance Units: A list of all UA Client Conformance Units and of all test-scripts.• Library: An area where reusable script components are stored.



4/19/2012

There are (by default) 3 “widgets” at the bottom:• Results: a hierarchical audit-log of test activities and results.• Script Output: a verbose trace of test-script activity.• Trace: a generalized trace of UACTT activity.

UA Service calls are listed here

See the complete details of each Service call

request and response here



4/19/2012

The Client Trace widget contains a powerful Filter capability for selecting which UA calls to list in the trace.Checked services are displayed; unchecked are hidden (but still logged).


UACTT Training - ClientFinding Help (1 of 2)

4/19/2012

Complete documentation is available from the Contents option in the Help menu. Documentation includes a user-guide and other useful testing tips.


UACTT Training - ClientFinding Help (2 of 2)

4/19/2012

All test-cases used by the Lab are exported into HTML pages that are available with the UACTT. Test-case documentation can be launched from the main documentation or from the Help widget.

© 2012 OPC Foundation

13

Normally, a Client connects to a Server directly. When using the UACTT we must force the Client to connect to the CTT; the CTT will connect to the UA Server – as a proxy.

UACTT Training - ClientTest Tool Configuration (1 of 6)

Normal Client/Server relationship Using CTT as a Gateway

4/19/2012

UACTT

Your UA Server

Your UA Client

The CTT acts as a “pass through”

Your UA Server

Your UA Client

You

You


After launching the UACTT you must create a new Project. You must choose a Server or Client project type, and then specify the project name and save-location.

UACTT Training - ClientTest Tool Configuration (2 of 6)

4/19/2012

The newly created CTT project contains a copy of all test-scripts, script library, and a

certificate store.


We must configure the CTT to connect to the UA Server and also to expose an endpoint for the UA Client…

UACTT Training - ServerTest Tool Configuration (3 of 6)

4/19/2012

Step 3. Click the OK button.

Step 1. Enter the EndPoint URL for the UA Server you

want to consume data from.

Note: The Advanced folder contains settings that can be

ignored.

Step 2. Copy the “Endpoint URL” value and paste it into your Client.

Here’s a real-world setup using the OPC Foundation DataAccess sample Server & Client… (a) DA Client to CTT (Endpoint URL); (b) CTT to DA Server (Underlying Server URL).


4/19/2012 © 2012 OPC Foundation 16


Your Client will probably call FindServer or GetEndpoints and then bypass the CTT. To avoid this we must modify FindServers/GetEndpoints so all EndpointUrls’ point to the CTT.


4/19/2012

Step 1. Open (double-click) Start-FindServers-Intercept.js

from the Library

Step 2. Click Execute current script…

Step 3. In your UA Client: make your connection to the

UA CTT endpoint…

Step 4. The UA CTT will inject its own Endpoint into

FindServers and GetEndpoints


You UA Client should now be connected to your UA Server via the UA CTT…


4/19/2012


First, test a UA Client’s normal behavior, such as a Read operation and observe the behavior…

UACTT Training - ClientTesting & Debugging (1 of x)

4/19/2012

Step 1. Observe the natural “call” made

by the UA Client.

Step 2. Double-click a script to be used for testing…


Step 4. Invoke the Read operation in your UA Client and observe the

behavior of your UA Client.Here, the purple line indicates the UACTT has modified the original

server response (to force an error).

When ready to move onto the next UA Service call to test, you will probably need to clear the event handler to prevent further injections. Here’s how…

UACTT Training – ClientTesting & Debugging (2 of x)

Step 1. Double-click DetachHandlers.js…


Step 3. Open your next script (for testing) in the next

[applicable] conformance unit.


You can add your own scripts to a conformance unit! Here’s how…

UACTT Training - ClientScript Customization

4/19/2012


UACTT Training - ServerNext Steps…

Once your UA Client passes all applicable tests:

• Conduct Interoperability Testing

• Conduct Behavior Testing

• Conduct Resource-efficiency Testing

• Request Certification in the Test Lab:http://www.opcfoundation.org/Compliance-Certification/A1-Application.pdf

4/19/2012

This information is available in the

CTT Test-Cases help pages.

http://www.opcfoundation.org/Compliance-Certification/A1-Application.pdf

http://www.opcfoundation.org/Compliance-Certification/A1-Application.pdf

Download: www.opcfoundation.org/ua/ctt

Certification: www.opcfoundation.org/certification

Lab Testing: http://www.opcfoundation.org/lab/signup

Bug Tracker: www.opcfoundation.org/mantis

Contact: [email protected]

UACTT Training - ClientThe End!

http://www.opcfoundation.org/ua/ctt

http://www.opcfoundation.org/certification

http://www.opcfoundation.org/lab/signup

http://www.opcfoundation.org/lab/signup

http://www.opcfoundation.org/mantis

mailto:[email protected]

Unified Architecture Training Compliance Test Tool (UACTT) Introduction to the UA CTT for Client...

Documents

Transcript of Unified Architecture Training Compliance Test Tool (UACTT) Introduction to the UA CTT for Client...