Navigation Menu

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

.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

 Upgrade to another version.

 Update SQL Server Report .RDL files.

 Software upgrade process home page.
 

Icon

The following instructions require Microsoft PowerShell to be installed. If you do not have it installed, you can refer to the following URL to install it: https://social.technet.microsoft.com/wiki/contents/articles/21016.how-to-install-windows-powershell-4-0.aspx

Icon

It is important to ensure that all the values in the config files such as service name, URLs, username, and password are case-sensitive. ExamDeveloper may not run as expected if care is not taken to ensure that case sensitivity is maintained.

 

  1. Copy the self-hosted.propertiies file to a folder such as C:\EnvProp\, open it with a suitable text editor such as Notepad, and modify the following values:
     
    • LOG_ROOT_DIR=${ProgramFiles}\Pearson\logs\
      DO NOT MODIFY. This is the folder location where the log files of all the microservices will be stored.
    • LOG_ENV_SUBDIR= (HOW IS THIS SPECIFIED?)
      Name of the environment to be used as a subdirectory for the log (Change if doing a side by side installation (prod and beta on the same hardware))
    • EDRS_OUTPUT_DIR=C:\ExamDeveloper\AppData\ExamDeveloper\Reports\
      Copy over the value of the "outputDirectory" key from the EDRS appSettings.config.
    • DATA_ROOT=C:\ExamDeveloper\AppData\ExamDeveloper\
      Copy over the value of the "DataRoot" key from the ExamDeveloper appSettings.config.
    • USE_SSL=true
      DO NOT MODIFY. This needs to be set to "true" for secure communication between the microservices and ExamDeveloper.
    • HANGFIRE_PORT=9000
      This is the port number used by Hangfire that was set up during EDSS setup.
    • PROXY_SERVER_HOSTNAME=
    • LICENSE_KEY=Insert the license key over here
      Copy over the value of the "licensekey" key from the EDRS appSettings.config.
    • LICENSE_SERVER=https://examdevlicense.pearsonvue.com/Server/CheckLicense.aspx
      Copy over the value of the "licenseServer" key from the EDRS appSettings.config.
    • ENCRYPTION_KEY=
      ???
    • WEB_ADMIN_USERNAME=sbadmin
      This is the default admin username to log into ExamDeveloper.
    • WEB_ADMIN_PASSWORD=Dummy_ED-Admin_Password
      This is the default admin password to log into ExamDeveloper.
    • CONNECTION_STRING="Data Source=WIN-VSGF1NBSVPB;Initial Catalog=ExamDeveloper;Persist Security Info=True;User ID=ExamDev;Password=P@s$w0rd"
      Copy over the value of the connection string from the ExamDeveloper connectionStrings.config.
    • SIMILARITY_CONNECTION_STRING="Data Source=WIN-VSGF1NBSVPB;Initial Catalog=Similarity;Persist Security Info=True;User ID=Similarity;Password=P@s$w0rd"
      Copy over the value of the "similarity" connection string from the EDQSS connectionStrings.config.
    • HANGFIRE_CONNECTION_STRING="Data Source=WIN-VSGF1NBSVPB;Initial Catalog=Hangfire;Persist Security Info=True;User ID=Hangfire;Password=P@s$w0rd"
      Copy over the value of the "hangfireConnectionString" connection string from the EDQSS connectionStrings.config.
    • MATH_EDITOR=wiris
      Copy over the value of the "MathEditor" key from the ExamDeveloper appSettings.config.
    • WIRIS_IMAGE_SERVICE_HOST=www.WIRISServiceHost.com/WirisServerComponent
      Copy over the value of the "com.wiris.plugin.wirisimageservicehost" key from the WIRIS Web.config.
    • ENABLE_NEW_EMAILFORMAT=false
    • WEBSITE_NAME=Default Web Site
      This is the name of the ExamDeveloper Application (Alias) as detailed here.
    • APPPOOL_NAME=ExamDeveloper
      This is the name of the ExamDeveloper Application pool as detailed here.
    • WEB_TARGET_DIR=<ExtractedFolder>\Web\
      This is the physical path of name of the ExamDeveloper application<ExtractedFolder>\Web.as detailed here.
    • SEND_MAIL=1
    • MAIL_SENDER=examdeveloper@pearson.com
      Copy over the value of the "MailSender" key from the ExamDeveloper appSettings.config.
    • SUPPORT_EMAIL=examdeveloper@pearson.com
      Copy over the value of the "SupportEmail" key from the ExamDeveloper appSettings.config.
    • ENABLE_AUTOLOG_EMAIL=1
    • MAIL_SERVER=localhost
      Copy over the value of the "MailServer" key from the ExamDeveloper appSettings.config.
    • MAIL_PORT=25
      Copy over the value of the "MailPort" key from the ExamDeveloper appSettings.config.
    • MAIL_USERNAME=support
      Copy over the value of the "MailUsername" key from the ExamDeveloper appSettings.config.
    • MAIL_PASSWORD=mailP@s$
      Copy over the value of the "MailPassword" key from the ExamDeveloper appSettings.config.
    • WEB_DOMAIN=ED-URL
      This is the domain name of the server where ExamDeveloper is installed. Copy it from the URL for "ExamDev" in the EDRS httpClients.config.
    • APP_DOMAIN=app-URL
      This is the domain name of the server where all the microservices are installed. Copy it from the URL for "UserService" in the EDRS httpClients.config.
    • WEB_PROTOCOL=https
    • WEB_RELATIVE_URI=ExamDeveloper
    • APP_PROTOCOL=https
    • APP_RELATIVE_URI_PREFIX=
    • BASIC_AUTH_USER_NAME=examDeveloper
      Copy over the value of the "ApiAuthenticationUserName" key from the ExamDeveloper appSettings.config.
    • BASIC_AUTH_PASSWORD=Dummy_Password
      Copy over the value of the "ApiAuthenticationPassword" key from the ExamDeveloper appSettings.config.
    • RABBIT_ADDRESS=rabbitmq://RabbitMQ-URL/ExamDeveloper
      Copy over the value of the "hostAddress" key from the ExamDeveloper massTransit.config.
    • RABBIT_USER=ExamDeveloper
      Copy over the value of the "username" key from the ExamDeveloper massTransit.config.
    • RABBIT_PASSWORD=Password
      Copy over the value of the "password" key from the ExamDeveloper massTransit.config.
    • REPORT_SERVER_URL=https://WIN-VSGF1NBSVPB:80/ReportServer
      Copy over the value of the "reportServerUrl" key from the ExamDeveloper appSettings.config.
    • REPORT_SERVER_DOMAIN_NAME=WIN-VSGF1NBSVPB
      Copy over the value of the "reportServerDomainName" key from the ExamDeveloper appSettings.config.
    • REPORT_SERVER_USER_NAME=edReporting
      Copy over the value of the "reportServerUserName" key from the ExamDeveloper appSettings.config.
    • REPORT_SERVER_PASSWORD=Password123
      Copy over the value of the "reportServerPassword" key from the ExamDeveloper appSettings.config.
    • ELASTIC_ADDRESS=http://localhost:9200/
      DO NOT MODIFY. This is the Elasticsearch URL as mentioned in step 8 of Installation of Elasticsearch Server.
       
  2. Create a standard user "servuser" to handle all the microservices.

    Icon

    Please ensure that the user "servuser" has write access to the EDRS output directory, which can be achieved as detailed over here.



  3. Open Windows PowerShell as Administrator.
  4. Bypass the PowerShell execution policy with the following command:
    set-executionpolicy bypass
     
  5. Store the credentials for "servuser" into a variable $c with the following command:
    $c = Get-Credentials

    This will prompt you for the credentials, which you must enter and click OK.
     
     
  6. Store the path to the self-hosted.properties file (C:\EnvProp\) into a variable $p with the following command:
    $p = "C:\EnvProp\environment.properties"
     
  7. For EDRS:
    1. Change the directory to the EDRS setup folder with the following command:
      cd "<ExtractedFolder>\EDRS\"

      Where, <ExtractedFolder>\EDRS\ is the location where the EDRS setup files have been extracted.
      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 
       
  8. For EDSS:
    1. Change the directory to the EDSS setup folder with the following command:
      cd "<ExtractedFolder>\EDSS\"

      Where, <ExtractedFolder>\EDSS\ is the location where the EDSS setup files have been extracted.
      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 
       
  9. For EDQSS:
    1. Change the directory to the EDQSS setup folder with the following command:
      cd "<ExtractedFolder>\EDQSS\"

      Where, <ExtractedFolder>\EDQSS\ is the location where the EDQSS setup files have been extracted.
      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 
       
  10. For ExamService service:
    1. Change the directory to the ExamService service setup folder with the following command:
      cd "<ExtractedFolder>\Exam\"

      Where, <ExtractedFolder>\Exam\ is the location where the ExamService service setup files have been extracted.
      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 ExamService service.
      ./setup.ps1 -Credential $c -PropertiesFilePaths $p 
       
  11. For ItemBank service:
    1. Change the directory to the ItemBank service setup folder with the following command:
      cd "<ExtractedFolder>\ItemBank\"

      Where, <ExtractedFolder>\ItemBank\ is the location where the ItemBank service setup files have been extracted.
      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 ItemBank service.
      ./setup.ps1 -Credential $c -PropertiesFilePaths $p 
       
  12. For User service:
    1. Change the directory to the User service setup folder with the following command:
      cd "<ExtractedFolder>\User\"

      Where, <ExtractedFolder>\User\ is the location where the User service setup files have been extracted.
      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 User service.
      ./setup.ps1 -Credential $c -PropertiesFilePaths $p 
       
  13. For Project service:
    1. Change the directory to the Project service setup folder with the following command:
      cd "<ExtractedFolder>\Project\"

      Where, <ExtractedFolder>\Project\ is the location where the Project service setup files have been extracted.
      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 Project service.
      ./setup.ps1 -Credential $c -PropertiesFilePaths $p 
       
  14. For Assignment service:
    1. Change the directory to the Assignment service setup folder with the following command:
      cd "<ExtractedFolder>\Assignment\"

      Where, <ExtractedFolder>\Assignment\ is the location where the Assignment service setup files have been extracted.
      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 Assignment service.
      ./setup.ps1 -Credential $c -PropertiesFilePaths $p 
       
  15. For Question service:
    1. Change the directory to the Question service setup folder with the following command:
      cd "<ExtractedFolder>\Question\"

      Where, <ExtractedFolder>\Question\ is the location where the Question service setup files have been extracted.
      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 Question service.
      ./setup.ps1 -Credential $c -PropertiesFilePaths $p 
       
  16. For Notification service:
    1. Change the directory to the Notification service setup folder with the following command:
      cd "<ExtractedFolder>\Notification\"

      Where, <ExtractedFolder>\Notification\ is the location where the Notification service setup files have been extracted.
      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 Notification service.
      ./setup.ps1 -Credential $c -PropertiesFilePaths $p 

  17. Run the Admin Password Encryption utility as detailed here.
  18. Run the Go Live script as detailed here.

 

 

Return to the top of the page.

 Update SQL Server Report .RDL files.

 Upgrade to another version.

 Software upgrade process home page.

  • No labels