Upgrading and uninstalling

For SharePoint Server 2019 and 2016, use the package for your version (Virto.SharePoint.2019.Tabs.zip or Virto.SharePoint.2016.Tabs.zip) in the steps below instead of the SE package, and Setup2019 or Setup2016 instead of SetupSE. SharePoint 2016 has no modern web part, so skip the App Catalog steps there.

You upgrade and uninstall Virto Tab Navigation with the setup program (SetupSE.exe or Setup.exe). On large farms, you can upgrade with the Deploy.ps1 script from the new package; it can’t remove the product, so you remove it with the standard SharePoint cmdlets. Run the setup program and the shell under a farm administrator account.

Upgrading#

Download the new Virto.SharePoint.SE.Tabs.zip package and extract it with Extract All. Right-click SetupSE and select Run as administrator.

After the system checks, the wizard detects that another version of Virto Tab Navigation is installed and offers three operations:

• Upgrade: upgrades Virto Tab Navigation on all front-end web servers in the SharePoint SE farm.
• Remove: retracts the solution from all web applications and deletes it from the SharePoint solution store.
• Reinstall: removes the current version, then installs the new one.

Select Upgrade and click Next.

Wait until the wizard shows “All operations successfully completed”, then click Close.

Upgrading with PowerShell#

Open the SharePoint Management Shell as administrator, go to the Virto.SharePoint.Tabs.Setup folder of the new package, and call Install-WebPart as for a new installation. When the solution is already deployed, the function updates it to the new package and waits until the update finishes:

cd C:\Install\Virto.SharePoint.Tabs.Setup
. .\Deploy.ps1
Install-WebPart -wspPath "C:\Install\Virto.SharePoint.Tabs.Setup\Virto.SharePoint.Tabs.wsp" -webAppURL "http://sharepoint"

If the update fails, the function shows the reason. When a new version renames its features, the update can fail: use the setup program then, it handles the renaming.

You can also update the solution with the standard SharePoint cmdlets:

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue
Update-SPSolution -Identity Virto.SharePoint.Tabs.wsp -LiteralPath "C:\Install\Virto.SharePoint.Tabs.Setup\Virto.SharePoint.Tabs.wsp" -GACDeployment

The upgrade runs as a timer job. Wait until (Get-SPSolution Virto.SharePoint.Tabs.wsp).JobExists returns False.

Deploy.ps1 doesn’t update Virto License Manager: run the setup program in the Virto.WebLicenseManager folder of the new package when the product asks for a newer License Manager.

To upgrade the modern web part, open Apps for SharePoint in your App Catalog, upload virto-tabs-navigation.sppkg from the new package to replace the current one, and deploy it.

Uninstalling#

Modern web part#

On each site where Virto Tab Navigation is added, go to Settings > Site contents, click … next to Virto Tabs Navigation, and select Remove.

Removing the package#

Right-click SetupSE in the package of the installed version and select Run as administrator. After the system checks, the wizard detects that Virto Tab Navigation is already installed and offers two operations:

• Repair: retracts the solution from all web applications and deploys it once again.
• Remove: retracts the solution from all web applications and deletes it from the SharePoint solution store.

Select Remove and click Next.

Wait until the wizard shows “All operations successfully completed”, then click Close.

Removing the package with PowerShell#

Deploy.ps1 can’t remove the product. Open the SharePoint Management Shell as administrator and run the following commands. They deactivate the Virto Tabs Navigation feature in every site collection where it’s active, retract the solution from all web applications, and delete it from the solution store:

Add-PSSnapin Microsoft.SharePoint.PowerShell -ErrorAction SilentlyContinue
$solution = "Virto.SharePoint.Tabs.wsp"
$feature  = "3acaffa2-c7d8-41be-88c9-3fc005dbeb8c"

Get-SPSite -Limit All | Where-Object { $_.Features[[Guid]$feature] } | ForEach-Object {
    Disable-SPFeature -Identity $feature -Url $_.Url -Confirm:$false
}

Uninstall-SPSolution -Identity $solution -AllWebApplications -Confirm:$false
while ((Get-SPSolution $solution).JobExists) { Start-Sleep 1 }
Remove-SPSolution -Identity $solution -Confirm:$false

Removing the modern package from the App Catalog#

The setup program and Deploy.ps1 only add virto-tabs-navigation.sppkg to the App Catalog and don’t remove it. After you remove the product, open Apps for SharePoint in your App Catalog and delete Virto Tabs Navigation.