Optimizely uses NuGet for handling Optimizely Content Management System (CMS) applications (apps, sometimes called add-ons) in a standard package format. You can install apps directly from Visual Studio or via the Add-on user interface.
See the App Directory, (Browse Apps & Integrations), your one-stop shop to find apps and integrations to your Optimizely products that increase productivity and streamline processes to save you time and money.
For Azure environments, install app modules only through Visual Studio (and not from the Optimizely Add-ons interface).
Configure your choice of installation approach in the configuration file as described below.
UI. You should install, upgrade, manage, and uninstall add-ons from Visual Studio or the user interface but not both, because an add-on may not work as expected. For example, if you install an app from Visual Studio, it appears in the app (add-on) user interface, but operations (like disable and uninstall) may be unavailable.
installationModewas set to
UI, run the cmdlet
Convert-EPiAddonsin the Package Manager Console. This converts existing apps installed with the user interface to Visual Studio format.
https://nuget.episerver.com/feed/packages.svc/as a NuGet source.
- Install and upgrade apps as normal via Visual Studio.
modules/\_protected folder contains a
repository.config file, which is created during add-on system initialization. If the server was hardened, IIS does not have write access to the
\_protected folder, and the site does not launch (you get an access denied message). To resolve the problem, give IIS_IUSRS modify rights to the
Each web server in a load-balanced environment has a repository.config file. The file contains a unique repository GUID. The app system allows for the execution of custom code when an app is installed, updated, or about to be uninstalled. The app system uses the GUID to verify that the custom code is executed on all servers. When deploying multiple sites, it is a good idea to copy a generated repository.config file (per machine) as part of the deployment.
Because each server's repository.config file has a unique GUID, do not commit the file to source.
You can install apps from the add-on user interface without access to Visual Studio. To install add-on packages, you must be a member of the PackagingAdmins user group and have access to the Optimizely user interface.
- Set installationMode to UI:
In Optimizely, select Add-ons (apps) in the global menu. From here, you can install any available app (add-on). Optimizely does the following:
- Optimizely adds packages to a temporary repository.
- Optimizely tries to resolve dependents, and dependencies, and install the packages to the application from the temporary repository combined with the other repositories.
- Optimizely validates uploaded files and selected add-ons if they are valid NuGet packages marked with proper module tags:
- After installing a package to the repository, you can instantiate it to any number of applications.
The following list shows the package source repositories:
- Optimizely central repository
- The temporary repository
- The site local repository
Optimizely uses the temporary repository in conjunction with the virtual packages to resolve dependencies before installation, representing available assemblies on the site and the local repository. By default, the operating system designates the location of the temporary repository directory. To change the directory, change the value of the
packagesTemporaryFolder attribute in the
Optimizely sets up the site directory,
C:\\EPiServer\<SiteName>\\wwwroot\\modules, with correct access rights when you install Optimizely Framework from the Optimizely Deployment Center. Optimizely adds installed packages to the site local repository. To change the directory, change the value of the
repositoryPath attribute on the
Make sure that the web application has write access rights for the specified directory.
You can add repositories to the configuration, as shown in the following example:
<episerver.packaging> <packageRepositories> <add name="Gallery" url="\\server\Your\Packages\Folder" /> </packageRepositories> </episerver.packaging>
Installed apps are registered in the file in the site root. Optimizely copies supported files to the corresponding app folder in the ~/modules/ directory. See the description for the
episerver.packagingelement in episerver.packaging (Legacy).
Optimizely copies app assemblies compatible with the current framework version to the probing path directory, which is located at
C:/EPiServer/\<SiteName>/wwwroot/. The probing path directory must be available at this location, and you define it in the
probingPath attribute in the
configuration/episerver.framework/scanAssembly element. You should configure the same path in the
privatePath attribute of probing element:
<episerver.framework> <scanAssembly forceBinFolderScan="true" probingPath="modulesbin" />
<runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <probing privatePath="modulesbin" />
After you install app packages, installation results display with information about whether you must restart the site (if ASP.NET does not automatically restart it). Site restart is required to load and scan new assemblies and initialize installed apps.
The Updates tabs shows available updates for installed apps. When you upgrade an app, the old version is uninstalled and the new version is installed. The update process also updates related apps (dependencies and dependents).
After upgrade, some apps may become incompatible, and the site might not start. You can disable installed apps from the user interface so they do not block the user interface. Disable an app (such as EPiServer.Cms.AddOns.Blocks in the following example) in the site's configuration file:
<episerver.framework> <scanAssembly> <add assembly="*" /> <remove assembly="EPiServer.Cms.AddOns.Blocks" /> </scanAssembly> <!-- other settings --> </episerver.framework>
The Installed tab shows installed apps (add-ons). You can uninstall apps from here, except for system apps (such as the management system app, which cannot be uninstalled; only upgraded). Optimizely removes app files and the corresponding Shell module folder during uninstallation, and deletes assemblies from the probing path directory. Optimizely restarts the site to complete the uninstallation procedure and to unload app assemblies from the application domain.
Updated 3 days ago