Persistate

Installing and running the Persistate Viewer

Hide Navigation Pane

Installing and running the Persistate Viewer

Previous topic Next topic No directory for this topic  

Installing and running the Persistate Viewer

Previous topic Next topic Topic directory requires JavaScript JavaScript is required for the print function Mail us feedback on this topic!  

This walkthrough takes you through the installation, configuration and running of the Persistate Viewer.  This application is intended for workstations or client PCs, and allows you to run applications in a Persistate Server, viewing the user interface of the applications using this Viewer.

Caution

This walkthrough assumes that you have set up a Persistate Server, and have the DeviceNetwork package installed on it.  You can follow the Creating and running the Device Network demonstration walkthrough to create the package and the Installing and running the Persistate Server walkthrough to set up the server.

1.Download the PersistateViewer-.netN.N-v0.6.1.exe file from the Downloads page into a scratch folder.  There are three versions to choose from, where N.N is 2.0, 3.5 or 4.0.  Each version will run only Persistate packages created with the indicated version of the .Net framework, and must be used with the corresponding version of the Persistate Server.  If you followed the previous walkthroughs, choose the version corresponding to the Persistate Server you installed.  
2.Right click the downloaded file and select Install. Follow the on-screen prompts to install the Persistate Viewer.  You may get a prompt from Windows' UAC during this process.
3.Setup should have installed a new item on your start menu.  Use it to start the Viewer program.  The Select Server dialogue box is displayed.

Selecting the server

Selecting the server

4.The first time you start the Viewer, the drop down will be empty.  Subsequently, it remembers server names that you have previously entered.  Enter the name of the Persistate Server you want to connect to.  This should be just the host name, without any path or protocol definitions.  You can connect to a server running on the same machine without problems.  Click Ok.  The Persistate Viewer window is displayed.

The Persistate Viewer window

The Persistate Viewer window

5.Using the viewer is very simple.  Click on the environment that you want to run an application in.  The viewer displays the packages available in that environment.  Then simply click Run Package to start a session with that package.  For now, click the Production environment, and run the Device Network package.  After a few seconds, the package window will appear.
6.Switch back to the viewer window.  Click the Test environment, and now click Run Package to run the Device Network package in the test environment.  You now have two sessions both running the Device Network application, one in the production environment and one in the test environment.
7.Switch to the window running the Device Network in the test environment.  Click on the Device Types, Connector Types and Cable Types nodes.  Note that these show collections which are the same as those in the production environment.  This is because in the DeviceNetwork.per file, these classes are marked as configurative.  This means that the objects in these collections are saved and distributed with the deployed packages - in this case in the DeviceNetwork_Deploy.ser file that you imported into the server in the Installing and running the Persistate Server walkthrough.
8.Create some devices in each session.  Note that the objects created in one do not appear in the other, since they are in different environments.  In this case, the two environments are in different databases, but even if you had put them in the same database, they would still be entirely separate.
9.That's the end of this walkthrough.  If you want to try to create and run another package, you can try using the Library example shown in An Example Definition File, or there is a more extensive example definition file called Company.per available on the downloads page.