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 3 Next »

 Upgrade to another version.

 Update SQL Server Report .RDL files.

 Software upgrade process home page.
 

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\ and open it with a suitable text editor such as Notepad and modify the following values:
    • LOG_ROOT_DIR=C:\Logs\
      This is the folder location where the log files of all the microservices will be stored.
    • EDRS_OUTPUT_DIR=C:\ExamDeveloper\AppData\ExamDeveloper\Reports\
      This is the value of the "EdrsOutputDirectory" specified in the ExamDeveloper appSettings.config.
    • DATA_ROOT=C:\ExamDeveloper\AppData\ExamDeveloper\
      This is the "DataRoot" location from the ExamDeveloper appSettings.config.
    • USE_SSL=true
      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_SERVER=https://examdevlicense.pearson.com/server/checklicense.aspx
      This is the license server URL.
    • 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"
      This is the connection string for the ExamDeveloper database as in step 9 of Configure ExamDeveloper.
    • SIMILARITY_CONNECTION_STRING="Data Source=WIN-VSGF1NBSVPB;Initial Catalog=Similarity;Persist Security Info=True;User ID=Similarity;Password=P@s$w0rd"
      This is the Similarity connection string as in step 4 and step 6 of Creating new databases for Similarity and Hangfire.
    • HANGFIRE_CONNECTION_STRING="Data Source=WIN-VSGF1NBSVPB;Initial Catalog=Hangfire;Persist Security Info=True;User ID=Hangfire;Password=P@s$w0rd"
      This is the Hangfire connection string as in step 3 and step 6 of SQL Server user management for Similarity and Hangfire.
    • MATH_EDITOR=wiris
      This specifies that WIRIS MathML editor is going to be used. Leave this blank if using the default (FMath) MathML editor.
    • WIRIS_IMAGE_SERVICE_HOST=www.WIRISServiceHost.com/WirisServerComponent
      This specifies WIRIS image service host name if WIRIS MathML editor is going to be used as detailed here. Leave this blank if using the default (FMath) MathML editor.
    • ENABLE_NEW_EMAILFORMAT=false
      ???
    • WEBSITE_NAME=ExamDeveloper
      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
      Ths is the mail account on your server to be used to send mail from ExamDeveloper. This should be set to examdeveloper@pearson.com.
    • SUPPORT_EMAIL=examdeveloper@pearson.com
      This is the mail account on your server, where all the support mail sent by the clients should be received. This should be set to examdeveloper@pearson.com.
    • ENABLE_AUTOLOG_EMAIL=1
      ??? 
    • MAIL_SERVER=localhost
      This is the address of mail server, which will be used by the application.
    • MAIL_PORT=25
      This is the port of the outgoing mail.
    • MAIL_USERNAME=support
      This is the administrative username used to log into the mail server.
    • MAIL_PASSWORD=mailP@s$
      This is the password for the administrative username used to log into the mail server.
    • WEB_DOMAIN=ED-URL
      This is the domain name of the server where ExamDeveloper is installed.
    • APP_DOMAIN=app-URL
      This is the domain name of the server where all the microservices are installed.
    • WEB_PROTOCOL=https
    • WEB_RELATIVE_URI=ExamDeveloper
    • APP_PROTOCOL=https
    • APP_RELATIVE_URI_PREFIX=
    • CAS_URL=
    • PREVIEW_URL=
    • BASIC_AUTH_USER_NAME=examDeveloper
      This is the API login username.
    • BASIC_AUTH_PASSWORD=Dummy_Password
      This is the API login password.
    • RABBIT_ADDRESS=rabbitmq://RabbitMQ-URL/ExamDeveloper
      This is the RabbitMQ virtual host address as detailed in step 1 of Create a new Virtual Host.
    • RABBIT_USER=ExamDeveloper
      This is the username of the RabbitMQ user with access to the above virtual host as created in Create a RabbitMQ user for EDRS.
    • RABBIT_PASSWORD=Password
      This is the password of the RabbitMQ user with access to the above virtual host as created in Create a RabbitMQ user for EDRS.
    • REPORT_SERVER_URL=https://WIN-VSGF1NBSVPB:80/ReportServer
      This is the Report Server Web Service URL shown on the Web Service URL tab of the Reporting Services Configuration Manager as in step 9 of Configure ExamDeveloper.
    • REPORT_SERVER_DOMAIN_NAME=WIN-VSGF1NBSVPB
      This is domain property specifies the domain or realm to which the user name belongs. Typically, this is the host computer name where the reporting services runs or the user domain for the user configured.
    • REPORT_SERVER_USER_NAME=edReporting
      This is the administrative username used to log into the Report Manager, in step 8 of Setting up Reporting Services application folder.
    • REPORT_SERVER_PASSWORD=Password123
      This is the password for the administrative username used to log into the Report Manager, in step 8 of Setting up Reporting Services application folder.
    • ELASTIC_ADDRESS=http://localhost:9200/
      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