Navigation Menu

Click the "+" to see inside a chapter or use the search to the right.

.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: clean up

 Upgrade to another version.

 Software upgrade process home page.
 

 

Excerpt
Warning
  • 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.
Warning

 

  1. 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\.


  2. In case it hasn't already been added, please add the following token 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".


  3. 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.

  4. Open Windows PowerShell as Administrator.

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

    Set-ExecutionPolicy bypass
     
  6. 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.

    Note

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


    Image RemovedImage Added 
     

  7. 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"

    Note
    titleFor side-by-side (additional instance)

     

    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.

     


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

    $e = "prod" 

    Note
    titleFor side-by-side (additional instance)

     

    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.

     

  9. 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
       

      Note
      titleFor side-by-side (additional instance)

       

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



  10. 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 

      Note
      titleFor side-by-side (additional instance)

       

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



  11. 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
       

      Note
      titleFor side-by-side (additional instance)

       

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



  12. 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
       

      Note
      titleFor side-by-side (additional instance)

       

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



  13. 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
       

      Note
      titleFor side-by-side (additional instance)

       

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



  14. 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

      Note
      titleFor side-by-side (additional instance)

       

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



  15. 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
       

      Note
      titleFor side-by-side (additional instance)

       

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



  16. 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

      Note
      titleFor side-by-side (additional instance)

       

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



  17. 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
       

      Note
      titleFor side-by-side (additional instance)

       

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



  18. Note

    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

       

      Note
      titleFor side-by-side (additional instance)

       

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

       

  19. Note

    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

       

      Note
      titleFor side-by-side (additional instance)

       

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

       

       

  20. 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

     

  21. Expand
    titleRun the Go Live script as detailed here.
    Warning
    • Please ensure that you run the following script only after ExamDeveloper and all the micro-services are up and running. If this is not done then the Assignment count in the Due Date Assignment Report will not get updated correctly.
    • Since this script takes more than 3 hours to complete the execution, the correct Assignment count in the Due Date Assignment Report will not be generated and displayed until it finishes the execution. You must wait for it to finish to get the correct Assignment count.

     

    The Go Live script needs to be run once to ensure that the Assignment count is correct in the Due Date Assignment report. Please follow the below steps to execute this utility.

    1. Open a web browser and enter the URL as below:

      https://ED-URL/api/QuestionSearchCriteria/UpdateAllAssignmentCountWithRetry

      where ED-URL is the ExamDeveloper URL.

      Thus, if the ExamDeveloper URL is https://examdev.pearsonvue.com/ExamDeveloper, then the URL to open in the browser will be https://examdev.pearsonvue.com/ExamDeveloper/api/QuestionSearchCriteria/UpdateAllAssignmentCountWithRetry.

    2. You will be prompted for credentials as shown below.
      Image RemovedImage Added

      Here, enter the API login credentials "username" and "password" as the values from the ExamDeveloper appSettings.config of the keys "ApiAuthenticationUserName" and "ApiAuthenticationPassword".

      Warning

      Please ensure that you do not run the URL more than once as this creates unnecessary overhead for the system by starting the job all over again.



    3. On entering the correct credentials, you will see a blank page as below with the spinning busy status indicator of the web page in the browser. This script runs for well over an hour, so you can close the browser window, and the script will keep running in the background.
      Image RemovedImage Added 

      You can find out about whether the process has begun by looking into the General.txt file located in the Logs folder of the "DataRoot" folder mentioned in the appSettings.config of ExamDeveloper. Search for the text "Starting Migration script to update the UpdateAllAssignmentCountWithRetry". If you are able to find it, then it means that the process has started successfully. If you are unable to find it, then it means that the process didn't start and you need to run it again by going back to step a.

    4. You can cross check the job progress in the logs by looking into the General.txt file. You can check this file after 3 hours from the time the script was run, because this is the typical time taken for it to complete the processing. Search for the text "Successfully updated UpdateAllAssignmentCountWithRetry". If you are able to find it, then it means that the script has finished running successfully.

      If this text is not found in the file, you can search for the text "UpdateAllAssignmentCountWithRetry:Now processing for Assignment", which will confirm that the script is still processing. You can wait and try to search again for "Successfully updated UpdateAllAssignmentCountWithRetry" later.

      If you are not able to find the text "Successfully updated UpdateAllAssignmentCountWithRetry", and "UpdateAllAssignmentCountWithRetry:Now processing for Assignment" text has stopped updating (has not updated for more than 10 minutes) in the log, then there may be an issue in the execution of the script. IIS is reset or new build deployment may cause this behavior. Therefore, please do not deploy or reset IIS while this script is running. If that happens, please run this script again by going back to step a.

Note
titleUpgrading to the next version again?


If you plan to immediately upgrade to the next version of the application, you need to again follow the following steps:

  1. Expand
    titleBackup the application files. Click to know how.

    Excerpt Include
    11.4.3 Backup Application Files
    nopaneltrue

  2. Expand
    titleUpgrade the application files and follow the steps to upgrade from this version to the next. Click to know how.

    Excerpt Include
    11.4.4 Upgrade Application Files
    nopaneltrue

  3. Expand
    titleModify the various config files to upgrade from 7.1707 to 7.1708. Click to know how.

    Excerpt Include
    11.4.4.16 Upgrading from 7.1707 to 7.1708
    nopaneltrue

    or open this page by clicking here.

 

 

Return to the top of the page.

 Upgrade to another version.

 Software upgrade process home page.