View source for Upgrading v1.93 to v1.94


= Upgrading v1.9.3 to v1.9.4 =

&nbsp;

#Make a backup of the existing installation, especially the web.config file. 
#You can maintain the existing IIS application and configuration; no changes in .NET framework or any other IIS configuration needs to be altered. 
#The upgrade package includes the following: 
<pre style="margin-left: 80px">2020-02-18  04:39 PM    <DIR>          bin
2020-02-18  04:39 PM    <DIR>          Content
2020-02-18  04:39 PM    <DIR>          CSS
2020-02-18  04:39 PM    <DIR>          Images
2020-02-18  04:39 PM    <DIR>          Views
2019-07-30  03:47 PM               495 ContextMode4.aspx
2019-01-13  08:02 PM             1,279 ContextMode5.aspx
2018-02-24  02:04 PM            32,038 favicon.ico
2019-01-13  08:02 PM             1,717 FormLogin.aspx
2019-01-13  08:02 PM             1,704 FormLogout.aspx
2019-01-13  08:02 PM             1,253 generate_license.txt
2018-01-09  07:17 AM               868 LICENSE.txt
2019-01-13  08:02 PM               119 metadata.aspx
2020-02-17  03:05 PM             1,601 packages.config
2020-02-18  04:39 PM                49 PrecompiledApp.config
2020-02-18  08:02 PM             1,778 upgrade.txt</pre>

&nbsp;
<ol start="4">
<li>You should delete the corresponding folders and files in the current installation.&nbsp; It is recommended that a delete is performed first instead of an overwrite.&nbsp; This is due the dependencies that may exist with the DLL files in the /bin folder.&nbsp; Keeping old versions of DLLs may cause version conflicts.</li>
<li>Make sure you do not remove the following:</li>
</ol>
<ul style="margin-left: 40px;">
<li>&nbsp;&nbsp; &nbsp;/certificates folder (or alternate location)</li>
<li>&nbsp;&nbsp; &nbsp;/logs folder (or alternate location)</li>
<li>&nbsp;&nbsp; &nbsp;/start folder</li>
<li>&nbsp;&nbsp; &nbsp;/app_data folder (if exists)</li>
<li>&nbsp;&nbsp; &nbsp;/web.config file</li>
</ul>
<ol start="6">
<li>Stop the IIS site temporarily as there may be file locks in place.</li>
<li>Wait a few seconds.</li>
<li>Copy the contents of the ZIP package into the folder where STS was located.</li>
<li>Update the web.config with the following elements: <ol start="1" style="list-style-type: lower-alpha;">
<li>Update the version:</li>
</ol> </li>
</ol>
<pre>    
     <STSSettings Version="v1.93" ...
     change to:
     <STSSettings Version="v1.94" ...</pre>
<ol start="2" style="list-style-type: lower-alpha;">
<li>&nbsp;&nbsp; Add the new parameters "ClearSession" and "PrimaryADGroupCheck""</li>
</ol>
<pre>     <STSSettings Version="v1.93" ConfigurationDatabase="~/App_Data/Orbital.sqlite" ...
     update to:
     <STSSettings Version="v1.94" ConfigurationDatabase="~/App_Data/Orbital.sqlite" ClearSession="false" PrimaryADGroupCheck="false" ...</pre>
<ol start="3" style="list-style-type: lower-alpha;">
<li>&nbsp;&nbsp;&nbsp; Add the new parameter "TokenTimeSpan" in each SAMLConfiguration element:</li>
</ol>
<pre>  
      <SAMLConfigurationElement Service="MyService" AssertingParty="sts.hospital.org" ...
      update each SAMLConfigurationElement to:
      <SAMLConfigurationElement Service="MyService" AssertingParty="sts.hospital.org" TokenTimeSpan="2" ...</pre>
<ol start="4" style="list-style-type: lower-alpha;">
<li>&nbsp;&nbsp; &nbsp;&nbsp; Update the entire Runtime section:</li>
</ol>
<pre>        <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Web.Optimization" publicKeyToken="31bf3856ad364e35"/>
        <bindingRedirect oldVersion="1.0.0.0-1.1.0.0" newVersion="1.1.0.0"/>
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Web.Helpers" publicKeyToken="31bf3856ad364e35"/>
        <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="2.0.0.0"/>
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="WebGrease" publicKeyToken="31bf3856ad364e35" culture="neutral"/>
        <bindingRedirect oldVersion="0.0.0.0-1.5.2.14234" newVersion="1.5.2.14234"/>
      </dependentAssembly>
    </assemblyBinding>
  </runtime></pre>

&nbsp; replace with the following:
<pre>   <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
            <dependentAssembly>
                <assemblyIdentity name="Antlr3.Runtime" publicKeyToken="EB42632606E9261F" culture="neutral"/>
                <bindingRedirect oldVersion="0.0.0.0-3.5.0.2" newVersion="3.5.0.2"/>
            </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Web.Optimization" publicKeyToken="31bf3856ad364e35"/>
        <bindingRedirect oldVersion="1.0.0.0-1.1.0.0" newVersion="1.1.0.0"/>
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="WebGrease" publicKeyToken="31bf3856ad364e35" culture="neutral"/>
        <bindingRedirect oldVersion="0.0.0.0-1.5.2.14234" newVersion="1.5.2.14234"/>
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Web.Helpers" publicKeyToken="31bf3856ad364e35"/>
        <bindingRedirect oldVersion="1.0.0.0-3.0.0.0" newVersion="3.0.0.0"/>
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Web.WebPages" publicKeyToken="31bf3856ad364e35"/>
        <bindingRedirect oldVersion="1.0.0.0-3.0.0.0" newVersion="3.0.0.0"/>
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35"/>
        <bindingRedirect oldVersion="1.0.0.0-5.2.7.0" newVersion="5.2.7.0"/>
      </dependentAssembly>
      <dependentAssembly>
        <assemblyIdentity name="System" publicKeyToken="b77a5c561934e089" culture="neutral"/>
        <bindingRedirect oldVersion="0.0.0.0-4.0.0.0" newVersion="4.0.0.0"/>
      </dependentAssembly>
    </assemblyBinding>
  </runtime></pre>

&nbsp;
<ol start="10">
<li>Start the IIS site</li>
<li>Launch the web application to test and verify that the log files display no errors.</li>
</ol>

&nbsp;

&nbsp;