Upgrade to another version

 Software upgrade process home page
 

 

  • If you are upgrading from an ExamDeveloper version prior to 7.1702, it is mandatory to upgrade to 7.1702 first and execute all the scripts before upgrading to this version.
  • It is important to not skip versions and rather upgrade sequentially. Upgrading directly to a higher version by skipping certain versions may cause improper installation and the application may not work if there are mandatory changes in any of the intermediate versions being skipped.

 



  1. It is important to run this utility before proceeding any further. This utility converts existing Drag & Drop type Questions to Enhanced Matching type Questions as is applicable from ExamDeveloper version 7.1711.


    Please follow the below steps to execute the DnDConverter utility.

    1. Locate DnDConverter.exe in the <SVNFolder>\External\DnDConverter\ folder. Here, <SVNFolder> is the path where ExamDeveloper files are going to be checked out, which is C:\ExamDeveloper\Repositories\ExamDeveloper\ in our example.
    2. Execute the DragAndDrop Converter with the following command: 

      DnDConverter.exe "<YourDatabaseConnectionString>"

      Make sure that the connection string is enclosed in double-quotes.

      Here, <YourDatabaseConnectionString> is your ExamDeveloper database connection string, which is the same as the value of the CONNECTION_STRING token from the self-hosted.properties file.
      Thus, if your database connection string is "Data Source=WIN-VSGF1NBSVPB;Initial Catalog=ExamDeveloper;Persist Security Info=True;User ID=ExamDev;Password=P@s$w0rd" as in our example, then the command to run would appear as below:

      DnDConverter.exe "Data Source=WIN-VSGF1NBSVPB;Initial Catalog=ExamDeveloper;Persist Security Info=True;User ID=ExamDev;Password=P@s$w0rd"
       
    3. The command prompt screen will tell you how many Drag & Drop type Questions were converted to Enhanced Matching type Questions.
      If there were any errors, you can find them here: <SVNFolder>\External\DnDConverter\DnDConverter.log.

      Once this is complete, you may continue with the rest of the upgrade process.

      In order to run the DND migration script (14105) in ExamDeveloper application SQL server 2012 and above version is required. If we have SQL server 2008 and below version need to run the DND migration (14105) script manually upon confirming that there are no DND questions exists in the application.

     

     

  2. Ensure that the self-hosted.properties file updated in steps 1 and 2 of Upgrading from 7.1704 to 7.1705 is placed in the folder C:\EnvProp\. Also ensure that the secure.properties file created in step 3 of Upgrading from 7.1704 to 7.1705 is placed in the folder C:\SecProp\.


  3. In case these haven't already been added, please add the following keys to the self-hosted.properties file:

    • REPORT_DSN_FOLDER=ExamDeveloper

      Copy over the value of the "reportServerPath" key from the ExamDeveloper appSettings.config.
      Please ensure that you exclude the leading and trailing slashes from this value. Thus, if the value of "reportServerPath" is "/ExamDeveloper/", then you only need to use the value "ExamDeveloper".

    • ERROR_AUTOLOG_EMAIL_ADDRESS=errorlogsreporting@pearson.com

      Please specify the email address where the error logs are to be sent.

    • JSPELL_FOLDER=C:\Program Files (x86)\JSpell Spell Checker

      Copy over the value of the "JSpellFolder" key from the ExamDeveloper appSettings.config. You can leave the default value if the key "JSpellFolder" does not exist in the ExamDeveloper appSettings.config.

     

  4. Modify the ReportDeploy.exe.config file from the ExamDeveloper reports.zip as follows:

    1. Extract the <SVNFolder>\Web\reports.zip file into a folder.

    2. Navigate to the folder where reports.zip has been extracted and edit the ReportDeploy.exe.config file to modify the value of the below keys:

      <add key="reportFolderName" value="@{REPORT_DSN_FOLDER}"/>

       

    3. Save the modified ReportDeploy.exe.config file.

    4. Create a ZIP archive reports.zip from the contents of the folder where <SVNFolder>\Web\reports.zip was extracted earlier, and copy it to <SVNFolder>\Web\ and overwrite the existing reports.zip.

  5. Open Windows PowerShell as Administrator.

  6. Bypass the PowerShell execution policy with the following command:

    Set-ExecutionPolicy bypass
     
  7. Store the credentials for the user "servuser" (created in step 2 of Upgrading from 7.1702 to 7.1704) into a variable $c with the following command:

    $c = Get-Credential

    This will prompt you for the credentials, which you must enter and click OK.

    Please ensure that the User name is entered in the "domain-name\username" format; in our example it is "WIN-VSGF1NBSVPB\servuser".


     
     

  8. Store the path to the self-hosted.properties and secure.properties files located at C:\EnvProp\ and C:\SecProp\ respectively as in our example, into variables $p and $q respectively. Run the following commands:

    $p = "C:\EnvProp\self-hosted.properties"
    $q = "C:\SecProp\secure.properties"

     

    For side-by-side (additional instance) installation, please ensure that separate self-hosted.properties and secure.properties files with unique values are used to be stored in these variables, such as beta-self-hosted.properties and beta-secure.properties.

     


  9. Store the environment into a variable $e with the following command:

    $e = "prod" 

     

    For side-by-side (additional instance) installation, please ensure that this value is set to a unique value that is different from the values used for other existing instances of ExamDeveloper, such as "beta" if you have used "prod" for the earlier instance.

     

  10. For the ItemBank service:

    1. Change the directory to the ItemBank service setup folder with the following command:

      cd "<SVNFolder>\ItemBank\"

      Where, <SVNFolder>\ItemBank\ is the location where the ItemBank service setup files have been downloaded.
      Please make sure that the ItemBank service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the ItemBank service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e
       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  11. For the ExamService service:

    1. Change the directory to the ExamService service setup folder with the following command:

      cd "<SVNFolder>\Exam\"

      Where, <SVNFolder>\Exam\ is the location where the ExamService service setup files have been downloaded.
      Please make sure that the ExamService service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the ExamService service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e 

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  12. For the Project service:

    1. Change the directory to the Project service setup folder with the following command:

      cd "<SVNFolder>\Project\"

      Where, <SVNFolder>\Project\ is the location where the Project service setup files have been downloaded.
      Please make sure that the Project service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the Project service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e
       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  13. For the User service:

    1. Change the directory to the User service setup folder with the following command:

      cd "<SVNFolder>\User\"

      Where, <SVNFolder>\User\ is the location where the User service setup files have been downloaded.
      Please make sure that the User service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the User service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e
       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  14. For the Assignment service:

    1. Change the directory to the Assignment service setup folder with the following command:

      cd "<SVNFolder>\Assignment\"

      Where, <SVNFolder>\Assignment\ is the location where the Assignment service setup files have been downloaded.
      Please make sure that the Assignment service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the Assignment service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e
       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  15. For the Question service:

    1. Change the directory to the Question service setup folder with the following command:

      cd "<SVNFolder>\Question\"

      Where, <SVNFolder>\Question\ is the location where the Question service setup files have been downloaded.
      Please make sure that the Question service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the Question service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  16. For the Asset service:

    1. Change the directory to the Asset service setup folder with the following command:

      cd "<SVNFolder>\Asset\"

      Where, <SVNFolder>\Asset\ is the location where the Asset service setup files have been downloaded.
      Please make sure that the Asset service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the Asset service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.

  17. For the Notification service:

    1. Change the directory to the Notification service setup folder with the following command:

      cd "<SVNFolder>\Notification\"

      Where, <SVNFolder>\Notification\ is the location where the Notification service setup files have been downloaded.
      Please make sure that the Notification service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the Notification service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e
       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  18. For the Statistics service:

    1. Change the directory to the Statistics service setup folder with the following command:

      cd "<SVNFolder>\Statistics\"

      Where, <SVNFolder>\Statistics\ is the location where the Statistics service setup files have been downloaded.
      Please make sure that the Statistics service setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install the Statistics service:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  19. For EDRS:

    1. Change the directory to the EDRS setup folder with the following command:

      cd "<SVNFolder>\EDRS\"

      Where, <SVNFolder>\EDRS\ is the location where the EDRS setup files have been downloaded.
      Please make sure that the EDRS setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install EDRS:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e
       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.



  20. EDSS setup is optional, so you need to follow these steps only if you plan to use EDSS.


    For EDSS:

    1. Change the directory to the EDSS setup folder with the following command:

      cd "<SVNFolder>\EDSS\"

      Where, <SVNFolder>\EDSS\ is the location where the EDSS setup files have been downloaded.
      Please make sure that the EDSS setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install EDSS:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e

       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.

       

  21. EDQSS setup is optional, so you need to follow these steps only if you plan to use EDQSS.


    For EDQSS:

    1. Change the directory to the EDQSS setup folder with the following command:

      cd "<SVNFolder>\EDQSS\"

      Where, <SVNFolder>\EDQSS\ is the location where the EDQSS setup files have been downloaded.
      Please make sure that the EDQSS setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install EDQSS:

      ./setup.ps1 -Credential $c -PropertiesFilePaths $p,$q -Environment $e

       

       

      For side-by-side (additional instance) installation, please add the parameter "-SideBySideInstall" to the above command.

       

       

  22. For the ExamDeveloper application:

    1. Change the directory to the ExamDeveloper setup folder with the following command:

      cd "<SVNFolder>\Web\"

      Where, <SVNFolder>\Web\ is the location where the ExamDeveloper setup files have been downloaded.
      Please make sure that the ExamDeveloper setup path is enclosed in quotes, especially if the path name contains spaces.
       
    2. Run the following command to install ExamDeveloper:

      ./setup.ps1 -PropertiesFile $p -SecurePropertiesFile $q -Environment $e

     

     

     

 

 

 

Return to the top of the page

 Upgrade to another version

 Software upgrade process home page