Home

4.1 PDF - Read the Docs

1. 6 01 7501 17532 Microsoft Text Treiber txt csv 6 01 601 1 632 Microsoft Visual FaxPro Driver 6 01 6629 01 Microsoft Visual FoxPro Treiber 6 01 6629 01 SQL Server 6 01 7601 17514 SQL Server Native Client 10 0 29 100 1600 01 SQL Server Native Client 11 0 2011 110 2100 60 An ODBC driver allows ODBC enabled programs to get information from Eb To install new drivers use the driver s setup 2 3 Download the Microsoft SQL Client Note The instructions here are provided for Microsoft SQL Server 2008 if are running on a later version of Microsoft SQL Server the latest drivers can be obtained from the Microsoft website The installation steps are the same The SQL Client is available from the Microsoft website from here _ http www microsoft com en us download details aspx id 16978 Download the appropriate package for the system being used 1 e 32bit 64bit and run the installer to install the client Once the client is installed restart your computer and check again from ODBC above to confirm that the client has been installed 2 3 Installing NADA using Microsoft SQL Server 15 nada Documentation Release 4 0 2 3 8 NADA Database configurations for SQLSRV Create a database and the user account to use with NADA beforehand The permissions need to include create alter tables indexes See the following reference from Microsoft for instructions on how to do this e Database http msdn microsoft com e
2. xsl xml mbstring e mysql or sqlsrv Note See section on PHP configurations for configuring your server for NADA 2 1 2 Web Server requirements Apache 2 x IS 6 7 x 2 1 3 Supported Databases MySQL 5 x Microsoft SQL Server with fulltext support 2 2 Installation 2 2 1 Download the latest NADA Download a copy of the NADA 4 software from the IHSN http ihsn org nada nada Documentation Release 4 0 Open and extract unzip the files to your local hard drive using an appropriate compression program If you do not already have such a compression program there are many open source compression programs available For Windows use the built in compression software wizard or alternatively the 7 ZIP File Manager which is a free compression program On Linux systems the same tasks can be achieved from the command line or once again through the use of a separate program Mac OSX has a number of options third party and built in as well as from the command line Name Date modified Type Size k application 6 16 2013 9 10 PM File folder cache 6 27 2013 11 31 A File folder datafiles 6 27 2013 10 01 A File folder files 6 16 2013 9 10PM File folder k Images 6 16 2013 9 10 PM File folder k imports 6 16 2013 913 PM File folder install 6 16 2013 9 14PM File folder k javascript 6 16 2013 9 11 PM File folder k logs 6 2 2013 11 31 A File folder modules 6 16 2013 9 14 PM Hle f
3. Add New Link ql Reorder Menu Menu Management All fields Batch actions Apply Showing 1 2 of 2 Title URL Type Published Modified Actions Data Catalog catalog S 03 22 2011 Edit Delete E Citations citations v 08 10 2010 Edit Delete Showing 1 2 of 2 To add a new page click on the Add New Page button Give the page a Title in the Title field Clicking in the URL field will automatically suggest a name for the page in the URL Enter the contents for the page in the Body section Plain text or HTML is accespted by this field Then indicate if the page should be published or not in the Publish dropdown The Weight field tells the NADA in what order this menu item should display E g 0 would be first 1 second and 2 third Click on Update to save the changes View the changes from the user interface In this Example a Contact Us page was created NADA Data Catalog Citations Contact Us Ea E tis also possible from the Menu Management screen to add a menu link that links to an existing page on another site rather than creating a page itself To change the order in which the menu items display on the user interface use the Reorder Menu button on the Menu Management screen Menu Management 4 9 Manage Site Pages and Menus 61 nada Documentation Release 4 0 4 10 The Site Settings Page All settings for the application are controlled via the Settings menu at the top of t
4. 27 nada Documentation Release 4 0 C localhost nada4 index php nada4 upgrade NADA 3 to 4 upgrade Please confirm vou have done the following steps before vou start the upgrade process Make a backup of your nada 3 database The upgrade script will modify your database and it will no longer work with the NADA 3 Make sure the nada database user account has access to create update delete alter database tables otherwise the script won t work Upgrade database to NADA 4 Take note of the warnings and make any necessary corrections before clicking the Upgrade database to NADA 4 button Warning This step makes changes to your nada 3 database that are not undo able so make sure you do make a database backup before this step Click on the Upgrade database to NADA 4 button and wait for the page to reload The output of the page will look something like below The script will print number of messages about failed table updates This does not mean the script failed to upgrade It just means some of the updates were not needed on your version of NADA 3 Different versions of NADA have different numbers of fields in the database and the upgrade script tries to fix the missing fields for all these different versions of NADA If the existing NADA 3 database already has that field then it reports it as an error You can ignore the error messages that include the wording Duplicate column name or Duplicate entry
5. import folder imports w Fold Select topic vocabulary CESSDA Topecs Classifications me Regional fitter 9 Enable Disable Topic filter Enable Disable Year Titer 9 Enable Disable Collection fitter Enable 4 1 Disable E s s Enable to view collection filter on front end Data access filter Enable 7 Disable 4 4 6 Transferring study ownership In the previous examples mention was made of studies uploaded to a catalog being owned by that catalog There may be cases where transferring the ownership from one catalog to another will be desirable This will become clearer in the next section on user roles but for now the next steps show how transferring ownership from one collection to another can be done Transferring ownership from one collection to another has to be done by the owner of the collection and from the collection it is currently owned by To transfer ownership Go to the Manage Studies screen and select the study to be transferred Open up the Edit Study page by clicking on the study Title On the right hand side of the screen click on the Transfer study owner link 4 4 Manage Collections 43 nada Documentation Release 4 0 Demographic and Health Survey 1992 Reference No NAM 1992 DHS v01 M Survey options Browse metadata Upload Year 1992 Link resources Country Namibia Transfer study owmer lt Publisher Ministry of Health and Soc
6. 7 Flagged 50 Chapter 4 User manual nada Documentation Release 4 0 4 8 Managing Users and account types Users in the NADA can be defined according to three broad groups General Users this is the normal user who registers on a NADA site from the user interface This user type has no access to the site administration It is required to register as a user before being granted access to public use and licensed data types Site Administrators unlimited this user has access to all functions and all collections within the Site Administra tion System wide access Limited Administrators these administrators have access to a limited set of functions within the Site Administra tion Examples would be an administrator of a specific collections or licensed survey reviewer for all or only some collections or report generator or citation manager etc 4 8 1 Creating User accounts User accounts can be created in two ways 1 A General User account can be created by a user directly from the register screen from the login link on the user interface of the application Login Email Address Password Register Forgot password AN Information you provide by registering or login to our catalog will be Ih the ter ms of the Woor Hank Privacy Policy used m compliance wi The user created by this process has no access to the site administration This account can only be used to apply and gain access to public and licensed
7. Verify the database upgrade Open the NADA catalog page by going to http your nada4 site index php catalog page and verify all studies from NADA 3 are listed 3 1 1 Linking your NADA 3 data files to NADA 4 The upgrade script has only upgraded the database It is now necessary to tell the NADA4 where to locate the datafiles that were uploaded to the original NADA 3 site There are two options available Option 1 Copy the datafiles folder from NADA 3 to NADA 4 This works best if you have only a few studies and the datafiles folder size is small enoughto be moved easily from one location to another Option 2 If it is not possible to easily move the datafiles folder from NADA 3 to NADA 4 you can tell NADA 4 the location of the datafiles without moving the files Here are the steps Use your NADA 3 administrator login credentials to login to your new NADA 4 site Click on Site administration in the top right corner of the screen Goto the Settings menu and click on the Settings sub menu Settings v Dashboard Settings Countries CENTRAL DATA CATALOG USERS Regions Catalog contains 1 studies 1 Active Vocabularies Owned 0 Published 0 0 Disabled Linked 1 Unpublished 0 Inactive never logged in e Under Site configurations expand the Survey Catalog Settings section 28 Chapter 3 Upgrading from previous versions nada Documentation Release 4 0 Update gt General site settings Language gt U
8. 1 The drivers are available from the Microsoft website http www microsoft com downloads en details aspx FamilyID 80e449 13 24b4 41 13 8807 caae6cf2ca05 2 Download the drivers and run the setup file 3 The setup file will extract a number of dll files to your PHP extension folder 4 Browse to the PHP extension folder E g c phpext Notice there are multiple dll files included all referencing _sqlsrv _ _52 nts wc dll S php salsre 52 ts vcB dll php sglsre 53 nts php sglsre 53 nts vc8 dll S php salsre 53 ts vcB dll S php salsre 53 ts vc8 dll 1 To find out which driver library is suitable for your version of PHP create a php file using a text editor like Notepad e g info php and place this code inside it lt php phpinfo 2 gt 2 Save the file and copy it to your web server root folder Open your web browser and type the location and name of the file e g info php into your browser URL The phpinfo function prints your PHP version and other configuration settings for PHP For Example localhost info php To select the right sqlsrv DLL you ll need to know The version of PHP E g 5 3 Which compiler is used e g either VC9 or VC6 Check whether Thread Safety is enabled or not 2 3 Installing NADA using Microsoft SQL Server 13 nada Documentation Release 4 0 Windows NT PR3O22058 1556 Ward 2011 10 46 06 Misual C 2008 Build Date
9. Compiler Thread Safety disabled 1 With the above values you would choose the file php_sqlsrv_53_nts_vc9 dll ts Thread safety nts Non thread safety 2 Once you know which dll file to use open the php ini file using a text editor and add the following entry at the end of your PHP INI file extension php sqlsrv 53 nts vc9 dll 3 Save your php ini file and restart your web server 2 3 6 Testing the SQLSRV drivers and SQL Client To make sure the driver extension is installed correctly Reload the phpinfo page and check if the extension SOLSRV is listed on the page sqisrv sar og Severity If the extension is not listed on the page recheck if the correct php ini file has been edited To locate the php ini file being used by PHP look at the output of the phpinfo page in the section shown below Configuration Windows File php ini Path Loaded FilesitPHPiphp ini Configuration File 14 Chapter 2 Installation guide nada Documentation Release 4 0 This step is only required if SQL Server is not on the same server as your web server To check if the SQL Client 15 already installed or not follow the steps below 1 Open Control Panel Administrative Tools on your server 2 Open ODBC and switch to the tab Drivers ODBC Data Source Administrator User DSN System DSN File DSN ODBC Drivers that are installed on your system Name Version Microsoft Text Driver ibd
10. with imap apt nhn with imap client with imap ssl fusr with jpeg dirziusr with kerberas with libdirzlibB4 with libexpat dirz usr with libxml dirz aptixmlz with libxml dirz aptixrn27 with mceryptzraptilibmmerypti vith mysalziusr with rmys gl sackezivarlibirmisalimwysgl sack with mwvsglizIusmbinimysgl contig with apenssl usr with apenssl dirz usr with pcre regex apt incre with pdo mysgql shared with pdo sqlitezshared with pgsql fusr with pic with nng dirziusr with pspell with snmp with tici optitid with xmlrpc with xprm diriusr with xsl lapticslti with zlib w ith zlib dirz usr Server Cli FastcGl disabled Configuration fusrlocaliib File php ini Path iusmacalitibiphp ini Configuration File Scan this dir Hone for additional Ani files Additional ini nane files parsed PHP API 20100412 PHP Extension 20100525 fend 220100525 Extension fend 20100525 NTS Extension Build PHP Extension APIZ0100525 NTs Build Thread Safety disabled Zend Signal disabled Handling a end Memory enabiec l anager Chapter 2 Installation guide nada Documentation Release 4 0 2 4 2 File upload limits By default PHP allows uploads of 2MB which could be a problem if you have large DDIs and external resource files To change the settings 1 2 Edit the php ini file in notepad and look for the setting uplo
11. 1 studies PUF with no data files 1 Active Owned 1 Published 1 0 Disabled Linked 0 Unpublished 0 0 Inactive never logged in 21 Anonymous users viewing the site CACHE FILES cache files were found F RECENTLY UPDATED STUDIES CENTRAL Popstan Multiple Indicators Cluster Survey 2010 Round 1 Today Menu link to the Dashboard Menu link to the Study Management pages submenus include Manage Studies Licensed requests and Manage Collections Menu link to the citations management pages Menu link to the User management pages submenus include All users Add user and Impersonate User Menu link to create menu pages for the site frontend Menu link to generate usage reports Menu Link to the settings pages submenus include Settings Coutries Regions and Vocabularies Useful navigation links submenus include Change Password Log out Catalog Home Data catalog Citations This section lists all collections in the catalog Within each collection a summary is given of the number of studies along with diagnostics related to the number of studies publishedunpublished missing questionnaires data access types set but with no data attached as well as some buttin links to Manage the collections studies users and a History of changes made to the collection Provides a summary of users registrations and number of users currently logged in Show how many pages are being cached on the site with a link to clear th
12. Collections are sub categories of the Central Data Catalog They allow administrators of a NADA instance to group studies into what can be thought of as sub catalogs of the Central Data Catalog This has a number of benefits both from the user and the administrator perspective From the users perspective being able to filter and view groups collections of studies that logically belong together makes finding what they are looking for easier From the administrators perspective the ability to create collections of studies that may logically belong together facilitates the ability to decentralize the management of each collection of studies to specific administrators for example collections can be managed by different departments in an institution NOTE The creation of collections will in general only be useful and necessary for large catalogs or for catalogs that desire more decentralized management of groups of studies by different departments STUDIES Studies are carried out to gather more knowledge about a subject Studies may gather information from a number of different sources in order to answer the questions asked The information gathered for a study will in the context of 33 nada Documentation Release 4 0 NADA catalogs usually come from either a census or a surveys It is therefore not uncommon to hear the terms survey and study used interchangeably when listening to people talk about their NADA catalog METADATA Metada
13. datasets 2 A user account can also be created by a Site Administrator To do this login as a Site Administrator Goto the site administration section of the application 4 8 Managing Users and account types 51 nada Documentation Release 4 0 Select Users Add user from the top menu Log in Email Address Password Register Forgot password Information you provide by registering or login to our catalog wil be used in compliance with the terms of the World Bank Privacy Policy Fill in the information for the user in the form and be sure to mark the account status as Active Then click the Create button 52 Chapter 4 User manual nada Documentation Release 4 0 Create new user account Username Health Licensed Email Address Health Licensed ihsn_org First Health Last Licensed Company IHSM Fhone 1234565789 Country United States ka Password Password Confirm User account status Active Blocked 4 8 sers and account types 53 nada Documentation Release 4 0 Note that the user always starts off as a General User with no access permissions to the Site Administration The user group column displays as empty for users with only general user accounts To see a list of all users in the system go to the Users All Users menu item at the top of the screen All users Dashboard Users user impersona
14. far right Preview ID Title Type Weight Status Actions DHS Health Surveys Internal Edit Delete Permissions Preview Health Surveys Health Surveys Collection Datasets Citations The Health Surveys collection aims to provide frequent high quality and timely health data needed by the decision makers when designing public health programs Health surveys provide useful information on health status and health consumption and their determinants Visit catalog The new collection now also shows in the collection list on the Central Catalog About page this is where the thumbnail and short description fields are displayed 4 4 Manage Collections 39 nada Documentation Release 4 0 Central Data Catalog Datasets Citations The Kenya National Bureau of Statistics Microdata Portal KeNADA A core mandate of the Kenya National Bureau of Statistics is the publication and dissemination of statistical information for public use The The Kenya National Bureau of Statistics Microdata Portal provides access to searchable information on census and survey data for Kenya This includes survey and census data produced by The Kenya National Bureau of Statistics KNBS as well as by other institutions Where appropriate the portal allows access to the data from these surveys In cases where the data are held in repositories outside the KNBS a link is provided to where the data may be obtained Visit catalog SPECIALIZED COLL
15. more restrictive access such as ones whose only function is as licensed survey reviewer or report generator or catalog reviewer or citation manager etc e Ensures that the correct level of permissions and access is assigned to users based on security policies within the institution Unlike previous versions of NADA not all users who have access to the Site Administration need have the level of access of an unlimited site administrator This limits security risks associated with having too many unlimited site administrators managing a site e Assists in assigning an appropriate data access type to data based on institutional distribution polices Makes it easier to explain more clearly to institutional managers what the capabilities of the NADA application are and to advise on how to best manage the allocation of responsibilities 4 2 Site Administration Overview TODO 4 3 The Dashboard After logging in to the Site Administration with administrator credentials the user is taken to the dashboard The Dashboard provides a quick glance summary for administrators to get an overall picture of what has been happen ing on the site as well as what pending tasks are outstanding for the administrator 4 2 Site Administration Overview 35 nada Documentation Release 4 0 o ER N A W 10 11 12 36 IPs 4 CENTRAL DATA CATALOG USERS Catalog contains
16. send email using PHP s MAIL function select the first option and don t fill in anything else If your organization has a mail server and has have a dedicated account that can be setup for NADA use the following settings Check the radio button Use SMTP Server 5 6 7 8 Enter the host name for the server Enter the port used by the server to send mail If required enter the user name used to send mail on the server Enter the password used to send mail on the server If the organization does not own a mail server a Gmail account can be configured to be used with NADA Check the radio button Use SMTP Server Host name ssl smtp googlemail com or ssl smtp gmail com SMTP port 465 Account username email address gmail com Account password password for the gmail account Test the email settings The quickest way to test if the email settings are working is to use the forgot password option from the user login page Click on forgot password 2 6 Email configurations 25 nada Documentation Release 4 0 Login NADA Data Catalog Citations 1 Ej SHARE gt Forgot password Forgot password Please enter your email address so we can send you an email to reset your password Email Address Submit e Enter the administrator or any other accounts email address Check to the email account the mail was sent to e f no mail is received the settings are wrong and ne
17. sw No records were found Click on the Add Study button and upload a DDI and RDF and all your resources as described in the earlier section Uploading a Study Add Study Health Surveys Dashboard Health Surveys Manage studies Manage Studies Health Surveys swiss No records were found Once study is added in this way it displays in the Manage Studies list Notice that the collection summary field shows that the study belongs to 15 Owned By the DHS collection this was the Short name defined in the example when the Health Surveys Collection was created Manage Studies Central Data Catalog swin Sort results by Country Title SurveyID Modified Showing 1 5 of 5 _ Batch actions Demographic and Health Survey 2003 ae South Africa 2003 2004 ID ZAF 2003 DHS v01 M Collection Modified on 07 01 2013 Edit Remove gt Demographic and Health Survey 1992 ERETCCEM Published Namibia 1992 10 NAM 1992 DHS v01 M Collection CENTRAL Modified on 07 01 2013 Edit Delete studies uploaded to collections will automatically be added to the Central Data Catalog in order to build a common search portal for all studies 4 4 Manage Collections 41 nada Documentation Release 4 0 4 4 4 Copying studies from one collection to another The second way to add a study to a collection is to Copy the study from another collection into
18. the new collection To copy study already in the catalog to display in the new collection first make sure to be in the Manage Studies section for the collection you want to put studies into To do this either use the Studies Manage studies menu on the top or simply click on the Switch link next to the Manage Studies Collection Title heading E Manage studies entral Data Catalog Health Su Manage studies Central Dala Catalog DHS Health Surveys 5 Manage studies IA Sod stut Eulk import DEM Licensed requests Dashboard gt Health Surveys gt Manage collections Manage Studies Health Surveys Sort results by miy Tite rey Modified Showing 1 1 of 1 Batch actions Apply Demographic and Health Survey 2003 O South Africa 2003 2004 iD ZAF 2003 DHS M Collection CB Modified on 07 01 2013 Edi Delete Select number of records to show per s Showing 1 1 of 1 Then Click on the Copy Studies blue button at the top right Manage studies Ig Add study Bulk import DDI 8 studies Licensed requests e A list of all studies available to copy to the new collection is listed Simply click on the Link button in green to copy the study to the collection The button will turn red and say Unlink To reverse the process and click the now red button Copy studies to Health Surveys Click on the Link or Unlink buttons to link or unlink studies A
19. 03 2004 unpublish Delete D ZAF 2003 DHS v4 M Collecion Modified on 07 01 2012 Edi Delete Demographic and Health Survey 1992 zo uw ID Nal 1992 DHS 101 M Collection Modified on 07 01 2013 Delete c Demographic and Health Survey 2000 o Namibia 2000 m ID NAM 2000 Collection CENTRAL Modified an 07 01 2013 Remove y raphi d Health Surv 2007 P ap C and Health Survey 2006 200 pending requests Namibia 2006 2007 ID NAM 2008 DHS 101 M Modified on 07 0172013 Edd Remove Select number of records to show per Showing 1 4 of 4 4 5 Manage Studies There are 2 Options to get studies into the new catalog 4 5 1 Option 1 The first is to upload a DDI and all its resources to the collection in the same way as described in the earlier section Uploading a Study Except instead of choosing Central Catalog chose the collection you want to upload the study to Click on the Add Study button and upload a DDI and RDF and all your resources as described in the earlier section Uploading a Study Once a study is added in this way it displays in the Manage Studies list Notice that the collection summary field shows that the study belongs to is Owned By the DHS collection this was the Short name defined in the example when the Health Surveys Collection was created Also note that the new study also appears in the Central Data Catalog studies uploaded to c
20. ECTIONS Health Surveys The Health Surveys Collection is a collection of all health surveys conducted by the Statistics Office as well as other data producers e Visiting the Dashboard will now also show the new collection listed below the Central Data Catalog With a number of green buttons as shortcut links to manage the studies on the collection assign administrators for the collection a history of activity on the collection and a link to edit the collection as in the steps above Dashboard CENTRAL DATA CATALOG Catalog contains 4 studies Owned 4 Published 4 Linked 0 Unpublished 0 Manage studies COLLECTION HEALTH SURVEYS PUF with no data files pending requests Collection contains 0 studies Owned 0 Published 0 Linked 0 Unpublished 0 Manage studies Edit collection 4 4 3 Manually adding studies to a collection There are 2 ways to get studies into the new catalog The first is to upload a DDI and all its resources to the collection in the same way as described in the earlier section Uploading a Study Except instead of choosing Central Catalog chose the collection you want to 40 Chapter 4 User manual nada Documentation Release 4 0 upload the study to Health Data Catalog Health Surveys Manage studies Licensed requests Dashboard Health Surveys Manage collections New catalogto manage Manage Studies Health Surveys
21. L DATA CATALOG USERS Catalog contains 5 studies PUF with no data files 3 Active Owned 3 Published 3 6 pending requests 0 Disabled Linked 2 Unpublished 0 Inactive never logged in 0 2 Anonymous users viewing the site 3 Logged in demo demo health licensed health reviewer CACHE FILES COLLECTION HEALTH SURVEYS You have 2 cached files click here to clear cache Collection contains 4 studies PUF with no data files Owned 2 Published 4 with no questionnaires RECENTLY UPDATED STUDIES Linked 2 Unpublished 0 DHS Demographic and Health Survey 2003 Yesterday DHS Demographic and Health Survey 1992 Yesterday CENTRAL Demographic and Health Survey 2000 Yesterday CENTRAL Demographic and Health Survey 2006 2007 Yesterday Popstan Multiple Indicators Cluster Survey 4 days CENTRAL 2010 Round 1 ago Note in the example above the account being impersonated is a Limited Account administrator with rights only to manage licensed requests for the Health Surveys Collection Note that all other dashboard menus are either hidden or clicking on any other function other than manage studies results in an access denied message This is a good way to test if the roles assigned to a user account have the expected results To exit the impersonate mode and return to the Site Administrator role Click on the top right menu and select Exit impersonate mode HEALTH LICENSED Health Surveys Exit impersonate mode Ma
22. Open the following NADA 4 URL in your browser http your nada 4 site index php admin catalog batch_refresh Select all studies Click on the Refresh DDI button 3 1 3 Transferring ownership NADA 4 has a collection management feature When studies are imported from the NADA3 catalog into NADA4 they are put into a collection called DEFAULT They need to be moved from this default system collection to the Central Data Catalog of the NADA4 To do this Go login to the Site Administration and navigate to the Studies Manage Studies Central Data Catalog page 3 1 Upgrade from NADA 3 29 nada Documentation Release 4 0 Studies Central Datg Manage studies Manage studies Add study m Licensed requests Dashboard gt Central Data Catala Manage collections Manage Studies Central Data Catalog gt Sort results by Country Title SurveylD Modified Showing 1 1 of 1 Transfer owner v Popstan Multiple Indicators Cluster Survey 2010 Round 1 O Namibia 2010 y Seer ID NAM 2010 POP v01 Collection CENTRAL Modified on 06 28 2013 Edit Delete Select number of records to show per 5 vw Showing 1 1 of 1 Select all the studies by ticking the check boxes next to each study on the right Click on the dropdown menu and select Transfer owner Central Dati Manage studies Manage studies Add siud Bulk im Licensed requests Dash
23. act FAG Terms 2014 Google all rights reserved 7 Click on enable globel key for all domain 8 Click on Create Key button 9 Copy public key and private key from Google Captcha website and inserte it on line number 51 and 52 respec tively as shown in below image 47 48 Sconfig recap 49 Sconfig recantch 50 51 52 53 Scontfig recankt 24 Sconfig recapt 10 To check the Google catpcha configuration go to register page and look for image as shown in below URL highlighted in Red suqare 2 5 Configure Captcha 23 nada Documentation Release 4 0 User Registration First Last Email Address Country Password Password Confirm Privacy amp Terms Register Cancel 2 6 Email configurations For the NADA to function correctly it is important that this step be completed Many of the functions within the NADA such as registration and applying for access to datasets require that the NADA be able to send emails to users 1 Login to your NADA as an administrator 2 Go to Site administration click on the Settings menu and choose Settings 24 Chapter 2 Installation guide nada Documentation Release 4 0 C Find the section SMTP settings 4 SMTP settings Protocol for sending emails O Use PHP s builtin mail Use SMTP Server Host name SMTP port Account username Account password If the PHP web server is configured to
24. ad_max_filesize The line should look like Maximum allowed size for uploaded files httpi php net upload max filesize upload max filesize 2M Change it to the required file upload limit per your needs upload max filesize 50M There is another setting that MUST be changed as well for the file upload limits to work Look for the configu ration post max size and change it to match the value for upload max filesize post max size 50M 2 4 3 TimeZone settings This is for setting the timezone for your application To findout what is the correct timezone for your website go to http php net manual en timezones php and find your country city Example date timezone America New York 2 4 4 Increase page execution timeout This setting controls the maximum execution time of a page in seconds max execution time 300 2 4 5 Increase PHP memory limit It controls the memory available to PHP scripts memory limit 128M 2 4 6 Enable disable PHP extensions NADA requires the following PHP extensions xsl mbstring mysql or sqlsrv To enable XSL extension add this line 2 4 PHP settings 21 nada Documentation Release 4 0 extension php xsl dll To enable mbstring extension php mbstring dll 2 5 Configure Captcha By default NADA version 4 1 comes with image captcha and user does not need to make any changes to use image captcha To use Google Captcha please follow the steps
25. assword Confirm Congratulations Launch the new site 18 Chapter 2 Installation guide nada Documentation Release 4 0 NADA Installer Installation completed The application installation has completed the summary of the tasks 15 below Task Status Database adl i Tables v mE d Click here to launch the website 2 4 PHP settings 2 4 1 Finding the correct PHP INI To make sure you are editing the correct PHP INI settings file create a PHP file e g info php in your nada website folder with the following contents lt php phpinfo 2 gt Open the phpinfo page in your web browser and you should see output similar to below screenshot Edit the php ini file displayed by the setting Loaded Configuration File 2 4 PHP settings 19 nada Documentation Release 4 0 PHP Version 5 4 10 Linux Ivivdevwhbdns com 2 6 32 042stab059 7 1 SMP Tue Jul 24 19 12 01 MSK 2012 xBB B4 Build Date Jan 15 2013 15 24 03 Icanfigure enable bemath enable calendar enable exif enable ftp enable qd native tf enable intl enable libxml enable mbstring enable pdo shared anahle saap 5 enable w ddx enable zip prefixeiusrmlacal with apxs with bzz with curlerapticurlssl with curlwrappers Wwith enchantfusr with freetype dirz usr with gd with dqettext with icu dirfusr
26. assword to match the database user name and password 2 Optional change the database name to use another name 3 Save the file Sdb default Il username Sdb default password Sdb default database your database username your database password nada4 Note Do NOT use the root username and password MySQL or SA Account MSSQL on your production server Create a separate user name and password for your NADA database This can be done either from your Cpanel or from PhpMyadmin MySQL Workbench Chapter 2 Installation guide nada Documentation Release 4 0 2 2 5 Create database user account The goal being to avoid using Root for your NADA configuration 1 From the command line type mysql u root p 2 Enter your root password you setup when installing MySQL 3 Now create a database for the NADA in this example we call the database nada mysql CREATE DATABASE nada 4 Now create a user who can access the new nada database and give the user only the rights necessary to run the NADA mysql GRANT SELECT INSERT UPDATE DELETE CREATE DROP INDEX ALTER CREATE TEMPORARY TABLES 5 yourpassword can be anything you choose nada is the name of the database the user gets access to local host is the location which gets access to your database Note Remember this password you will need it to configure your NADA installer 6 Then exit MySQL console by typin
27. board gt Central Data Catala Manage Collections Select transfer studies from dropdown Studies Central Data Catalog s AM Sort by 1g Transfer ownt w Apply 7 2 E Popstan Multiple Indicators Cluster Survey 2010 Round 1 Select studs ME Namibia 2010 ID NAM NSA 2010 POP v01 Collection Modified on Edit Delete Select number of records to show per s From the Transfer study owner page Select Central Data Catalog and then click transfer 30 Chapter 3 Upgrading from previous versions nada Documentation Release 4 0 Transfer study owner Select the collection from the list below to transfer ownership to another collection Select collection SELECT EA Studies that will be transferred Popstan Multiple Indicators Cluster Survey 2010 Round 1 Cancel 3 1 4 Updating the Site theme template You cannot use your NADA3 template in NADA4 without making some changes Here are general guidelines but steps may differ depending on your nada site template 3 2 Copy your NADA3 template to the NADA4 themes folder Edit the nada4 root config template php following the steps below Look for the setting by default it is set to wb Change wb to the theme name you want to use Theme is the folder name you copied to NADAA themes your site theme from your nada3 site Save the file NB The templat
28. cel To change this user to a full site administrator who will have full system wide access to all parts and functions of the NADA administration select the Site administrators full access option and tick the admin box as well Click update to save the changes 54 Chapter 4 User manual nada Documentation Release 4 0 Edit user permissions Health Licensed Site level permissions 0 General user accounts no admin access General site users with no access to site administration Site administrators full access Full control over all site sections admin It is the site administrator and has access to all site content Site administrators limited access Limit user access to the site administration and control permissions per collection for the user Cancel 4 8 3 Collection level administrators To create a user who only has permissions to administer studies or administration functions for a particular collection Select Site administrators limited access 4 8 Managing Users and account types 55 nada Documentation Release 4 0 Edit user permissions Health Licensed Site level permissions C General user accounts no admin access General site users with no access to site administration Site administrators full access Full control over all site sections Site administrators limited access Limit user access to the site administration and control permissions per collection for the us
29. ction and choose the desired language Click update to save and apply the setting Site Configurations Update General site settings Language arabec chinese y Edit EL Use HTML Editor for HTML rice ddp english rrecrodata Survey catalog settings french mongolian P a russia Site login spanish SMTP settings Dashboard 4 10 The Site Settings Page 63 nada Documentation Release 4 0 Enable or disable the HTML editor A basic HTML editor is provided in the menu and page creating section of the application This setting allows this to be turned on or off Use HTML Editor for HTML editing Use HTML editor Yes No Survey catalog settings Survey catalog settings e Catalog folder datafiles w This folder is for storing DDI and related files 2 DDI import folder imports w Folder fo look for DDI files for import rig im DL 9 select topic vocabulary CESSDA Topics Classifications Select vocabulary to use for Topics classification Regional filter Enable Disable 2 Topic filter Enable Disable Year filter w Enable Disable Collection filter 9 Enable Disable gh Data access filter Enable 9 Disable Weights control the order of the filters Filters are sorted by weights in ascending order Data access filter 2 Regional fitter 3 HIE Topic filter Year fitter 1 Collection filter Catalog search page size 15 Number of records to show on he catalog search 1 This is the
30. e cache if need be Show a list of recently added or updated studies Clicking on a study in the list takes you to the page to manage that study Chapter 4 User manual nada Documentation Release 4 0 4 4 Manage Collections 4 4 1 Collections Collections are sub categories of the Central Data Catalog They allow administrators of a NADA instance to group studies into what can be thought of as sub catalogs of the Central Data Catalog Collections provide a number of benefits both from the user and the administrator perspective From the users per spective being able to filter and view groups collections of studies that logically belong together makes finding what they are looking for easier From the administrators perspective the ability to create collections of studies that may logically belong together facilitates the ability to decentralize the management of each collection of studies to specific administrators for example collections can be managed by different departments in an institution Note The creation of collections will in general only be useful and necessary for large catalogs or for catalogs that desire more decentralized management of groups of studies by different departments 4 4 2 Creating collections Login to the Site administration using an administrator password Collections are managed and created by going to the Studies Manage collections menu link Studies Central Dat Manage stud
31. e form and then at the bottom of the screen click on Attach studies to link the citation to a particular study in the catalog Import Citations Select citation import format BibTex Paste citation text zrapresentative household survey Aurthorwe Fetrtifor Audrey E and Rees Helen V and Kleinschmidr immo and 3tceffsnson Annie E and Macbhail Paste BibTex Catherine and Hlongwa Madikizela Lindiwe and Vermaak Kerry and Padian Nancy 5 meta Pa Ph jeoeurnalmw Aaidsa gt veolumem 1981 numbsrm 14 pagese 1525 1534 y 12 205 Publish Publish citation s Publish v Flag citation s as Related studies Title Country year Demographic and Health Sunvey 2003 South Africa 2003 2004 Select Studies ________ Allach 5 lt Submit Cancel The citation now appears in the citation list as well as on the study information page for the relevant studies Citations All fields Search Batch actions v Showing 1 1 of 1 Modified Title Date Published Created Actions 5 Young people s sexual health in South Africa HIV prevalence and sexual behaviors from a nationally 2005 y 07 02 2013 07 02 2013 Edit Delete representative household survey Journal Article Select number of records to show per 5 Showing 1 1 of 1 amp Owner name Related studies are attached No related studies are attached Entry has notes
32. e may need some adjusting to run properly on the new NADA 4 site This will involve editing the layout php and other template files within the template folder which is now located in the NADA 4 themes folder Migrate MySQL to Microsoft SQL TODO 3 2 Migrate MySQL to Microsoft SQL 31 Documentation Release 4 0 32 Chapter 3 Upgrading from previous versions 4 User manual 4 1 Overview and core concepts 4 1 1 About NADA NADA is a web based cataloging application that allows for the creation of portals that allows users to browse search compare apply for access and download relevant census or survey information It was originally developed to support the establishment of national survey data archives The application is used by a diverse and growing number of national regional and international organizations NADA as with other HSN tools uses the Data Documentation Initiative DDI XML based international metadata standard 4 1 2 Concepts CENTRAL DATA CATALOG The default catalog created when a NADA instance is installed is the Central Data Catalog All studies uploaded to the NADA are visible searchable and accessible from the Central Data Catalog For many institutions the Central Data Catalog will remain the only catalog in their NADA instance For some institutions being able to divide the contents of the Central Data Catalog into more refined collections will be desirable COLLECTIONS
33. ed to be corrected 26 Chapter 2 Installation guide 31 Upgrade from NADA 3 CHAPTER 3 Upgrading from previous versions For users with an existing NADA 3 x catalog an upgrade script is included that will update your NADA 3 x database to NADA 4 x The process involves modifying your NADA 3 x database and thus carries some risks The script will add new tables to the NADA 3 x database All user accounts and survey information will be retained by the upgrade Important Backup the NADA 3 x database before doing anything 1 Follow the instructions on page 4 and set up a folder in the web root containing the NADA 4 files 2 Edit the database php file as instructed in the section above NADA database configurations for MySQL 3 Instead of entering a new database name user account name and password fill in the details of the existing NADA 3 x database Note These can be found by looking at the existing NADA 3 x database php file and entering the settings into the NADA 4 database php file Sdb default Sdb default Sdb detault Sdb default Sdb default 4 Save the file t password t database dbdriver localhost NADAS database username NADA3 database password NADA3 database name mysql 5 Navigate to the URL for NADA4 site Example http your nada site nada4 index php nada4_upgrade 6 The following page loads
34. een defined then it is recommended to disable this filter Enable or disable the Data access filter on the user interface search page here This filter is not needed if there are very few studies in the catalog or if all studies hare set to the same access type This section controls the order in which the filters appear on the search page Enter numbers here that rank the order of the filters in the order they should be displayed This setting determines how many studies are displayed by default to the user on the search page catalog view Site Login settings i i 1 2A 3 4 10 Site login Password protected website Requires all users t login t access the website Login is not required to view the site Login timeout in minutes 40 Minimum password length To require that users login before being able to access the website set this option to Requires all users to login to access the website Determined how long a user will stay logged in After this time the user will be automatically logged out Sets the minimum length for passwords created by the users at registration or for manual user creation The Site Settings Page 65 nada Documentation Release 4 0 SMTP Settings SMTP settings Protocol for sending emails Use PHP s builtin mail Use SMTP Server Host name ihsn org SMTP port 25 Account usermame nada ihsn org l Account password __________ If the PHP web server
35. ensions Extensions xsl xml simplexml gd optional Zip options mbstnng optional mysql Other PHP INI Settings Setting Value Recommended fil amp uplaads Enabled Enabled post max size aM 20M upload max Blesize 2M 15M date timezone Europe Berkn See how to configure and select the nght timezone Folder READ WRITE DELETE permissions Folder Read Write Catalog daisies Cache Log gu Enabled v V 4 84 4 4 4 Server information Check must be PHP 5 34 Required PHP extensions must be loaded on the server mbstring is needed for the pdf generator and the library for the mail Captcha Recommended settings These folders must have read write permissions Check that all settings are marked with a green tick and fix any that are not on your webserver before running the installer Click on the Install Database button and complete the form to create an initial Site Administrator account Note Create a complex password of atleast 12 characters long with some uppercase punctuation and numbers to aid security of your site Do not forget this username and password 2 3 Installing NADA using Microsoft SQL Server 17 Documentation Release 4 0 NADA Installer Create administrator account First Last Email Address Com Country E Y Password Pp P
36. er E Collection administrators Users can manage and review studies for collections they are assigned to Report viewer Can only generate view reports E Citation manager has full control over the citations Global Licensed Reviewer This account can review licensed data requests from all collections Cancel t is then necessary to assign a role to this new limited administrator account To create a limited access ad ministrator for a particular collection select Site administrators limited access and then select Collection administrators Notice The form expands to reveal a list of collections in the system Select the appropriate level of access that this account will have for this collection In the example below administrator is being created who can manage only licensed requests for the collection Health Surveys This account will not be able to upload or publish studies The account will only be able to process licensed requests for the collection Health Surveys 56 Chapter 4 User manual nada Documentation Release 4 0 Site administrators limited access Limit user access to the site administration and control permissions per collection for the user Collection administrators Users can manage and review studies for collections they are assigned to Report viewer Can only generate view reports Citation manager has full control over the citations E Global Licensed Reviewer Thi
37. fault installation of SQL Server does not include the Full Text engine so before continuing on to installing NADA please make sure you have full text installed on your database server 2 3 3 Download drivers Microsoft provides two versions of the SOLSRV drivers namely version 2 0 and 3 0 NADA has only been tested with version 2 0 but should work with version 3 0 Requirements for using the drivers Windows 7 Windows Server 2008 R2 Windows Server 2008 Service Pack 2 Windows Vista Service Pack 2 PHP 5 3 6 or PHP 5 4 For information about downloading and installing PHP visit PHP on Windows http windows php net Microsoft SQL Server 2012 Native Client available in the SQL Server 2012 Feature Pack This is needed if database and web server are on different machines Any edition of SQL Server 2005 or later 12 Chapter 2 Installation guide nada Documentation Release 4 0 2 3 4 The Microsoft SQL Client Microsoft SQL Client is required for connecting to your SQL database using NADA The client is installed automati cally if your database is hosted on the same machine as your web server If your SQL database is running on a different machine then you must install the latest version of the SQL Client on your web server to ensure NADA can connect to your database See section on installing Microsoft SQL Client 2 3 5 How to install the SQLSRV driver for PHP The steps are for version 2 0 but the same applies to version 3 0
38. folder where the files for the study are stored on the server This includes the DDI eternal resources and data files This folder can be moved to a location outside the web root as described in the installation instructions in Chapter 1 Enter either relative or absolute paths to the folder location 2 This is the folder where DDI s can be placed in order to use the bulk study import function in the NADA In files had to be physically copied to this folder on the server but this 15 no longer necessary in NADA 4 Files can now be directly uploaded to this folder from the Site Administration Manage Studies page page 64 Chapter 4 User manual 10 nada Documentation Release 4 0 Select the vocabulary to use for the topic filter By default this is set to the CESSDA classification as recom mended in the IHSN templates supplied at IHSN org for the Nesstar Metadata Publisher Enable or disable the Country filter on the user interface search page here If the catalog only contains studies for one country then turning this filter off is recommended Enable or disable the Topic filter on the user interface search page here If no topics have been defined in the DDI s being uploaded then it is recommended to turn this filter off disable Enable or disable the Year filter on the user interface search page here Enable or disable the Collection filter on the user interface search page here If no collections have b
39. g exit mysql exit 2 2 6 Running the installer Open web browser to the location of the NADA installation For example http your domain nada folder name or localhost nada folder name nada Documentation Release 4 0 gt 0 localhost nada4 index php install NADA Installer URLof NADA 4 folder Server information PHP version 547 DB version Web server Required PHP Extensions Extensions xal xml simplexml gd optional Zip options mbstnng omenal mysql Other PHP INI Settings Setting Value fil amp uplaads Enabled post max size eM upload max Blesize 2M date timezone Europe Berkn 5 5 27 connection was successfull Apache 2 4 3 Win32 Open ssSL T 0 1c PHPI amp 4 7 Recommended Enabled 20M 15M See how to configure and select the nght timezone Folder READ WRITE DELETE permissions Folder Calalag data fies Cache cache Leg ELS Server information Check must be PHP 5 34 Enabled Required extensions must be loaded on the server mbstring is needed for the pdf generator and the library for the mail Captcha V 4 84 4 4 4 Recommended settings Read Write Delete ad ad d dd These folders must have read write permissions Check that all settings are marked with a green tick and fix any that are not on your webserver before running the installer Click on the Install Database button and complete t
40. given below Open application config captcha php in editor 2 Change line number 12 as shown in below image NADA 4 Login Email Address Password Log in Register Forgot password Information you provide by registering or login to our catalog will be used in compliance with the terms of the World Bank Privacy Policy 3 Click on above URL to generate Public and Private key URL http www google com recaptcha whyrecaptcha 4 Click on sign up now 5 Sign in using your Gmail account 6 After signed in you will have to enter your URL Domain URL 22 Chapter 2 Installation guide nada Documentation Release 4 0 Re CAPTCHA HOME gt WHAT 15 reCAPTCHA gt GET reCAPTCHA MY ACCOUNT MY SITES gt EMAIL PROTECTION gt RESOURCES Create a reCAPTCHA key Jg TECBSpICTHT zm this key on all domains global key Tips By default your reCAPTCHA key is restricted to the specified domain and any subdomains for additional security key for foo com works an testfoo com fyou wish to use your key across large number of domains 8 g if you are a hosting provider OEM etc select the global key option You may wantto use a descriptive domain such as global key mycompany com If you own multiple domain names foocars com and footrucks com you can sign up multiple keys or use a global key Create Key Bloq About Us Cont
41. h consumption and their determinants Thumbnail Provide thumbnail path E D files icon blank png OR upload a thumbnail file gif png jpq Choose File dhs icon jpg Weight Select collection type section Published intemal Specialized Collections Submit Cance 1 Under Collection Identification provide a short name for the collection This will become the URL for the collection so pick carefully For Title fill in the fill title for the collection This will be the name displayed at the top of the collection page B Fill in a 3 or four line short description of the collection This text will display on the front end in the collections list For examples see http microdata worldbank org index php contributing catalogs C Fill in a more detailed description of the collection This will display on the About page for that collection For example see http microdata worldbank org index php catalog dhs about To format the page and include images it is possible to enter HTML code into this box below is an example piece of code that includes an image lt img src files dhs fp 01 jpg Surveys Image class about photo h2 Health Surveys Collection lt h2 gt p align justify gt The Health Surveys collection aims to provide frequent high qual ity and timely health data needed by the decision makers when designing public health programs lt p gt lt p gt Health surveys provide usefu
42. he Site Administration page There are seven main settings sections See screenshot below settings Dashboard settings Countries Site Configurations Regions Vocabularies Update General site settings Language Use HTML Editor for HTML editing Survey catalog settings Site login SMTP settings Dashboard Update 4 10 1 General Settings General site settings Website title NADA e Website footer Powered by NADA 3 2 and DDI 6 Default page catalog Provide the name of the page e g catalog or home or about Webmaster name noreply HER Webmaster email webmaster example com 4 Cache folder Jeache v i Cache expiration time 7200 Provide time in mili seconds for expiring cached items e g 7200 2 hours Disable caching Yes 2 No Caching speeds up page load but uses additional disk space 1 Type the Title of the site here This will become the front page title of the NADA site In this case the Title is NADA 62 Chapter 4 User manual nada Documentation Release 4 0 NADA Data Catalog Citations Contact Us 2 The footer text can be changed in this field This displays at the bottom of your site page Showing 1 5 of 5 studies Select number of records to show 15 30 50 100 Powered by NADA 3 2 and DDI The initial page that loads when a user visits the NADA site can be set here In this case the catalog page is set to open by default The na
43. he form to create an initial Site Administrator account Note create a complex password at least 12 characters long with some uppercase punctuation and numbers to aid security of your site Do not forget this username and password 10 Chapter 2 Installation guide nada Documentation Release 4 0 NADA Installer Create administrator account First Last Email Address Com Country E Y Password Pp Password Confirm Congratulations Launch the new site 2 2 Installation 11 nada Documentation Release 4 0 NADA Installer Installation completed The application installation has completed the summary of the tasks 15 below Task Status Database adl Tables v Admin account d Click here to launch the website 2 3 Installing NADA using Microsoft 501 Server 2 3 1 PHP database drivers sqlsrv The new Microsoft SQL drivers for PHP are called SQLSRV and provide native support for connecting to a Microsoft SQL Server database The drivers have been tested with NADA for SQL Server 2008 and 2012 The drivers are available for download from here http www microsoft com en us download details aspx id 20098 2 3 2 NADA Microsoft SQL Requirements To use Microsoft SQL Server database for NADA it is recommended to use SQL Server 2008 or later with Full Text support enabled The full text engine provides faster search than the normal SQL search The de
44. ial Services MOHSS Replace DOI Export DDI Sponsor rre Refresh 00 Transfer owner Export RDF Folder central8f4571b3c88b73807148c308931 45411 Delete study Collection DHS e Select the collection to transfer from the dropdown box Transfer study owner select the collection from the list below to transfer ownership to another collection Select collection Health Surveys Studies that will be transferred Demographic and Health Survey 1992 Cancel Click Transfer Note that when looking the study summary for the transferred study the Collection field now shows the study to belong owned by to the DHS collection and not Central anymore Also note the option to Publish and unpublish is now active Demographic and Health Survey 1992 NUM a Published t Namibia 1992 zo ns ID NAM 1982 DHS v01 M Callectian Modified on 07 01 2013 Edit Delete To transfer ownership of a large number of studies all at once from the Manage Studies page select the studies to be transferred tick them in the box left of each study and then from the top Batch Actions drop down select Transfer owner then apply 44 Chapter 4 User manual nada Documentation Release 4 0 Manage Studies Health Surveys Sort results by iy Tie Survey Modified Showing 1 4 of 4 atch actians Demographic and Health Survey 2003 Published Publish South Africa 20
45. ies Manage studies Add study Bulk im Licensed requests Dashboard gt Central Data Catala Manage collections Manage Studies Central Data Catalog Sort results by Title SurveylD Modified Showing 1 1 of 1 Transfer owner Apply v gt Popstan Multiple Indicators Cluster Survey 2010 Round 1 M Published Se wen 2010 10 NAM NSA 2010 POP v01 Collection CENTRAL Modified on 06 28 2013 Edit Delete Select number of records to show per Showing 1 1 of 1 There are no collections defined in the default NADA 4 installation Dashboard Collections Click to create new collection Collections All fields Search Ho records were found Tocreate a new collection click on the Create new collection button 4 4 Manage Collections 37 nada Documentation Release 4 0 Dashboard Collections Add Create new collection Callectian Identification Title DHS Health Surveys Short description e The Health Surveys Collection is collection of all health surveys conducted by the Statistica Office as well as other producers Long description this will become the collection about The Health Surveys collection aims to provide frequent high quality and timely health data needed by the decision makers when designing public health programs Health surveys provide useful information on health STATUS healt
46. is configured to send email using PHP s MAIL function select the first option and don t fill in anything else If your organization has a mail server and has have a dedicated account that can be setup for NADA use the following settings Check the radio button Use SMTP Server 2 3 4 5 6 Enter the host name for the server Enter the port used by the server to send mail If required enter the user name used to send mail on the server Enter the password used to send mail on the server If the organization does not own a mail server a Gmail account can be configured to be used with NADA Check the radio button Use SMTP Server Host name ssl smtp googlemail com ssl smtp gmail com SMTP port 465 Account username email address gmail com Account password password for the gmail account Test the email settings The quickest way to test if the email settings are working is to use the forgot password option from the user login page If no mail is received when doing this test then go back and correct the mail settings Check with the ISP or server administrator for the correct settings Click on update to save all settings 66 Chapter 4 User manual nada Documentation Release 4 0 4 10 2 Dashboard setting Provides a means to automatically have content loaded into the dashboard via an RSS feed from a site The default setting 15 set to receive updates and news from the IHSN web
47. is is the folder where the application will store the DDI s documentation and data Chapter 2 Installation guide Note For added nada Documentation Release 4 0 security it is strongly recommended that the location of the datafiles directory be changed after installation to a location outside your web root structure Lk apache cgi bin datafiles folder outside web root contrib Fi 1 pe Pa datafiles htdocs gt Web root install licenses locale your nada web folder cache this is where cached web pages will be stored your nada web folder logs this is where the log files will be stored 2 2 4 Configure MySQL database 1 Browse to the your nada web folder application config folder 2 2 Installation nada Documentation Release 4 0 htdocs Name forbidden nadas autoload php nada 4 bots ph application PP config cachephp z J captcha ph controllers i n collections php p COTE config defaults php errors B helpers 4 config php hooks constants php language P 2 database php EI i doctypes ph libraries model 4 foreign chars php models modules 5 hooks php e index html Ird pa B v 4 ion auth php views 4 migrate php Cac ERN 1 mimes php 1 Open the database php file in a text editor like Notepad or Notepad and change the database user name and p
48. ishunpublish green button is absent for the copied studies Managing Licensed Requests Datasets that are assigned the Access Type Licensed require approval from the NADA administrator before the user can get access to the data files From the site administration there are a number of ways to see if any licensed requests have been received Go to the dashboard Pending requests show up as red in the catalog quicj summary section Clicking on this link goes to the Licensed Survey Requests management page CENTRAL DATA CATALOG Catalog contains 2 studies FUF with no data files Owned 2 Published 2 pending requests lt Linked 0 Unpublished 0 Manage studies 46 Or go to the Studies link on the top menu and select Licensed Requests from the submenu Chapter 4 User manual nada Documentation Release 4 0 Manage studies Lie SP Licensed requests CENTRAL DATA CATALOG Catalog contains 2 studies Manage collections F with no data fies Owned 2 Pubes yp Pending requests Linked 0 The link shows a page with a list Licensed Requests received The status column indicated the Pending requests Licensed Survey Requests Batch actions v Apply Showing 1 1 of 1 Repository Title Requested By Status Date Actions CENTRAL Namibia Demographic and Health Survey 2006 2007 2006 demo demo Pending 06 28 2013 Edit Delete Showing 1 1 of 7 Click on the Edit link for to proce
49. l information on health status and health consumption and their determi nants lt p gt Copy any images to be displayed into the NADA files folder on your server image images thumbnil image png 4 Upload a file to display next to the collection as it is listed on the collection page NOTE This image should be 82 X 82 pixels If the upload does not work automatically then copy the thumbnail image to the files folder as shown above 38 Chapter 4 User manual nada Documentation Release 4 0 Upload thumbnail or copy to the files folder and enter the path to the image here Thumbnail Provi thumbnail path hiles dhs icon pg OR upload a thumbnail file gif png jpg Choose File No file chosen E The Weight field determines in what order collections are shown in the collection list 0 1 2 3 etc The Select collection type drop down is a system value to distinguish between collections that should be viewed as internal to the organization or external For example some collections may be made up entirely of studies from an organization outside the host catalog These collections can be designated as external The Section dropdown allows for the categorization as either a collection based on a specialized collection like health or based on a regional breakdown Selecting Publish publishes the collection Click on Submit to save the changes To view the results click on the Preview link on the
50. llfields v Studies linked from other collections 0 Showing 1 4 of 4 Collection Country Title Modified Actions CENTRAL Namibia Demographic and Health Survey 1992 1992 07 01 2013 CENTRAL Namibia Demographic and Health Survey 2000 2000 07 01 2013 CENTRAL Namibia Demographic and Health Survey 2006 2007 2007 07 01 2013 CENTRAL Namibia Popstan Multiple Indicators Cluster Survey 2010 Round 1 2010 06 28 2013 Select number of records to show per 15 Showing 1 4 of 4 Going back to the Manage Studies page for the collection will show the newly copied studies in the collection list Also note that the Collection field now indicated DHS next to Central DHS is in grey to indicate it is not owned it is a copy by that collection and the Central is in blue to show it is owned by the Central Data Catalog Also note that because the study is not owned by this catalog it cannot be edited from this catalog hence the publishunpublish green button is absent for the copied studies 42 Chapter 4 User manual nada Documentation Release 4 0 4 4 5 Turning on the collection filter The final step after creating the first collection 15 to enable the collection filter option in the Settings menus under Site Configurations Survey catalog settings Dashboard settings Site Configurations General site settings Language Use HTML Editor for HTML editing Survey catalog settings Calalog folder datahles a This inii
51. mail to notify them that the application has been processed Select Update The remaining tabs Communicate provides a means to ask for more information from the applicant Monitor allows the administrator to see when and how many times the applicant downloaded the data Forward Request provides a means to forward the request to another person for review 4 7 Manage Citations The Citations section is where bibliographic references can be added for publications that use any of the studies in the catalog These citations can be linked to particular studies in the catalog and are displayed to the users of the system in the study information view of the relevant study Citations are added from the Citations menu 48 Chapter 4 User manual nada Documentation Release 4 0 All citations Dashboard Import citations Export citations CENTRAL DATA CATALOG USERS To add a citation click on All citations then click on the Add New Citation button at the top right Dashboard Citatians gt Add New Citation 4 amp Import Add new citation Citations All fields Search records were found Compete the form including the indication as to whether the citation should be published or not Then expand the Related studies link to tell the system which studies the citation belongs to Related studies No records found Attach studies Click on
52. me of the webmaster can be set here This is the name that will be used in system emails sent to users Enter the webmaster email address here This should be the address that will be used in communication with users Typically this is a general enquiries email set up by the organization and not a personal email address for a particular person Note to avoid mail systems rejecting mail as spam make sure to enter an address here that is on the same domain as the server used in the email settings at setup This field sets the location of the Cache folder The cache folder stores pre generated pages of the site to allow for faster browsing by the user By default it is set to cache This can be moved to another location if desired but must be writable The green tick indicates that the folder can be found and is set up correctly Enter either relative or absolute paths to the folder location Set the time that the Cache takes to expire By default it is set to 2 hours in milli seconds If itis desired to turn off caching then select no here Sometimes it is useful to turn off caching when developing or updating a site so as to ensure that content changes become immediately visible on the front end without having to wait for the cache to expire and the new changes to show Turn this back on to speed up page loading for users Click update to save all settings Language To change the language of the application expand the language se
53. n us library ms 1863 12 aspx User http msdn microsoft com en us library aa337545 aspx Open the nada database configuration file your nada folder application config database php file and look for the fol lowing lines Sdb sqlsrv hostname localhost sqlexpress Sdb sqlsrv username db user name Sdb sqlsrv password password Sdb sqlisrv database nada database oSdb sglisrv dbdriver sglsrv 5db sglsrv l tdbprerix t Sdb sqlsrv pconnect FALSE sqlsrv db_debug FALSE sdb sqlisry cache on FALSE Sdb sqlsrv cachedir 77 Sdb sqlsryv char ser atte Sadb sglstv dbcollat ucts_ceneral cri Fill in the database connection settings for the database created NADA Save the changes 2 3 9 Running the installer Open a web browser to the location of the NADA installation For example http your domain nada folder name or localhost nada folder name If the Microsoft database connection is setup correctly you should see the nada installer 16 Chapter 2 Installation guide nada Documentation Release 4 0 1 localhost nada4 index php install URLof NADA 4 folder NADA Installer Server information PHP version 547 DB version 5 5 27 connection was successfull Web server Apache 2 4 3 Win32 Open ssSL T 0 1c PHPI amp 4 7 Required PHP Ext
54. nada Documentation Release 4 0 IHSN February 07 2014 Contents nada Documentation Release 4 0 NADA is an open source microdata cataloging system complaint with the Data Documentation Initiative DDI and Dublin Core s RDF metadata standards It serves as a portal for researchers to browse search compare apply for access and download relevant census or survey datasets questionnaires reports and other information Project home page http www ihsn org nada Documentation topics Contents 1 Documentation Release 4 0 Contents 1 Requirements NADA requires PHP and a MySQL database at minimum 1 1 PHP requirements The minimum required version is PHP 5 2 but we strongly recommend that you use PHP 5 3 or 5 4 The following PHP extensions are required for NADA xsl xml mbstring e mysql or sqlsrv Note See section on PHP configurations for configuring your server for NADA 1 2 Web Server requirements Apache 2 x IS 6 7 x 1 3 Supported Databases MySQL 5 x Microsoft SQL Server with fulltext support Documentation Release 4 0 A Chapter 1 Requirements 2 Installation guide 2 1 Requirements NADA requires PHP and a MySQL database at minimum 2 1 1 PHP requirements The minimum required version is PHP 5 2 but we strongly recommend that you use PHP 5 3 or 5 4 The following PHP extensions are required for NADA
55. nage and review studies for collections they are assigned to Report viewer Can only generate view reports Citation manager has full control over the citations Global Licensed Reviewer This account can review licensed data requests from all collections Impersonating a user The system includes a function that allows a Site Administrator to impersonate take on the role a user created in the system This is a useful testing tool when creating users and assigning permissions It essentially allows the administrator to take on the role of another user temporarily To access the Impersonate User feature go to the Users Impersonat user menu at the top of the screen 5 localhast nada4 in 5 Health Surveys E Central Data Catal Site configurations 3 Central Data Catal 3 Citations a x C localhost nada4 index php admin users permissions 3 B All users Add user Edit user permissions Health Impersonate user Site level permissions A list of users to impersonate is shown Impersonate as another user select the account below to impersonate as Health Licensed Health Licensed gihsn org Health Reviewer Health Reviewer ihsn org impersonate Cancel Select the user to impersonate and click on the impersonate button The dashboard view for the impersonated user now shows 58 Chapter 4 User manual nada Documentation Release 4 0 Dashboard CENTRA
56. nage studies Bulk import DDI Change Password Logout Dashboard gt Health Surveys Manage studies Home Data Catalog Citations Manage Studies Health Surveys swin 4 8 5 The Reviewer Limited access account Sometimes it is desirable for catalog administrators to allow certain users to see a collection before it is published but without granting access to the site administration functions This is useful for getting feedback on the correctness of information on collections or studies before publishing To do this e First create an account for the user or get the user to create an account by using the register form on the login screen Then edit the permissions for that user selecting Site Administrator limited access Collection administrator Then for the appropriate collection select Reviewer and click update to save the changes 4 8 Managing Users and account types 59 nada Documentation Release 4 0 Edit user permissions Health Reviewer ite level permissions General user accounts no admin access General site users with no access to site administration Site administrators full access Full control over all site sections 9 Site administrators limited access Limit user access to the site administration and control permissions per collection for the user Collection administrators Users can manage and review studies for collections they are assigned to Report viewer Can only generate
57. older system 6 16 2013 9 11 PM File folder themes 6 16 2013 9 15PM File folder xsit 6 16 2013 9 11 PM File folder 4 index php 6 16 2013 9 10PM File 7 KB license txt 6 16 2013 911 Text Document 3 KB 2 2 2 Setup application folder Copy the files to a folder in the web server root folder If installing on a localhost for example the computer currently being working on then copy and paste or move the files into the root folder or a sub folder of the web server If however the server is running on a remote host such as an ISP then this process will involve the use of a FTP client program or file manager from the ISP s Cpanel Note The folder name chosen will in many cases become the URL for the catalog Examples for a folder name might be data microdata catalog etc The root folder is located in different places depending upon the operating system distribution and web server package you are using and it might be called htdocs httpd or www On Windows servers this might be located in the inetpub directory and on Linux in the var directory Consult the documentation for the distribution being used or contact the ISP if unsure where the root web folder is 2 2 3 Folder permissions Change the permissions for the following folders and their contents to READ WRITE and on Windows servers make sure the IUSR user has read write delete permissions on these folders your nada web folder datafiles th
58. ollections will automatically be added to the Central Data Catalog in order to build a common search portal for all studies 4 5 Manage Studies 45 nada Documentation Release 4 0 4 5 2 Option2 Copying studies from one collection to another 4 6 The second way to add a study to a collection is to Copy the study from another collection into the new collection To copy a study already in the catalog to display in the new collection first make sure to be in the Manage Studies section for the collection you want to put studies into To do this either use the Studies Manage studies menu on the top or simply click on the Switch link next to the Manage Studies Collection Title heading Then Click on the Copy Studies blue button at the top right A list of all studies available to copy to the new collection is listed Simply click on the Link button in green to copy the study to the collection The button will turn red and say Unlink To reverse the process and click the now red button Going back to the Manage Studies page for the collection will show the newly copied studies in the collection list Also note that the Collection field now indicated DHS next to Central DHS is in grey to indicate it is not owned it is a copy by that collection and the Central is in blue to show it is owned by the Central Data Catalog Also note that because the study is not owned by this catalog it cannot be edited from this catalog hence the publ
59. ps records of who downloads the data Licensed Data Files data shared under this policy requires that the user be logged in and registered on the site Users are also required to fill in and submit a detailed application form listing their reasons for wanting access to the data Once the user submits the application form the system informs the system administrator that an application has been made In order for the person to get access to the data the system administrator needs to review the application and approve it Data available in an Enclave under this policy no data is shared through the application Users submit an application to access the data at a secure facility physically located on the premises of the data producer or a facility nominated by the data producer Data available from external repository The NADA allows for studies and their metadata to be listed in a NADA catalog but for a link to be created to another site when the data for that study are available elsewhere CITATIONS Citations are references that can be included at the study level which point to published works that have used the data from a particular study In many cases this will be a reference to a Journal Article Working paper Newspaper article etc Such resources are useful to researchers who are interested in seeing how the data have been used before They are also a good way of showing the funders of surveys that the data are being used for policy and re
60. s account can review licensed data requests from all collections Permissions per collection Health Surveys Manage studies full access Full control over the studies including adding updating publishing copying from other collections e Manage studies limited access All access except can t publish or unpublish studies Manage licensed requests Allows user to view and process licensed data requests for the collection Reviewer Allows user to review studies from the front end regardless of study publish unpublish status Update Cancel Other levels of access for Site administrators limited access Collection administrators include 1 Accounts that are given full access to manage studies 2 Accounts that are given access to upload studies but not publish them 3 Accounts that are limited to reviewing studies 4 8 4 Global level Limited access accounts Other types of limited access accounts include 1 Accounts that can only view system reports at a global level 2 Accounts that can only access the citations section and manage citations 3 Accounts that can only access the Licensed Request management system at the global level for all collections 4 8 Managing Users and account types 57 nada Documentation Release 4 0 Site administrators limited access Limit user access to the site administration and control permissions per collection for the user Collection administrators Users can ma
61. se HTML Editor for HTML editing Survey catalog settings Catalog folder datafiles v This folder is for storing DDI and related files DDI import folder imports v Folder to look for DDI files for importing in bulk Select topic vocabulary CESSDA Topics Classifications Select the vocabulary to use for Topics classification For the setting Catalog folder enter the relative or full path to where the NADA 3 datafiles folder is located For example if the nada3 datafiles are located on c nada3 datafiles enter that path here e Save the configurations by clicking on the update button If now errors are shown then you have successfully updated the folder path Check your new NADA 4 site to make sure the migration was successful Check the user administration page from site administration to make sure the users from the nada3 site were migrated Check the Data Catalog page and view the studies by clicking on the study title to make sure the study information pages are correct Check the site menus are the same as the NADA 3 site 3 1 2 Refresh DDI In NADA 4 more information is stored in the database from the DDI than in the NADA 3 To bring all these new fields into the imported studies it is necessary to refresh the DDI s The refresh DDI feature in NADA updates the database with metadata from the DDI without having re uploading the DDIs To update the metadata for all studies in your catalog
62. search purposes and thus are an indicator of some of the impact a study has had USERS Users in the NADA can be defined according to three broad groups General Users this is the normal user who registers on NADA site from the user interface This user type has no access to the site administration It is required to register as a user when accessing public use and licensed data types Site Administrators unlimited this user 34 Chapter 4 User manual nada Documentation Release 4 0 has access to all functions and all collections within the Site Administration System wide access Limited Adminis trators these administrators have access to a limited set of functions within the Site Administration Examples would be an administrator of a specific collections or licensed survey reviewer for all or only some collections or report generator etc 4 1 3 Why do NADA administrators need to understand these concepts Understanding these concepts is important as it 15 critical to understanding the new permissions and administrator types introduced in NADA 4 Administrators are now able to create collections within their NADA s and assign different roles to administrators and more granular levels of access to catalog administration at the collection level It is now possible for example to have administrators who s powers range from being able to manage all parts of a collection s administration down to ones with
63. site Dashboard News feed URL RSS http ihsn org nada index php q news feed 4 10 The Site Settings Page 67 Documentation Release 4 0 68 Chapter 4 User manual 5 Indices and tables genindex modindex search 69
64. ss a request The Request information tab shows a summary of the information provided by the applicant Edit licensed request Req uest information Process Communicate Monitor Forward req uest Hequest information Request status Pending Hequest ID 1 Dated Fri Jun 28 2013 23 11 38 First Name Demo Last Name Demo Organization IHSN Email demomihsn org Namibia Demographic and Health Survey 2006 2007 Dataset requested NAM 2006 DHS v01 M To Approve or Deny or request further information for the request Click on the Process tab 46 Managing Licensed Requests 0 47 nada Documentation Release 4 0 Request information Process Communicate Monitor Forward request Request status Pending Select action Approve Deny Request more information Cancel authorization Grant access to licensed data files File Download limit Expiry popstan 2010 hid dta 3 07 31 2013 To change all settings at once fill the boxes and click apply 3 07 31 2013 Comments comments will be visible to the user View request history Notify user by email Update Cancel Select Approve to approve the request other options include Deny as well as Request more information from the applicant Select the files that the user will be authorized to download it is also possible to enter a maximum number of downloads and expiry date for downloads Enter any comments to be sent to the applicant Select Notify user by e
65. ta are data about the data They are not the actual data collected from the survey but rather the information that describes the survey process and the data The NADA uses the Data Documentation Initiative DDI ddialliance org standard for the presentation of metadata for each study The DDI document which is an XML document is prepared outside the NADA application either manually or using a tool like the Nesstar Publisher nesstar com and then imported into the NADA The detailed information about the survey is searchable down to the variable level for each survey in the catalog DATA ACCESS TYPES The NADA allows for the level of access to datasets for studies to be controlled at the study level In other words the level of restriction can differ from study to study and can be defined on a scale ranging from direct access with no restrictions to no access Briefly the available access types are Data not available data are not available for this study Direct Access Data Files data shared under this policy can be downloaded without any restrictions The user is not required to be logged into the site and no personal information is collected on the person downloading the data Public Use Data Files data shared under this policy requires that the user be logged in and registered on the site before they are able to download the data The user is required to agree to a terms of use of the data and the application kee
66. te user Create new user User Management All fields Search Username Email Address User group Status Country Joined Last login Actions demo demo demogeihsn org admin ACTIVE United States 06 26 2013 07 02 2013 Edit Delete Permissions health hcensed Heal Licensedginsn arg ACTIVE United States 07 02 2013 Edit Delete Permissions health reviewer Health Reviewerghhsn org ACTIVE United States Dr Oz 2013 Edit Delete Permissions Note the new users created have no User group assigned they are general users Also note the Actions column on the far right From these links an account can be edited including changing the password and blocking an account deleted and Permissions managed for the account 4 8 2 Managing User Account Permissions User accounts permissions can be only be set and changed by a Site Administrator To change the permissions for an account Click on the Permissions link next to the account to be changed accounts start of as General users accounts Edit user permissions Health Licensed Site level permissions General user accounts no admin access General site users with no access to site administration User General user account with no access to site administration 7 Site administrators full access Full control over all site sections Site administrators limited access Limit user access to the site administration and control permissions per collection for the user Can
67. the Attach studies link This reveals a list of all studies in the catalog Select Studies Title Search Show selected only ID Title Country Year 5 Demographic and Health Survey 2003 South Africa 2004 3 Demographic and Health Survey 1992 Namibia 1992 4 Demographic and Health Survey 2000 Namibia 2000 2 Demographic and Health Survey 2006 2007 Namibia 2007 1 Popstan Multiple Indicators Cluster Survey 2010 Round 1 Namibia 2010 Select the relevant studies by clicking on the green Select button Click on the apply filter button to save the changes The study now appears in the related studies box Related studies Attach studies Title Country year Demographic and Health Survey 2006 2007 Namibia 2006 2007 Click on the submit button to save the citation Note the flag keywords and notes fields can be used by administrators to place extra notes only visible to other administrators that might prove useful when there is uncertainty about a citations appropriateness or accuracy tis also possible to import citations in common citation formats such as BibTex and EndNote RIS do this use the Import Citations link from the top menu 4 7 Manage Citations 49 nada Documentation Release 4 0 NADA 4 0 studies Citations Dashboard Citations gt import citations All citations Import citations Export citations Import Citations Paste the BibTex or RIS text into th
68. view reports C Citation manager has full control over the citations Global Licensed Reviewer This account can review licensed data requests from all collections Permissions per collection Health Surveys Manage studies full access Full control over the studies including adding updating publishing copying from other collections etc Manage studies limited access All access except can t publish or unpublish studies Manage licensed requests Allows user to view and process licensed data requests for the collection Reviewer Allows user to review studies from the front end regardless of study publish unpublish status Update Cancel The newly created reviewer account user can now view all studies in a collection even if the study or collection is unpublished 4 9 Manage Site Pages and Menus The NADA has a small content management component that allows for the creation of menu pages to appear on the user interface e Examples of menus that might be useful for users of the site might be A page dealing with the dissemination policies of the organization or perhaps a page with contact information for the information New menu items and pages can be created via the Menu All pages menu link at the top of the Site Administration page 60 Chapter 4 User manual nada Documentation Release 4 0 Dashboard Menu pape e Select pages from the menu Dashboard Menu Add New Page

4.1 PDF - Read the Docs

Contents

Download Pdf Manuals

Related Search

Related Contents