NMR HTTP/FTP Data Download Package

NMR HTTP/FTP Data Download Package NMRFTPScheduler Installation Instructions Windows XP

NMRFTPScheduler Installation Instructions for Windows XP

Copyright © 2007-2012 The Nielsen Company of 36 NMRFTPScheduler_Install_Instructions_WindowsXP.docx

Table of Contents Installing the NMRFTPScheduler ...................................................................................... 3 Installing the Axway Secure Client .................................................................................... 8 Setting up your Configuration .......................................................................................... 11 Configuring and Testing your Connection ....................................................................... 14 Scheduling Automatic Data Downloads .......................................................................... 18 Appendix A: Stopping your Scheduled Tasks ................................................................. 24 Appendix B: Restarting your Scheduled Task ................................................................ 26 Appendix C: Configuring and Testing your Proxy Server Connection ............................ 28 Appendix D: Uninstalling NMRFTPScheduler and Axway Secure Client ....................... 34



Installing the NMRFTPScheduler Note: If you currently have NMRFTPScheduler scheduled tasks, you MUST STOP those tasks before installing or upgrading Axway software. For instructions, go to Appendix A: Stopping your Scheduled Tasks section.

To set up automatic scheduled downloads, you will need to have read/write permissions for your computer.

1. Go to https://odd.nielsenmedia.com, log in, select NMRFTPScheduler.zip and click Open on the File Download window. An NMRFTPScheduler folder window will open.

2. Click the Extract all files, use the Wizard to extract the files to a temporary location, and open the folder.

3. Double-click on Install.bat. The computer checks to see if the .NET Framework 1.1

runtime environment and Tumbleweed Secure Client or Axway Secure Client are installed.

The Windows\system32\cmd.exe (Command) window appears.

The window that displays with the Command window depends on the type of NMRFTPScheduler software currently installed, if any, on your computer, and determines your next steps.



4. Based on the additional window that opens with the Command window, do one of the following:

If you do NOT have .NET Framework 1.1 installed, the Microsoft .Net Framework 1.1 Setup window opens and the following message will appear in the Command window twice:

Error: The system was unable to find the specified registry key or value.

Go to step 5.

-OR-

If you have Tumbleweed Secure Transport Client and .NET Framework 1.1 installed, the NMRFTPScheduler uninstall wizard window displays with the Command window.

Go to step 8.

-OR-

If you have .NET Framework 1.1 installed but do NOT have either Tumbleweed Secure Transport Client, the Axway Secure Client Installing Secure Client window opens and the following message appears twice in the Command window:

Error: The system was unable to find the specified registry key or value.

Go to the Installing the Axway Secure Client section of this document to proceed.

5. If the .Net Framework 1.1 is needed, the following windows appear.



6. On the .Net Framework 1.1 Setup window, click Yes to proceed. The installation process starts with this window.

7. On the Microsoft .NET Framework 1.1 Setup window, select I agree and click Install.

During the installation the following window displays its progress. This process may take a few moments:

When the installation is complete, the following windows appear. Click OK.

The Command window updates, the Install Anywhere window appears, and the Axway Secure Client Installing Secure Client window opens.

Go to the Installing the Axway Secure Client section to proceed.



8. On the NMRFTPScheduler window, select Remove NMRFTPScheduler and click Finish.

A status window appears during the uninstall process.

9. After NMRFTPScheduler is uninstalled, the following window will appear. Click Close.

The SecureTransport Client – InstallShield Wizard window opens. Then the Confirm Uninstall window opens on top of it.



10. On the Confirm Uninstall window, click Yes.

11. On the Question window, click Yes to completely remove the contents of SecureTransportClient. This content is not needed anymore.

12. After uninstalling the SecureTransportClient, the following window will appear. Select No, I will restart my computer later and click Finish.

An Install Anywhere window appears again, and then the Axway Secure Client—Installing Secure Client window opens.

Go to Installing the Axway Secure Client section to proceed.



Installing the Axway Secure Client

1. On the Installing Secure Client window, click Next.

2. On the License Agreement window, Select I accept the terms of the License Agreement and click Next.

3. On the Installation Folder window, click Next.

Note: Axway Secure Client must be installed in the default location: C:\Program Files\Axway\SecureClient.



4. On the Java Virtual Machine window, with the default selection of Use the Java Virtual Machine installed with this application, click Next.

5. On the Scheduler Settings window, without making changes, click Next.

6. Select the Installation Summary window, click Install.



During the installation process, you will see the following window:

7. On the Installation Completed window, click Done.

Do not close the Command window.

In a few moments, the message “The system cannot find the path specified” appears in the Command window.

In another few moments, the “Your Secure Client License is now successfully activated” statement appears in the Command window.

Next, the Post Installation Configuration window appears.

Go to the Setting up your Configuration section to proceed.



Setting up your Configuration

This section includes creating the folders needed for your data and setting up your connection.

1. Before you enter information on the Post Installation Configuration window, create the needed folders in the location where you want to store your files using the following guidelines: Arianna_Data This is the upper-level folder in which the following folders will

be subfolders. (The following subfolder names must be Temp, Config, EVS, and PRI for the scheduler to work correctly.)

Note: This upper-lever “Arianna_Data” folder MUST be on your C drive. It MUST NOT be a subfolder (subdirectory) in either C:\Program Files\NMRFTPScheduler or C:\Program Files\Axway folders.

Temp Folder Create a Temp folder for the computer to use as a temporary storage

area to uncompress downloaded files. Note: Keep this Temp folder on the same computer as the Axway application, even if the data files will reside on a different computer.

Config Folder Create a Config folder for Arianna to use for synchronization of

configuration files. These files are required for Arianna to function properly (for example: LicKey.crp, MarketOrg.xml, Market.cfg), and will automatically be copied by the scheduler to subfolders in this folder. Note: Keep this Config folder on the same computer as the Axway application, even if the data files will reside on a different computer.

EVS Folder Create an EVS folder for Arianna to store the .evs (program names)

files. Note: If the EVS files reside on a computer other than the one with Axway installed, you must enter the full network path, not just the drive mapping (for example: \\nyc_server\arianna_data\evs).

PRI Folder Create a PRI folder for Arianna the .pri (viewing) files.

Note: If the EVS files reside on a computer other than the one with Axway installed, you must enter the full network path, not just the drive mapping (for example: \\nyc_server\arianna_data\evs).

Tip: The downloaded data files will go to the Temp folder first, where they will be unzipped and transferred to the Config, EVS, and PRI folders. Refer to these folders for your downloaded data files.

Now you are ready to set up your configuration.



Note: If the Post Installation Configuration window closed, reopen it by double-clicking on PostInstall.exe in the C:\Program Files\NMRFTPScheduler folder.

2. In the Connection section of the Post Installation Configuration window, enter

the needed information in the following fields:

Note: If you are using a proxy server, enter the proxy user name and password and proxy server name provided to you, and enter the user name, password, and server URL steps as described below.

User Name: Enter the user name assigned to you.

Password: Enter the password assigned to you.

Server URL: Keep the default URL, which is “odd.nielsenmedia.com.”



3. In the Directories section, the NMR Scheduler Folder and Axway Folder fields have automatically filled with the default locations on your C drive.

Tip: Browse to all folder locations using the ellipse button:

Local Temp: On the Browse For Folder window, select the Temp folder you created and click OK.

Config: On the Browse For Folder window, select the Config folder you

created and click OK.

EVS: On the Browse For Folder window, select the EVS folder you created and click OK.

PRI: On the Browse For Folder window, select the PRI folder you created and click OK.

4. After all paths have been selected, on the Post Installation Configuration window, click OK to finish the configuration process.

The Post Installation Configuration and the Command windows close. This part of the set up is complete.

To continue, go to the Configuring and Testing your Connection section.



Configuring and Testing your Connection This section explains how to configure and test your connection to ensure your data files will be downloaded as expected.

Note: If you are using a Proxy Server, go to Appendix B: Configuring and Testing your Proxy Server Connection for instructions.

1. To open the Axway Secure Client window, go to Windows Start -> Programs -> Axway Software -> Secure Client -> Start Secure Client.

2. On the next Axway Secure Client window, click Connect.

3. Depending on whether you need to create a new site “Alias” name or if you have

existing site Alias name, do one of the following:

If you do NOT have an existing site Alias, the Site details (new) window opens.

Go to step 4.

-OR-



If you have an existing site Alias name, the Select a site to connect window opens.

Go to step 7.

4. On the General tab of the Site details (new) window, enter the following information:

Alias: New Site (This is the default name—a system generated Alias number will occur during the testing.)

Protocol: Change the drop-down selection to HTTP.

Host: Type odd.nielsenmedia.com. Do not include “https://” as part of the address.

Port: Enter 443.

User: Anonymous is the default. Enter your assigned ID.

Password: Enter your assigned password.

Server type: Change drop-down selection to Secure Transport.

Version: Change drop-down selection to HTTP 1.1.

Identification method: Change drop-down selection to Basic.

5. Click to select the Security tab.



6. On the Security tab of the Site details (new) window, do the following:

Activate SSL security: Check the checkbox.

Check that server certificate common name matches host name: Check the checkbox.

If server has an unknown root certificate: Change drop-down selection to Accept Connection.

Click Save.

The Site details window closes and the Select a site to connect window opens.

7. On the Select a site to connect window, select your new or existing site, and click Connect.

The Select a site to connect window closes.



On the lower half of the Axway Secure Client window, the Log tab shows the status of your test connection. After you have successfully connected and run through the scripts, you will see a “Disconnect” log entry and map files appear in the New Site tab on the upper right side of the window.

8. To close Axway Secure Client, click the Windows Close button. Then on the Axway Secure Client window, select No, Stop Scheduler and Exit. The window closes.

To schedule automatic data file downloads, go to the Scheduling Automatic Data Downloads section.



Scheduling Automatic Data Downloads

This section describes how to set up your scheduled data file downloads.

Note: If you have an existing NMRFTPScheduler task, restart that task. For details, go to Appendix B: Restarting your Scheduled Task.

1. To set up your scheduled downloads, go to the Start -> Settings -> Control Panel and double-click Scheduled Tasks.

2. On the Scheduled Tasks window, double-click on the Add Scheduled Task icon. The Scheduled Task Wizard appears.

3. On the Schedule Task Wizard window, click Next.



4. On the next Scheduled Task Wizard window, click Browse.

5. On the Select Program to Schedule window, browse to the C:\Program Files\NMRFTPScheduler folder. Select RunNMRFTPScheduler.exe and click Open.

6. On the Scheduled Task Wizard first window, select Daily and click Next.



7. On the next Scheduled Task Wizard window, accept the defaults and click Next.

8. On the next Scheduled Task Wizard, enter your LAN ID and Password and click Next. Note: You must have read/write access to the data storage directories for this computer/server. If necessary, use your administrator ID and password.

9. On the next Scheduled Task Wizard window, click the checkbox for the Open advanced properties for this task when I click Finish field, and click Finish.



The RunNMRFTPScheduler window appears.

10. Click the Schedule tab and the Advanced button.

The Advanced Schedule Options window opens.



11. On the Advanced Schedule Options window, click the Repeat Task checkbox.

Set the Every field to run every 5 minutes.

Set the Duration field to 24 hours.

Click OK.

The Advanced Schedule Options window closes and the Schedule tab refreshes to show the scheduled times.



12. Click on the Settings tab, do the following:

Stop the task if it runs for 72 hours: Uncheck the checkbox for the field.

Click OK.

The window closes and your scheduled settings are complete.

13. To confirm your data files are downloading and transferring to their designated directories, do the following.

On the Task Scheduler window, right-click on the NMRFTPScheduler task you just created and select Run.

The NMRFTPScheduler connects to odd.nielsenmedia.com and downloads your data files.

Go to the Arianna_Data folder you created earlier. Check the Temp directory to see the downloading files as they unzip and move to the Config, EVS and PRI folders.

Note: It will take a few minutes to see the process working.



Appending A: Stopping your Scheduled Tasks

Before you install the Axway Secure Client upgrade, it is necessary to stop your scheduled tasks to prevent any scheduling and application conflicts. 1. Before installing an upgrade, go to Windows Start -> Settings -> Control Panel

-> and double-click on Scheduled Tasks icon.

2. To open the RunNMRFTPScheduler properties window, on the Scheduled Tasks window double-click on RunNMRFTPScheduler icon.

3. On the RunNMRFTPScheduler window, uncheck the checkbox for Enabled (scheduled task runs at specified time) and click OK. The RunNMRFTPScheduler window closes.



On the Scheduled Tasks window, the RunNMRFTPScheduler.job icon status changes from displaying a clock to displaying a red X and the job status shows Disabled.

4. Go to the Windows Task Manager to ensure NMRFTPScheduler.exe and STClient.exe

(Secure Transport) are not running:

Press Ctrl + Alt + Delete and on the Windows Security window, select Task Manager > Process tab.

If the NMRFTPScheduler.exe is running, select it and click End Process.

If STClient.exe is running, select it and click End Process.

5. Close the Windows Task Manager.

After you have finished installing the new NMRFTPScheduler, restart your scheduled task on the Scheduled Tasks window. For details, go to Appendix B: Restarting your Scheduled Task.



Appendix B: Restarting your Scheduled Task

If you had stopped your existing scheduler task using instructions in Appendix A: Stopping your Scheduled Tasks, use the following instructions to restart (enable) that existing task.

1. After installing an upgrade and testing the connection, go to Windows Start -> Settings -> Control Panel -> and double-click on Scheduled Tasks icon.

2. On the Scheduled Tasks window to open the RunNMRFTPScheduler properties window, double-click on RunNMRFTPScheduler icon.

3. On the RunNMRFTPScheduler window, check the checkbox for Enabled (scheduled task runs at specified time) and click OK. The RunNMRFTPScheduler window closes.



4. On the Scheduled Tasks window, the RunNMRFTPScheduler icon status changes from displaying a red X to displaying the schedule information.

5. Right-click on the RunNMRFTPScheduler task and select Run.

The NMRFTPScheduler connects to odd.nielsenmedia.com and downloads your data files.

6. Go to the Arianna_Data folder you created earlier. Check the Temp directory to see the downloading files as they unzip and move to the Config, EVS, and PRI folders.

Note: It will take a few minutes to see the process working.



Appendix C: Configuring and Testing your Proxy Server Connection This section explains how to configure and test your proxy connection to ensure your data files will be downloaded as expected.

1. To open the Secure Client window, go to Start -> Programs -> Axway Software -> Secure Client -> Start Secure Client to launch the application.

2. On the next Axway Secure Client window, click Connect.

3. On the Select a site to connect window, click New.

A Site details (new) window opens.



4. On the General tab of the Site details (new) window, enter the following information:

Alias: New Site (This is the default name—a system generated Alias number will occur during the testing.)

Protocol: Change drop-down selection to HTTP.

Host: Type odd.nielsenmedia.com. Do not include “https://” as part of the address.

Port: Enter 443.

User: Anonymous is the default. Enter your assigned ID.

Password: Enter your assigned password.

Server type: Change drop-down selection to Secure Transport.

Version: Change drop-down selection to HTTP 1.1.

Identification method: Change drop-down selection to Basic.

5. Click to select the Security tab.



6. On the Security tab of the Site details (new) window, do the following:

Activate SSL security: Check the checkbox.

Check that server certificate common name matches host name: Check the checkbox.

If server has an unknown root certificate: Change drop-down selection to Accept Connection.

Click on the <Proxy> Server icon:

The Proxies general preferences screen appears.

7. On the Proxies general preference window, click Add.

The Proxy window opens.



8. On the Proxy window, enter the needed information in the following fields:

Proxy name: Enter a proxy name (your choice—should match the name entered on the Post Install Configuration window).

Proxy type: Change drop-down selection to HTTP.

Ident. method: Change drop-down selection to Basic.

Server address: Enter the server ID.

Server port: 8080

User name: Enter the user name provided to you for the proxy.

User password: Enter the password provided to you for the proxy.

Click Save.

The proxy will be created and the Proxy general preferences window appears.

9. On the Proxies general preferences window, click OK.

The Security tab of the Site Details window comes into focus.



10. On the Security tab of the Site details window, select the proxy that you just created from the Server drop-down list, and click Save.

The Site details window closes. The Select a site to connect window opens.

11. On the Select a site to connect window, select your new site (Alias) click Connect.

The Select a site to connect window closes.

The Axway Secure Client Log window tracks the status of your test connection. See next page.



On the lower half of the Axway Secure Client window, the Log tab shows the status of your test connection. After you have successfully connected and run through the scripts, you will see a “Disconnect” log entry and map files appear in the New Site tab on the upper right side of the window.

9. To close Axway Secure Client, click the Windows Close button. Then on the Axway Secure Client window, select No, Stop Scheduler and Exit. The window closes.

To schedule automatic data file downloads, go to the Scheduling Automatic Data Downloads section.



Appendix D: Uninstalling NMRFTPScheduler and Axway Secure Client This section describes how to uninstall NMRFTPScheduler and Axway Secure Client software from your computer.

NOTE: If you currently have NMRFTPScheduler scheduled tasks, you MUST STOP those tasks before uninstalling NMRFTPScheduler and Axway Secure Client software. For instructions, go to Appendix A: Stopping your Scheduled Tasks section.

1. Go to the C:\Program Files\NMRFTPScheduler folder.

2. Double-click on Uninstall_NMRFTPScheduler_Axway11.exe. The Command window opens with this question:

Are you sure you want to return the license? <y/n>

3. On the Command window, type y and press Enter. The Command window updates

with the following:

Your Secure Client license is successfully returned.

And the Axway Secure Client 5.8.0 window opens with the Maintenance Mode window.



4. On the Maintenance Mode window, click Next.

5. On the Uninstall Notice window, uncheck Keep Configuration Files checkbox, and click Uninstall.

A status window displays the progress.



6. On the Uninstall Completed window, click Done.

The Command window and the Uninstall Completed windows close. The Axway Secure Client and NMRFTPScheduler software are uninstalled.

NMR HTTP/FTP Data Download Package

Documents

Transcript of NMR HTTP/FTP Data Download Package