Automate Connection Updates

Replace <PackageName> with the PackageName for the solution package you are configuring.

To Auto-update Connections:

1.

Install and start the Monitor.

2.

In a text editor, open projects\rtview-server\rtvservers.dat and add -properties:autoconnections at the end of the dataserver line.

3.

Open a command prompt and navigate to the rtvapm/sampleapps/propeditor directory. Follow the instructions in the README.txt file to configure the node application to connect to the Monitor.

4.

By default, all properties (including passwords) are sent to the rtvadmin servlet and on to Data Server in plain text. You can optionally encrypt that text. See Encrypt Property Text for details.

5.

Use the sample application to get a list of solution packages in your Data Server as follows:

node main.js -action=getSPs

6.

Use the sample application to get the list of available properties for a solution package as follows:

node main.js -action=getPropertyDescriptions -sp=<PackageName>

where <PackageName> is the abbreviated name for a solution package on the retrieved list.

7.

Create a json file containing the connections and other properties you would like to add. Note that the file contents must be valid json. See Design Notes below for details about json properties.

8.

Use the sample application to add the properties as follows:

node main.js -action=editProperties -filename=autoconnections -propstoadd=jsonadd.json

Note that the file name must match the -properties command line argument that you entered in rtvservers.dat. See Filenames for more information.

9.

Use the sample application to update or restart the data server. An update will apply connection properties. A restart is required to apply non-connection properties:

Node main.js -action=updatePropertiesOnServer

Or

Node main.js -action=restartServers

10.

Now that the initial connections have been added, you can delete or modify those connections as follows:

node main.js -action=editProperties -filename=autoconnections -propstoadd=jsonadd.json -propstoremove=jsondelete.json -merge=true

See Design Notes for more information.

Note: In this scenario it is possible that the automated property updates occur at the same time as someone is editing other properties in the Configuration Application. Since all properties files are re-read when you execute the updatePropertiesOnServer post, the properties saved by the Configuration Application are re-read as well. The Configuration Application might say that you need to restart servers when it isn't necessary.

To encrypt property text, proceed to Encrypt Property Text.