NMR HTTP Data Download Package

Transcription

1 NMR HTTP Data Download Package NielsenLocalOvernightsDataDownloadTool Installation Instructions Windows OS

2 Table of Contents Installing the NielsenLocalOvernightsDataDownloadTool... 3 Scheduling Automatic Data Downloads... 9 Appendix A: Stopping your Scheduled Tasks Appendix B: NLODDTool Configuration Screen Appendix C: Uninstalling NMRFTPScheduler and Axway Secure Client Appendix D: Java Installation Copyright 2014 The Nielsen Company. All rights reserved. Page 2 of 26

3 Installing the NielsenLocalOvernightsDataDownloadTool Note: If you currently have NMRFTPScheduler scheduled tasks, you MUST STOP those tasks before installing the NielsenLocalOvernightsDataDownloadTool. For instructions, go to Appendix A: Stopping your Scheduled Tasks section. Note: It is recommended not to have an existing Axway Secure Client software installation on the machine intended for use by the NMRFTPScheduler. Please uninstall the existing NMRFTPScheduler, for instructions, go to Appendix C: Uninstalling NMRFTPScheduler and Axway Secure Client section. 1. Go to log in, select NielsenLocalOvernightsDataDownloadTool_setup.exe and click Save on the File Download window. Click open folder containing file (the default location will be C:\Users\<Your ID>\Downloads). 2. Double Click the NielsenLocalOvernightsDataDownloadTool_setup.exe file, License text will be displayed, read the text and click Accept if you agree and to proceed with installation. Copyright 2014 The Nielsen Company. All rights reserved. Page 3 of 26

4 3. It will extract the files to C:\NielsenLocalOvernightsDataDownloadTool path, do not change the location. Click Install. 4. After Successful install it will verify the JRE version and if you do NOT have JRE (Java runtime environment) it will throw the below error message, Click Ok. You will be redirected to download Java. Follow the Oracle instruction displayed in screen while installing Java. Refer Appendix D: Java Installation section. After Successful Java installation, Open windows explorer (my computer) and navigate to the folder C:\NielsenLocalOvernightsDataDownloadTool and in that folder double click NielsenLocalOvernightsDownloader.exe file, it will open the configuration screen (follow next step). Copyright 2014 The Nielsen Company. All rights reserved. Page 4 of 26

5 -OR- If Java already installed in the system, and matches or higher than required version, it will open the configuration screen automatically (next step). 5. For the first execution it will open the configuration page (if required JRE available), or if you have executed NielsenLocalOvernightsDownloader.exe after installing Java. In this screen please provide/configure the details. 6. 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-level Arianna_Data folder MUST be on your C drive. It MUST NOT be a subfolder (subdirectory) of C:/NielsenLocalOvernightsDataDownloadTool folders. Temp Folder Create a Temp folder for the computer to use as a temporary storage area to unzip downloaded files. Note: Keep this Temp folder on the same computer as the NLODDTool 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: If the Config files reside on a computer other than the one with NLODDTool installed, you must enter the full network path, not just the drive mapping (for example: \\nyc_server\arianna_data\config). 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 NLODDTool installed, you must enter the full network path, not just the drive mapping (for example: \\nyc_server\arianna_data\evs). Copyright 2014 The Nielsen Company. All rights reserved. Page 5 of 26

6 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 NLODDTool 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. Also make sure all the path are not same. Now you are ready to set up your configuration. Note: If the Configuration window closed, and you haven t configured for first time, execute the NielsenLocalOvernightsDownloader.exe, if you had configured already and like to change, execute NielsenLocalOvernightsSettings.exe. 7. In the Configuration section of the NielsenLocalOvernightsDataDownloadTool 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 the proxy server name and port number, 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. Protocol: Keep the default HTTPS. Copyright 2014 The Nielsen Company. All rights reserved. Page 6 of 26

7 8. In the Path section, select the temp, PRI, EVS and Config directories. Tip: Browse to all folder locations using the browse 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. 9. After all paths have been selected, on the NielsenLocalOvernightsDataDownloadTool Configuration window, click Validate & Save to verify and save the configuration process. Copyright 2014 The Nielsen Company. All rights reserved. Page 7 of 26

8 Note: It should display Details were validated and saved successfully., if it throws any error, and if the details you have configured are correct, please contact your Nielsen representative. 10. Click OK, then click Close button in the configuration window. Then click Yes if you have configured all the details correctly. After configuration, DB and logs directories will be created automatically inside the NielsenLocalOvernightsDataDownloadTool directory. To schedule automatic data file downloads, go to the Scheduling Automatic Data Downloads section. Copyright 2014 The Nielsen Company. All rights reserved. Page 8 of 26

9 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-> All Programs- >Accessories-> System Tools->Task Scheduler Note: Task Scheduler services should be active to configure the job in Task Scheduler. Start-> Run-> services.msc The status of the Task Scheduler service should be started. Please reach out to your system Administrator for further assistance in enabling the service. Copyright 2014 The Nielsen Company. All rights reserved. Page 9 of 26

10 2. On the Task Scheduler window, in the Actions section, click Create Task. Or Right-click on Task Scheduler Library and select Create Task. The Create Task window appears with the General tab in focus. 3. On the General tab of the Create Task window, do the following: Name: Enter NielsenLocalOvernightsDataDownloadTool. Run whether user is logged on or not: Click to select this radio button. Run with highest privileges: Check the checkbox. 4. Select the Triggers tab. Copyright 2014 The Nielsen Company. All rights reserved. Page 10 of 26

11 5. On the Triggers tab, click New. The New Trigger window appears. 6. On the New Trigger window, do the following: Settings: Select Daily radio button. Repeat task every: Click to select the checkbox; and change the drop-down selection to 5 minutes. For duration of: Change the drop-down selection to Indefinitely. Expire: If the checkbox is checked, uncheck it. Click OK. The New Trigger window closes. The Create Task window with the Triggers tab is visible again. Copyright 2014 The Nielsen Company. All rights reserved. Page 11 of 26

12 7. On the Create Task window, select the Actions tab. 8. On the Actions tab, click New. The New Action window appears. 9. On the New Action window appears. Click Browse. The Open window appears. 10. On the Open window, go to C -> NielsenLocalOvernightsDataDownloadTool - > and select NielsenLocalOvernightsDownloader.exe. Click Open, the Open window closes and the New Action window becomes visible again with C:\NielsenLocalOvernightsDataDownloadTool \NielsenLocalOvernightsDownloader.exe in the program/script field. Note: In the Start in (optional) enter C:\NielsenLocalOvernightsDataDownloadTool\ that is the directory where the exe is available. Copyright 2014 The Nielsen Company. All rights reserved. Page 12 of 26

13 11. On the New Action window, click OK. The Create Task window becomes visible again. 12. On the Create Task window, select the Settings tab. Stop the task if it runs longer than: Uncheck the checkbox. Copyright 2014 The Nielsen Company. All rights reserved. Page 13 of 26

14 Keep all other default selections. Click OK. The Create Task window closes. Note: If the Task Scheduler password window appears, enter your username and password and click OK. The Create Task window closes and the Task Scheduler window becomes visible again. The NielsenLocalOvernightsDataDownloadTool task will display among your other scheduled tasks. 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 NielsenLocalOvernightsDataDownloadTool task you just created and select Run. The NLODDTool 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. Copyright 2014 The Nielsen Company. All rights reserved. Page 14 of 26

15 Appendix A: Stopping your Scheduled Tasks Before you install the NielsenLocalOvernightsDataDownloadTool, it is necessary to stop your scheduled tasks to prevent any scheduling and application conflicts. 1. Before installing an upgrade, go to Windows Start -> Control Panel -> System and Security -> Administrative Tools and double-click Task Scheduler. The Task Scheduler window appears. 2. On the Task Scheduler window, do the following: On the left side, click to expand the Task Scheduler Library. In the center section of the window, select NMRFTPScheduler. In the Selected Item section of the window, select Disable. Note: If the NMRFTPScheduler s status is running, wait for it to finish running/downloading or click End in the Selected Item section of the window to stop it. Then select Disable. The NMRFTPScheduler status changes from Ready to Disabled. Copyright 2014 The Nielsen Company. All rights reserved. Page 15 of 26

16 3. 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 7 Enterprise window, select Start Task Manager. Then select the Processes tab. If NMRFTPScheduler.exe is running, select it and click End Process. If STClient.exe is running, select it and click End Process. 4. Close the Windows Task Manager. Copyright 2014 The Nielsen Company. All rights reserved. Page 16 of 26

17 Appendix B: NLODDTool Configuration Screen This section describes how to change the configuration when needed. 1. Go to C:/NielsenLocalOvernightsDataDownloadTool/ directory and execute NielsenLocalOvernightsSettings.exe. 2. The configuration screen is opens, it pre-populate the fields with existing value. 3. After making changes in NielsenLocalOvernightsDataDownloadTool Configuration window, click Validate & Save to verify and save the configuration process. Copyright 2014 The Nielsen Company. All rights reserved. Page 17 of 26

18 Note: It should display Details were validated and saved successfully., if it throws any error, and if the details you have configured are correct, please contact your Nielsen team. 4. Click OK, then click Close button in the configuration window. Then click Yes if you have configured all the details correctly. Copyright 2014 The Nielsen Company. All rights reserved. Page 18 of 26

19 Appendix C: 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. 5. Go to the temporary folder which contained the components of NMRFTPScheduler.zip extracted initially during installation process. 6. Right-click on Uninstall_NMRFTPScheduler_Axway11.exe and select Run as Administrator. The Command window opens with this question: Are you sure you want to return the license? <y/n> 7. On the Command window, type y and press Enter. The Command window updates with the following: Your Secure Client license is successfully returned. The Axway Secure Client window opens with the Maintenance Mode window. Copyright 2014 The Nielsen Company. All rights reserved. Page 19 of 26

20 8. On the Maintenance Mode window, click Next. 9. On the Uninstall Notice window, uncheck Keep Configuration Files and click Uninstall. A status window displays the progress. Copyright 2014 The Nielsen Company. All rights reserved. Page 20 of 26

21 10. On the Uninstall Completed window, User can select option Yes, Restart my system or select option No, I will restart my system myself and click Done. The Command window and the Uninstall Completed windows close. The Axway Secure Client and NMRFTPScheduler software are uninstalled. Copyright 2014 The Nielsen Company. All rights reserved. Page 21 of 26

22 Appendix D: Java Installation This section describes how to install Java. You need Admin access to install Java 1. Go to C:/NielsenLocalOvernightsDataDownloadTool/ directory and execute NielsenLocalOvernightsDownloader.exe. If required Java version is not available it throws the message. 2. Click Ok, you will be redirected to java download page. 3. Click Agree and start free download button Copyright 2014 The Nielsen Company. All rights reserved. Page 22 of 26

23 4. In the file download popup window click Run 5. In the browser (Internet explorer) security warning, click Run 6. In the Java setup window click Install Copyright 2014 The Nielsen Company. All rights reserved. Page 23 of 26

24 7. Oracle Java offers few adds-on, un-checks the check box if you don t need. These are free adds-on and has nothing to do with NLODDownloadTool or Java. 8. Click Next it will start with Java installation. 9. Once the installation complete, it displays success message. Copyright 2014 The Nielsen Company. All rights reserved. Page 24 of 26

25 10. It redirects to check the new java version installed, it is just an additional check offered by Java, and you may proceed if you want to confirm whether latest version is installed. 11. Click Agree and continue, it will throw a confirmation message. 12. Click Yes it will request to run applet permission. Copyright 2014 The Nielsen Company. All rights reserved. Page 25 of 26

26 13. Click Run it will verify the Java version and display success message. 14. Once Java installation is complete, please execute the NielsenLocalOvernightsDownloader.exe to proceed further. Copyright 2014 The Nielsen Company. All rights reserved. Page 26 of 26