TechCello 4.4 to 4.5 Migration(OAuth logon)

  • Uninstall the CelloSaaS old Version and install the new version.
  • Create a sample application with new CelloSaaS4.5 version.
  • Run the migration script from CelloSaaS package (DBScripts\SQL Server Scripts\4.4 to 4.5 migration script.sql) in your DB. Run the migration script with Commit transaction from rollback transaction after successful execution.
  • Copy the following files from sample application into your application if you didn’t change anything in CelloSaaS Application. If you have done any changes in the existing application, then you need to carry forward those changes manually to the new application.  
    • API
    • App_Data
    • App_GlobalResources
    • App_Start [Please check and merge with your current files]
    • App_Themes
    • Config [Please check and merge with your current files]
    • Content [Please check and merge with your current files]
    • Controller
    • Models
    • Modules
    • Script [Please check and merge with your current files]
    • Services
    • Startup.cs
    • Views
    • Unity.Config [Please check with your current files]
    • Global.ascx [Please check with your current files]
    • Web.Config [Please check with your current files]
    • Web.Sitemap [Please check with your current files]
  • Replace all the DLL's inside the CelloSaaS Dlls with new Dlls.
  • Include all the new items in the project file.[Note: Some folders containing subfolders should be copied along with them.]
  • Update the newly upgraded DLL versions given below.
    • Log4net.dll(1.2.13)
    • NewtonSoft.dll(6.0.2.16931)
    • System.Net.Http.Formatting.dll(5.2.20627)
    • System.Web.Helpers.dll(3.0.20627)
    • System.Web.Http.dll(5.2.20627)
    • System.Web.Http.Webhost.dll(5.2.20627)
    • System.Web.Mvc.dll(5.2.20627)
    • System.Web.Razor.dll(3.0.20627)
    • System.Web.WebPages.Deployment.dll(3.0.20627)
    • System.Web.WebPages.dll(3.0.20627)
    • System.Web.WebPages.Razor.dll(3.0.20627)
    • Add new References in your project which are given below.
    • Microsoft.AspNet.Identity.Core.dll
    • Microsoft.AspNet.Identity.Owin.dll
    • Microsoft.Owin.dll
    • Microsoft.Owin.Host.SystemWeb.dll
    • Microsoft.Owin.Security.Cookies.dll
    • Microsoft.Owin.Security.dll
    • Owin.dll
    • System.Identity.Model.Token.Jwt.dll
    • System.Web.Core.dll
    • System.Web.Http.Core.dll
    • CelloSaaS.DbAnalytics.dll
    • CelloSaaS.RestApiSDK.dll
    • CelloSaaS.MultiTenancyEnablement.dll

AuthServer Configuration

To get started with the OAuth logon the AuthServer has to be deployed on IIS Server and configured appropriately. To deploy the AuthServer refer the AuthServer documentation here. Update the AuthServer settings by following the next instructions.

  • Open authServerConfig.json from Config folder and change the following key values in Oauth Server
    • Audience - OAuth hosted address(eg: http://cello.identity.com or http://localhost:1200)
    • AuthIssuer - OAuth hosted address(eg: http://cello.identity.com or http://localhost:1200)
    • ClientApplicationUri - CelloWeb hosted address(eg: www.celloapp.com or http://localhost:1400)
  • Open AppSettings.config from CelloWeb\Config and change the following key values in CelloWeb
    • AuthServerUri - OAuth hosted address(eg: http://cello.identity.com or http://localhost:1200)
    • AuthIssuer - OAuth hosted address(eg: http://cello.identity.com or http://localhost:1200)


Note: By default CelloSaaS4.5 will support the OAuth Logon. To support the internal Login do the following changes.


TechCello 4.4 to 4.5 Migration(Using the internal logon)

  • After implementing the changes instructed in the 4.5 migration the following additional changes have to be made.
  • Uncomment the classes in AccountController_Internal.cs, HomeController_Internal.cs and TenantSelfRegistrationController_Internal.cs from Controllers folder and migrate with your project Controllers.
  • Replace/Migrate the following files in your application.
    • Views\Account\LogOn_Internal.aspx
    • Config\AppSettings_Internal.config
    • Web_Internal.Config

 

Note: List of new files and folder added in CelloSaaS 4.5 is given below for your reference.

New Folders

  • Api
  • Areas\HelpPage
  • Services
  • View\ClientDetails
  • View\DatabaseAnalytics
  • View\MultiTenancyEnablement

New Files

  • App_Data\ApiXmlDocument.xml
  • App_GlobalResources\DatabaseAnalyticsResource.resx
  • App_GlobalResources\MultiTenancyEnablementResource.resx
  • App_GlobalResources\Web.sitemap.resx
  • App_GlobalResources\Web.sitemap.hi.resx
  • Config\log4net.config
  • Content\HelpPage.css
  • Controllers\ClientDetailsController.cs
  • Controllers\DataBaseAnalyticsController.cs
  • Controllers\MultitenancyEnablementController.cs
  • Models\ClientDetailsDTO.cs
  • Models\DBMigrationException.cs
  • Models\DTODataviewConfiguration.cs
  • Models\Helpers.cs
  • Models\MultiTenancyConnectionStringHelper.cs
  • View\Account\Error.cshtml
  • View\MySetting\AuthSetting.ascx
  • View\MySetting\UserAuthSetting.ascx
  • View\Shared\_layout.cshtml
  • View\Shared\LDAPEndPointConfig.ascx
  • \Startup.cs