This project has moved. For the latest updates, please go here.

Setup package

For convenience, we've compiled a setup package to be used for running this test. Click the link below to download the package.

Wave Subscription Setup.zip (~8 MB)

 

Configure the openPG

Inside the setup package, there is a folder called "openPG Setup". Transfer that folder to the openPG server and run "Setup.exe" to install the openPG. Once the installation is complete, the Configuration Setup Utility will launch automatically. Please follow the Configuration Roadmap to properly configure the openPG for this test.


Configuration Roadmap.png
(~530 KB)

 

If you are using a system that is configured to use IPv6 by default (such as Windows 7 or Windows Server 2008), and you are trying to run this test over an IPv4 connection, then you will need to complete one extra step to make sure the data publisher knows to make connections over IPv4. If you do not need to do this, you can skip this step and move on to the next one.

Find the file called "openPG.exe.config" in the installation directory ("C:\Program Files\openPG" by default). Open that file in your favorite text editor and find the following setting.

 

<configuration>
    <categorizedSettings>
        <dataPublisher>
            <add name="ConfigurationString" value="port=6170" ... />
        </dataPublisher>
    </categorizedSettings>
</configuration>

 

Replace the value, "port=6170", with "port=6170; interface=0.0.0.0". When you're finished, the setting should look like the following.

 

<add name="ConfigurationString" value="port=6170; interface=0.0.0.0" ... />

 

Save the file, but don't close it yet since you'll be using it in the next step.

 

Update wave metadata

Once you've finished configuring the openPG, find the file called "openPG.exe.config" in the installation directory ("C:\Program Files\openPG" by default). Open that file in your favorite text editor and find the ConnectionString, DataProviderString, and NodeID settings.

<configuration>
    <categorizedSettings>
        <systemSettings>
            <add name="ConnectionString" ... />
            <add name="DataProviderString" ... />
            <add name="NodeID" ... />
        </systemSettings>
    </categorizedSettings>
</configuration>

These three settings must be copied to the same location in "UpdateWAVMetaData.exe.config", found in the "UpdateWAVMetaData" folder of the setup package that you downloaded earlier.

 

Also in "UpdateWAVMetaData.exe.config", you will find a "MusicDirectory" setting that looks like the following.

<add name="MusicDirectory" value="C:\Music" ... />

Replace the value, "C:\Music", with path to the directory containing the wave files you would like to stream.

Note: Until a "connect on demand" feature is implemented, the openPG will create and start one adapter per song in the directory you specify. Because the volume of measurements created by each adapter is so high, including a large number of songs in your music directory can place heavy strain on the server before it has even started streaming.

 

After you have updated the configuration file for the UpdateWAVMetaData application, transfer the "UpdateWAVMetaData" folder to your openPG server (if you haven't already) and run "UpdateWAVMetaData.exe" to complete the process.

 

Run the openPG service

  1. Go to "Start > Run...". (In more recent Windows operating systems, you can simply use the search bar in the Start Menu itself.)
  2. Type "services.msc" in the text box and press "Enter".
  3. Find "openPG" in the list, right-click it, and click "Start".

 

Run the subscription demo

There is one final folder in the setup package that you downloaded at the beginning of this walkthrough: "WavSubscriptionDemo". Transfer that folder to your client machine and run the "WavSubscriptionDemo.exe" application found inside. The first thing to do is go to "Tools > Options" in the menu bar. Once there, ensure that the "IPv6 Enabled" checkbox is set correctly (checked if you are using IPv6; unchecked if you are using IPv4).

 

Now close the Options window. At the bottom of the main window, there is a text box labeled Connection URI. The syntax is "hostname:port[?udp=port]" where the components are as follows.

  • hostname: This is the name or IP address of the openPG server streaming the wave data. If the client and server are running on the same machine, use the default "localhost" (though you may need to change it to "127.0.0.1" if you are using IPv4).
  • port: This is the remote port on which the openPG server's publisher is listening for connections. If you have updated the configuration file as mentioned above, the port should be the default "6170". Otherwise, it is whatever port you specified in your "openPG.exe.config" file.
  • udp=port: This setting is optional. If omitted, the server will stream the wave data over a TCP connection. Otherwise, it will broadcast the data over a UDP connection to the local port specified by this setting. The default is "udp=9500".

Once the Connection URI is set up correctly, press Enter or click the arrow button to connect to the openPG server. This will populate the song list. Pick out your favorite song from the list and click the green triangle to play it.

Last edited Jul 11, 2011 at 8:44 PM by staphen, version 16

Comments

No comments yet.