• Webinars
  • Docs
  • Download
  • Blogs
  • Contact Us
Show / Hide Table of Contents
  • Administrator's Guide
  • NCache Architecture
    • Cache Topologies
    • Cache Cluster
    • Local Cache
    • Cache Client
    • Client Cache
    • Data Load Balancing
    • Cache Server Backward Compatibility
    • Client Backward Compatibility
    • Eviction
    • Indexing
    • Runtime Data Sharing
    • Portable Data Types
    • Class Versioning
    • IP Binding with Multiple NICs
    • Graceful Node Down
    • Separate Cache Host Process
    • Self Healing Dynamic Clustering
  • Configuring Caches
    • Create Cache
      • Creating Local Cache
        • Create New Cache
        • Add Existing Cache
      • Creating Clustered Cache
        • Create New Cache Cluster
        • Add Existing Cache Cluster
    • Remove Cache
    • Clear Cache Contents
    • Adding Server Node in Cache Cluster
    • Removing Server Node from Cache Cluster
    • Configuring Basic Cache Settings
      • Cache Size
      • Cache Isolation Levels
      • Cache Data Expiration
      • Cache Data Format
    • Configuring Cache Cluster Settings
      • Ports
      • Operation Timeout
      • Static Replication Interval
      • Connection Retries
      • Retry Interval
    • Add Test Data to Cache
    • Deploy Providers
    • Configuring Query Indexes
    • Registering Classes for Compact Serialization
      • Registering Non-Generic Classes
      • Unregistering Non-Generic Classes
      • Registering Generic Classes
      • Registering Generic Classes Using Generic Type Handler
    • Registering Classes for Portable Data Sharing
    • Configuring Data Source Providers
      • Read-Through Provider
      • Write-Through Provider
      • Write-Through Provider for Write-Behind Operations
    • Configuring Cache Startup Loader
    • Configuring Cache Level Events
    • Configuring Cache Activity Events
    • Configuring Eviction Policy
    • Configuring Compression
    • Configuring Email Notifications
    • Binding Cluster and Client/Server IP with Multiple NICs
      • Binding Cluster with a Dedicated IP
      • Binding Client/Server with a Dedicated IP
    • Configuring Heartbeat
    • Configuring MapReduce
    • Configuring Communication Reliability
    • Auto Start Cache on Boot
    • Nagling
    • Dual Socket
    • Error Logging
    • Configuration Files
      • Client Side Configurations
        • Client Config
        • EFCaching Config
      • Server Side Configurations
        • Cache Config
        • Bridge Config
        • Security Config
      • Cache Server Configuration
  • Management Operations
    • Start Cache
    • Stop Cache
    • Restart Cache
    • Manage Cache Service on a Server Node
    • Apply Configuration
    • Hot Apply Configuration
    • Reset Configuration
    • Data Load Balancing
  • Configuring Cache Clients
    • Adding Client Node in Cluster
    • Removing Client Node from Cluster
    • Configuring Client Node Settings
    • Creating Client Cache
    • Enable Client Cache on Client Nodes
    • Disable Client Cache on Client Nodes
    • Removing Client Cache
    • Configuring Client Cache Settings
  • Configuring Security
    • Configuring Security for Cache Management
    • Configuring Security for Cache
    • Configuring Security for Client Nodes
    • Configuring Encryption for Cache
    • Configure SSL/TLS Encryption in NCache
  • Configuring Bridge for WAN Replication
    • Creating Clustered Bridge
    • Adding Clustered Caches to Bridge
    • Configuring Bridge Settings
    • Configuring Conflict Resolver
    • Changing Cache Syncronization Modes
    • Configuring Master Cache
    • Force State Transfer
    • Connect/Disconnect Cache in Bridge
    • Remove Cache from Bridge
    • Bridge Management
  • NCache on Docker
    • Using NCache Docker Images
    • Customize NCache Dockerfile
  • Monitoring NCache
    • Cache Counters
    • Monitoring Caches using NCache Manager
      • Changing Management Port of Cache Node
      • Configuring Counters to Display
      • Browse Cache Statistics
      • Cluster Health
      • Monitoring Cache Clusters using NCache Email Alerts
    • Monitoring Caches using NCache Monitor
      • Monitoring with Built-In Dashboard
      • Monitoring with Custom Dashboard
    • Monitoring Bridge using NCache Manager
    • Monitoring NCache using Windows PerfMon Tool
      • Monitoring Cache Server Counters Using PerfMon
      • Monitoring Cache Client Counters Using PerfMon
      • Monitoring Bridge Counters Using PerfMon
    • Logging in NCache
      • NCache Log Viewer
      • NCache Monitor Logging
      • Performance Counters Logging
      • Windows Event Logging
      • Email Notifications on NCache Events
      • Cache Server Logging
      • Client Side API Logging
      • Cache Event IDs
    • Troubleshooting NCache Monitoring
      • Computer Name Not Found
      • Diskperf Not Installed
      • No READ Access to the Perflib Subkeys
      • Unable to Connect to Remote Server
    • IPV6 Support
  • Upgrading NCache Versions
    • Live Upgrade NCache Version
    • Upgrade NCache Version Offline
  • Apply Windows Patches on NCache Server

Upgrade NCache Version Offline

If you do not want to live upgrade NCache, you can upgrade it through the previous conventional method:

Create Backup of config.ncconf (Optional)

If you are upgrading a major version of the NCache, then in order to restore old configurations you need to create a backup of config.ncconf file to restore old configurations. However, it is recommended to use new configuration settings in case of major version upgrade. Also refer back to the backup config.ncconf to see what options you have already configured in order to have exactly same configuration settings again. Backup of log files can also be kept for history purposes.

Uninstall NCache

Uninstall current version of NCache. If any application is using NCache and you uninstall NCache, an error message will be displayed as shown below.

Here you will have to remove the assemblies manually:

  • Remove .NET Framework 2.0 assemblies from [System Drive]:\Windows\assembly.

  • Remove .NET Framework 4.0 assemblies from [SystemDrive]:\Windows\Microsoft.NET\assembly.

  • For NCache 3.8 remove assemblies manually e.g.

  1. `[SystemDrive]:\Windows\Microsoft.NET\assembly\GAC_32\Alachisoft.NCache.Web\v4.0_3.8.0.0__cff5926ed6a53769\Alachisoft.NCache.Web.dll`
  2. `[SystemDrive]:\Windows\Microsoft.NET\Assembly\GAC_64\Alachisoft.NCache.Web\v4.0_3.8.0.0__cff5926ed6a53769\Alachisoft.NCache.Web.dll`
  • For NCache 4.3 and above, remove assemblies manually from [SystemDrive]:\Windows\Microsoft.NET\assembly\GAC_MSIL e.g.
  [SystemDrive]:\Windows\Microsoft.NET\Assembly\GAC_MSIL\Alachisoft.NCache.Web\v4.0_4.6.0.0__cff5926ed6a53769\Alachisoft.NCache.Web.dll`

Install New Version

Install new version of NCache. For complete step by step installation process see Installation Guide.

Verification

After installation you can verify whether NCache has been installed correctly or not by using some command line tools such as:

  • startcache mycache will start default shipped cache ‘mycache’.

  • addtestdata mycache will add 10 items in the cache ‘mycache’, if cache is already started.

  • getcachecount mycache will return the number of total item exist in cache i.e. ‘mycache’.

  • listcaches will show all the created caches on current machine.

Recompile Application

If you are using object caching, you have to recompile your application. And if you are using View State caching or session state caching then you may have to change version manually from Web.config file, generally their versions are not changed. But still it can be changed from Web.config file, for example:

Enterprise Edition:

<assemblies>
  <add assembly="Alachisoft.NCache.SessionStoreProvider, Version=x.x.x.x, Culture=neutral, PublicKeyToken=CFF5926ED6A53769"/>
</assemblies>

Community and Open Source Editions:

<assemblies>
  <add assembly="Alachisoft.NCache.SessionStoreProvider, Version=x.x.x.x, Culture=neutral, PublicKeyToken=1448e8d1123e9096"/>
</assemblies>
Note

Replace Version=x.x.x.x with the NCache version that you have installed.

Similarly, if you are using NCache SessionStore provider module or content optimization feature then you need to follow the same process. Find Alachisoft.NCache.* and change Version=x.x.x.x with the current version of the NCache module in use.

Note

NCache module version can be different from the NCache version e.g. NCache's current release version is “4.6.0.0” but its ContentOptimization module version is “x.x.x.x”.

Back to top Copyright © 2017 Alachisoft