How to Migrate a Bamboo Web Part from SharePoint 2007 to SharePoint 2010 using the In-Place Upgrade Method

When you run an in-place upgrade from SharePoint 2007 to SharePoint 2010, the configuration data for the farm and all the content in the farm is upgraded on the existing hardware, in a fixed order. When you start the in-place upgrade process, Setup takes the Web server offline and the Web sites are unavailable until the upgrade is finished, and then Setup restarts the Web server.

Using the In-place Upgrade method, the following Bamboo products migrate to SP2010 with no errors or additional steps:

Alert Plus
Alerts Administrator
Chart Plus
Cross List
Column Level Security
Custom Identifier Column
Group Redirect
Group Email
In/Out Schedule Board
KPI Column
List Consolidator

List Rollup
List Search Simple
List Search Advanced
Lookup Selector Column
Mini-Calendar
My Alerts Organizer
Navigators
Password Expiration
Poll
Tree View
Site Creation Plus

Rich Text Column
Visual Indicator Column
Validator Column
Video Library
Task Master
User Manager for Sites
User Redirect
Virtual Map View
Wiki Publisher
World Clock and Weather

NOTE: If you are using a Bamboo product that is not on the above list and you are considering using the In-Place Upgrade method to migrate your farm, refer to the specific migration information for your product to learn more about possible limitations before proceeding with a migration.

Step	Action
1.	Follow Microsoft’s Upgrade In Place to SharePoint 2010 article to perform the in-place upgrade. NOTE: When running the SharePoint Products Configuration Wizard, be sure to select the option Change existing SharePoint sites to use the new user experience. Administrators control the user experience for end users and can decide which sub-option is then selected in this step.
2.	During the upgrade process or before, retrieve the installation package and license keys for the SharePoint 2010 version of the Bamboo products you are migrating. See Migrate My Existing Bamboo Product License Key From SharePoint 2007 to SharePoint 2010 for additional details.
3.	After successfully upgrading to SharePoint 2010 and after all sites have completed their conversion to the new user experience, run the SharePoint 2010 Bamboo product installation package that you retrieved in Step 2. On the Repair, Remove or Install screen, choose to Upgrade/Repair Existing and Install New. For more information, refer to Upgrading your Bamboo Web Part.
4.	Select and upgrade the Bamboo Web License Manager component provided in the same installation package. On the Repair, Remove or Install screen, choose to Upgrade/Repair Existing and Install New. NOTE: The Bamboo Web License Manager only needs to be installed once per farm. Skip this step for subsequent Bamboo product installations on the farm.
5.	Activate the SharePoint 2010 versions of Bamboo products. See Install and Activate a License for Bamboo Products in SharePoint 2010 for more information.
6.	Refer to specific migration steps for the Bamboo product(s) you are migrating. There may be some extra steps required to overcome a known migration issue.

How to move your Bamboo Product License to a new server

Overview of Licensing and and Product Activation

You must have a Bamboo product license for each Web Front-end (WFE) server in the SharePoint farm that serves web content. If you replace a server with another physical device, you can move the license from the old server to a new one. To do so, first deactivate the license and then re-activate by following the instructions below.

Step	Action
1.	Go to Central Administration and under the Bamboo Solutions section, click Manage My License Keys. NOTE: If you are using SharePoint 2007, in Central Administration, go to the Bamboo Solutions Corporation heading on the main page and click Bamboo Web License Manager. Locate the product that you need to deactivate and click the product name link. The license Status Page will be displayed. Each server that is licensed for that product is listed on the page. NOTE: If the License Key is not listed on the license status page, see Is there a way to find a lost or unknown Bamboo product license key.
2.	In the Status Page, copy the license key from the server that will be deactivated to a safe location so you can use it on the new server (see Step 4 below). Then, click the Active status link. The Activation Page will be displayed.
3.	On the Activation Page, click the Deactivate button. Your license is now deactivated on that server. NOTE: If your SharePoint WFE server doesn’t have access to the Internet, you will not be able to deactivate from this page. However, it is important to deactivate the license. Please see How to deactivate your Bamboo Product License if your server doesn’t have access to the Internet for a way to deactivate from a PC that does have access to the Internet.
4.	When the new server is ready, see Activating Your Bamboo Product License for information about activating the license key for that server. Use the license key you copied to a safe location in Step 2 above to activate the product on the new server.

How to Migrate a Bamboo Web Part from SharePoint 2007 to SharePoint 2010 using the Database Attach Upgrade Method

When you upgrade by using database attach upgrade, you detach the databases in the old farm and then attach them to the new farm. When you attach a database to the new farm, the SharePoint upgrade process runs and upgrades the whole database. The database attach upgrade process is similar to the in-place upgrade process. The difference is that the database attach upgrade process is performed manually, and is performed in a separate environment.

Using the Database Attach Upgrade method, the following products migrate to SP2010 with no errors or additional steps:

Chart Plus
Cross List
Column Level Security
Custom Identifier Column
Data-Viewer
Group Email
Group Redirect

List Search Simple
List Search Advanced
Mini-Calendar
Site Creation Plus
Task Master
Tree View
User Manager for Sites

Password Expiration
User Redirect
Validator Column
Visual Indicator Column
Wiki Publisher
World Clock and Weather

NOTE: If you are using a Bamboo product that is not on the above list and you are considering using the Database Attach Upgrade method to migrate your farm, refer to the specific migration information for your product to learn more about possible limitations before proceeding with a migration.

Step	Action
1.	The first step in the process is to set up a new environment to host the upgraded content. See Prepare the new SharePoint Server 2010 environment for a database attach upgrade for additional information from Microsoft.
2.	After you set up the new environment, use the procedures in Microsoft’s Attach Databases and Upgrade to SharePoint 2010 article to detach and then reconnect the databases to perform the actual upgrade. NOTE: When attaching the databases, you must choose to update to the new user experience. Your Bamboo products will not perform correctly if you choose to remain in the old user experience after upgrade.
3.	During the upgrade process or before, retrieve the installation package and license keys for the SharePoint 2010 release of the Bamboo product(s) you are migrating. See Migrate My Existing Bamboo Product License Key From SharePoint 2007 to SharePoint 2010 for additional details.
4.	After successfully upgrading to SharePoint 2010 and after all databases have been attached and converted, run the SharePoint 2010 Bamboo product installation package that you retrieved in Step 3. Since this will be a new install on new hardware, you will be asked to choose the Web Applications to deploy to. Be sure to select the same Web Applications where the Bamboo product was deployed on the old farm. For more information about installation, refer to How to run the Installation-Setup Program.
5.	Install the Bamboo Web License Manager provided in the same installation package. NOTE: The Bamboo Web License Manager only has to be installed once. Skip this step for subsequent Bamboo product installations.
6.	Activate the SharePoint 2010 versions of Bamboo products. See Activating Your Bamboo Product License for more information.
7.	Refer to specific migration steps for the Bamboo product(s) you are migrating. There may be some extra steps required to overcome a known migration issue.

Manually uninstall using PowerShell

IMPORTANT: As of April 2017, Bamboo no longer includes ManualUninstallation.ps1 file in product download packages. An updated uninstall script is included instead. Please see Overview of the Updated Installation Process for Bamboo components and Uninstalling using the updated process for details.

Typically, Bamboo products are uninstalled from a server simply by selecting the Uninstall button for the product components in the Setup program. If you choose, however, you may also uninstall our products via another simple method. In this article, I will show you how to manually uninstall a Bamboo product with PowerShell.

Step	Action
1.	Access the installation files for the product you want to uninstall. They are usually on the WFE Server where you installed. Go to the Misc folder and locate the file ManualUninstallation.ps1 This is a PowerShell script. NOTE: Not all Bamboo products include a PowerShell script for uninstalling.
2.	Next, open the SharePoint 2013 Management Shell program and Run as administrator:
3.	In the SharePoint 2013 Management Shell, go to the Misc folder of the Bamboo product installation files. Then run the script by entering: `.ManualUninstallation.ps1`
4.	A warning is displayed telling you to do the following before proceeding: Deactivate the site collection feature for the product you are uninstalling. This script does not deactivate the features. They must be deactivated on all site collections where they have been activated. Recycle the App Pool or reset IIS on all WFE servers before continuing.
5.	Press Enter when ready, and the script will start. Wait for it to report Solution Removed Successfully, and then press Enter to exist.
6.	Check that the solution is successfully removed. In Site Collection features, the solution should no longer appear. In Solutions Management in Central Administration, the solution should no longer be listed.
7.	Notice that the Bamboo.Core.v2.wsp solutions remains on the list in Solution Management. This solution is part of other Bamboo products and is left intentionally. If you have no other Bamboo products on your farm, please see What is left behind after uninstalling to learn how to remove the Bamboo.core.v2.wsp also.

How to find the release number of a Bamboo web part

NOTE: Since you need to access the web part tool pane, you must be user with Design permissions on the site in order to determine the web part version.
Not all of Bamboo’s products are Web Parts; some products are custom columns for SharePoint and some are desktop programs, so this information does not apply to those particular components.

Step	Action
1.	Navigate to the SharePoint page where the web part is used. It can be any page, on any site. Because web parts are installed on your farm, the version is the same in all web apps, site collections, and sites.
2.	Access the Web Part’s configuration tool pane. In edit mode (select Edit Page from the Site Actions menu), select Edit web part from the web part menu in the upper right corner.
3.	Locate the About Web Part section of the tool pane and expand it. The most important version is the File Version number for the first component listed. This is the current product version installed. See About Bamboo product Version Numbers for more information about how our products are versioned.

How to deactivate your Bamboo Product License if your server doesn’t have access to the Internet

If your SharePoint WFE server does not have Internet access, you will not be able to deactivate a Bamboo product license from Central Administration. Instead, you can access the My Bamboo area of the Bamboo Solutions web site to deactivate any Bamboo product license key.

Follow the steps below:

Step	Action
1.	Determine the license key you want to move or deactivate. Go to Central Administration and under the Bamboo Solutions section, click Manage My License Keys. NOTE: If you are using SharePoint 2007, in Central Administration, go to the Operations tab to see the Bamboo Solutions section and the Manage My License Keys link. Locate the product that you need to deactivate and click the product name link. The license Status Page will be displayed. Each server that is licensed for that product is listed on the page. NOTE: If you don’t see the License Key on this page see Is there a way to find a lost or unknown Bamboo product license key.
2.	Log in to My Bamboo from a computer with an Internet connection. NOTE: If you don’t have a login account, you can create one quickly. All you need is a valid email address.
3.	At the bottom of any My Bamboo page in the My Orders tab, locate the Manage License link and click it. The Manage License page will be displayed.
4.	On the Deactivate Your License side of the Manage License page, enter your license key and then click the magnifying glass (). The Assembly Name licensed with this key will be displayed. Ensure it is the product you expect and then click Deactivate. Once deactivated, the license key can be re-used on your new or changed server. A license key can be used on only one server at a time. Please see Activating Your Bamboo Product License for more information.

How to check the status of your trial license

Overview of Licensing and and Product Activation

To check the status of your trial, follow these steps:

NOTE: If you are trialing a Bamboo Desktop application, please see Checking the status of a Bamboo Desktop application trial.

Step	Action
1.	Open SharePoint Central Administration. Notice the Bamboo Solutions heading on the page with the Manage My License Keys link beneath it.
2.	Click Manage My License Keys. On the page that appears, expand the Individual Products section and locate the product you are trialing.
3.	Click the product name or select Status from the associated menu to view the license status.
4.	If you are running a trial, your license status will be Trial. The status page will show when your trial started and when it will end. Bamboo Product Trials last 30 days from when the product is installed on your SharePoint farm.

How many License Keys do I need for my SharePoint farm?

Overview of Licensing and and Product Activation

For most products, you will need one Bamboo product License Key per Web Front End (WFE) server. A WFE server is any farm server running the Microsoft SharePoint Foundation Web Application (or Windows SharePoint Services Web Application in WSSv3/MOSS).

CA-servers on farm.jpg To determine which servers on the farm run these services, go to Central Administration > System Settings > and then Manage servers in this farm. If you are using WSSv3/MOSS, this page is accessed in Central Administration through Operations > Servers in Farm. In this example, there are two WFE servers on the farm.

Some SharePoint farms have WFE servers that do not serve content to users, even though they are running the Microsoft SharePoint Foundation Web Application. You will not need a license key for WFEs that do not deliver content to end users.

Desktop applications, such as List Bulk Import and List Bulk Export require only one license per instance.

Some products, such as List Rollup and Alert Plus may include optional components that run on application servers in addition to WFE servers. To use these product features, you may need an additional server license for each separate (non-WFE) application server on which you would like to run the associated service for that product. Using application server features on already licensed WFE servers does not require any additional licensing.

How to Add a web.config Modification Using PowerShell

Background

Please see How to modify a web.config file using PowerShell for some additional background information about why you should modify your web.config file(s) programmatically.

Many Bamboo products implement Telerik controls and install a specific version of Telerik.Web.UI assembly to the SharePoint farm. If the farm already has a different version of Telerik.Web.UI assembly, this may cause a conflict and you may see errors on SharePoint pages where you use these controls.

Resolution

To resolve this problem, we need to add an assembly binding to the web.config to specify which version to use. However, adding text by manually editing a web.config file is not recommended because it is not synced across the servers in the farm and is not saved in the SharePoint configuration database.

The best way to modify a web.config file programmatically is via PowerShell.

NOTE: Be extra careful when making changes to the web.config. Backup your file before changing it. Do not add or remove something unless you are absolutely sure what it is.

To demonstrate, we will use an example with Telerik controls. Consider this scenario:
Before a Bamboo product is installed, a server has Telerik.Web.UI version 2012.3.1016.35 previously installed. During the Bamboo product installation process, Telerik.Web.UI version 2011.2.915.35 was installed. Although it is OK to have multiple Telerik versions on a single server, it may cause a conflict in SharePoint.

We need to add an assembly binding to the web.config to tell the assemblies looking for version 2011.2.915.35 to use version 2012.3.1016.35. The assembly binding addition to the web.config file will look like this:

<dependentAssembly>
    <assemblyIdentity name "Telerik.Web.UI" publickKeyToken "121fae78165ba3d4" culture "neutral" />
    <bindingRedirect oldVersion "2011.2.915.35" newVersion "2012.3.1016.35" />
</dependentAssembly>

NOTE: Always redirect all versions found to the newest version of Telerik.Web.UI on the system, for backwards compatibility of functionality.

Step	Action
1.	First, open the SharePoint 2010 Management Shell. From the Start menu, select All Programs > Microsoft SharePoint 2010 Products > SharePoint 2010 Management Shell.
2.	Next, create the SPWebConfigModification object for the assembly binding Where: Path: A string that contains an XPath expression that specifies the node. If the Type property specifies EnsureChildNode, the Path property contains the XPath expression for the parent node under which the node is created. In this example, the runtime element of the web.config file is placed in another xml-namespace, so we have to identify the namespace. Otherwise, that element will not be found. Name: A string that contains the name of the attribute or section node. When the type of web.config modification is EnsureChildNode, the Name property refers to an XPath expression that uniquely identifies the node under the parent node, as identified by the Path property. Sequence: A 32-bit unsigned integer between 0 and 65536. This property throws an InvalidOperationException if the number is outside this range. A sequence is used only if there is more than one modification of the same type to the same node or attribute. In this case, modifications with lower sequence numbers are applied first. Owner: A string that specifies the owner of the modification. You can use the Owner property to track ownership of modifications. Type: An SPWebConfigModification.SPWebConfigModificationType value that specifies the type of modification. There are 3 types: EnsureChildNode: Specifies that the web.config modification must ensure the existence of a child node of the node to which the XPath expression points. Value = 0. EnsureAttribute: Specifies that the web.config modification must ensure that there is a value for a particular attribute. Value = 1. EnsureSection: Ensures a singleton node. This node is only written once, even if multiple entities register multiple instances of EnsureSection to ensure the existence of a section. Value = 2. Value: If the Type property specifies EnsureChildNode, the Value property contains an XML string that represents the node to be populated as a child of the specified parent node. If the type is EnsureSection, Value contains the name of the section. If the type is EnsureAttribute, Value contains the value set in the attribute.
3.	Then, apply the modification to the Web application (replace ‘WebApplicationURL’ with the actual URL of the Web application). NOTE: Bamboo products are only tested with the Telerik version that they install. Therefore, if a newer Telerik version is used, there might be some unexpected problem.

Step

Action

First, open the SharePoint 2010 Management Shell. From the Start menu, select All Programs > Microsoft SharePoint 2010 Products > SharePoint 2010 Management Shell.

Next, create the SPWebConfigModification object for the assembly binding

Where:

Path: A string that contains an XPath expression that specifies the node. If the Type property specifies EnsureChildNode, the Path property contains the XPath expression for the parent node under which the node is created. In this example, the runtime element of the web.config file is placed in another xml-namespace, so we have to identify the namespace. Otherwise, that element will not be found.
Name: A string that contains the name of the attribute or section node. When the type of web.config modification is EnsureChildNode, the Name property refers to an XPath expression that uniquely identifies the node under the parent node, as identified by the Path property.
Sequence: A 32-bit unsigned integer between 0 and 65536. This property throws an InvalidOperationException if the number is outside this range. A sequence is used only if there is more than one modification of the same type to the same node or attribute. In this case, modifications with lower sequence numbers are applied first.
Owner: A string that specifies the owner of the modification. You can use the Owner property to track ownership of modifications.
Type: An SPWebConfigModification.SPWebConfigModificationType value that specifies the type of modification. There are 3 types:
- EnsureChildNode: Specifies that the web.config modification must ensure the existence of a child node of the node to which the XPath expression points. Value = 0.
- EnsureAttribute: Specifies that the web.config modification must ensure that there is a value for a particular attribute. Value = 1.
- EnsureSection: Ensures a singleton node. This node is only written once, even if multiple entities register multiple instances of EnsureSection to ensure the existence of a section. Value = 2.
Value: If the Type property specifies EnsureChildNode, the Value property contains an XML string that represents the node to be populated as a child of the specified parent node. If the type is EnsureSection, Value contains the name of the section. If the type is EnsureAttribute, Value contains the value set in the attribute.

Then, apply the modification to the Web application (replace ‘WebApplicationURL’ with the actual URL of the Web application).
apply mods.jpg

NOTE: Bamboo products are only tested with the Telerik version that they install. Therefore, if a newer Telerik version is used, there might be some unexpected problem.

How to activate a Bamboo Site Feature

NOTE: In order to activate a site feature, you need to have at least the Manage Hierarchy level of permission for the site.

Step	SharePoint 2007	SharePoint 2010/2013
1.	From a page on the site where you want to activate the feature, click Site Actions > Site Settings > Modify All Site Settings. In the Site Administration columnn of the Site Settings page, click Site features.	From a page on the site where you want to activate the feature, click Site Actions > Site Settings. In the Site Actions section of the Site Settings page, click Manage site features.
2.	Find the appropriate feature. If it hasn’t yet been activated, click the Activate button. The features available depend on the Bamboo products installed on your farm and deployed to your web application.

Step

SharePoint 2007

SharePoint 2010/2013

From a page on the site where you want to activate the feature, click Site Actions > Site Settings > Modify All Site Settings. In the Site Administration columnn of the Site Settings page, click Site features.
sp2007 site features.jpg

From a page on the site where you want to activate the feature, click Site Actions > Site Settings. In the Site Actions section of the Site Settings page, click Manage site features.
site settings - site actions2010.png

Find the appropriate feature. If it hasn’t yet been activated, click the Activate button.
sp2010 site features.jpg

The features available depend on the Bamboo products installed on your farm and deployed to your web application.

How long do trial versions of Bamboo software last and when do they start?

Overview of Licensing and and Product Activation

Currently, trials for Bamboo products run for 30 days, and begin when the product is installed. So if you download the software today, but don’t actually install for two weeks, that’s OK.

If you need an extension to a trial, contact your Bamboo Sales Representative (Sales@bamboosolutions.com).

Highlights of Navigators

When you navigate in SharePoint, don’t you wish you could get to multiple sub-sites, various projects, or links simply by changing tabs instead of opening a separate browser window and entering the URL? Does your Quick Launch have so many links that you wish you could collapse and expand the list when you want to navigate to something? Don’t you want a convenient menu that clearly presents your sitemap and navigation, rather than having to scroll endlessly or navigate clumsily in order to get where you want to go? So do we!

Navigators allows you to create custom menus, mega menus, tabs, tree items, and provides a Site Actions menu to navigate to sites, pages, or lists within and across sites and site collections. SharePoint security is enforced by keeping users without appropriate access from accessing any SharePoint links you may configure in your navigation via item-level security trimming. These navigation controls can help you build a clean, user-friendly project management site, or any other type of site that requires customized navigation controls.

Error Log Files

Applies To

Bamboo Products
Windows SharePoint Services v3 and Microsoft Office SharePoint Server 2007
SharePoint Foundation 2010 and SharePoint Server 2010
SharePoint Foundation 2013 and SharePoint Server 2013—Standard Edition
SharePoint Server 2016

While troubleshooting issues, the Bamboo support team may request a copy of the log files for your Bamboo product(s). Many licensing, functionality and access issue information is captured in the log files found in the BambooSolutions file folder.

This directory is located at C:WindowsTempBambooSolutions

The log files are named in this format: bsc_bamboo_{processID}.log

where {processID} is the ID of the w3wp.exe process which was handling the request at the time of the error

NOTE: These files will be created on any farm server running the Microsoft SharePoint Foundation Web Application (on SharePoint 2010 or SharePoint 2013) or the Windows SharePoint Services Web Application (on SharePoint 2007).

To determine which servers on the farm run these services:

SharePoint 2007:

Go to the page Central Administration > Operations > Servers in Farm

SharePoint 2010:

Go to the page Go to the page Central Administration > System Settings > Manage Servers in this Farm

SharePoint 2013:

Go to the page Central Administration > System Settings > Manage Servers in this Farm

There may be many log files. When reporting a problem to support, attach the most recent file(s) to your support ticket. If you know the time at which the error occurred, choose the file with the corresponding date/time.

Refer to Topology and Services in SharePoint Central Administration for a list of servers running this service. Learn more…

Deploying a Bamboo solution to a new Web Application

Note: Perform these steps using an account that is a member of the SharePoint Farm Administrators group.

Step	for SharePoint 2007	for SharePoint 2010/2013
1.	In SharePoint Central Administration, click the Operations link. In the Global Configuration section, click the Solution Management link. A list of installed solutions is displayed.	In SharePoint Central Administration, click System Settings link. In the Farm Management section shown on the page, click the Manage farm solutions link. A list of installed solutions is displayed.
2.	Click on the name of the solution you want to deploy.	Click on the name of the solution you want to deploy.
3.	Click the Deploy Solution link.	Click the Deploy Solution link.
4.	Select the Web application to deploy to and a deployment schedule, and then click OK.	Select the Web application to deploy to and a deployment schedule, and then click OK.

CSS Overview

Classes for customizing CSS in your environment are provided by Bamboo so that you can customize web parts to match your branding. We also provide skins that change the look and feel but these are used discretely. See the topic Skins Overview for more information.

Calendar Plus

CSS for Calendar Plus

Chart Plus

Cross List

CSS for Cross List – this topic covers the classes you would need to modify for Cross List.

Navigators

Password Change

CSS for Password Change Web Part

PM Central

PMC Skin Templates

Team Calendar

CSS for Team Calendar

Virtual Map View

CSS for Virtual Map View

CSS for Navigators Treeview

Return to Configuring Navigators CSS

Add Navigators Tree Menu (not to be confused with Bamboo’s Tree View Menu web part) to the page or the site and configure it as needed. Navigate to the Style library in the parent level of the site collection.

Step	Action	Result
1.	Download TreeView.CustomSkin file that belongs to Tree Menu folder.
2.	Edit CSS code using your CSS Editor or Notepad to change items such as text color.
3.	Upload the modified file to the CustomSkin folder.
4.	On the web part, the text color of the Tree menu is shown with red font.

If you do not use the default Customskin folder do the following:

Description	Change
If you decide not to use the default folder (Customskin), you need to create a new folder Myskin at the same level as the Customskin folder and copy the images file and the CSS file to the Myskin folder. The Image file name should be called “TreeView” and the CSS file name should be called “TreeView.MySkin”.
Also, if you decide to do this, it is also required that you replace all the names of classes in your CSS file from “Customskin” to “Myskin”.
And it is also required that you change the path to the Myskin folder in the tool pane.

CSS for Navigators Tabstrip

Return to Configuring Navigators CSS

Step	Action	Result
1.	Within the Style library under the BambooSolutions folder, you will find the Navigators folder. Navigate to Menu folder > Skins > Customskin and you will see a file and a folder: the folder contains images and the file is the CSS file that you want to modify.	NOTE: If you are not comfortable with modifying CSS files, make a copy of it on your desktop in case you make too many changes that you may want to roll back to later. Also when you are happy with your changes, make a copy of your CSS file and keep in a safe spot.
2.	Add Bamboo Navigator TabStrip web part to the page or the site.	If you do not know how to add a web part to a page, follow the instructions here.
3.	Configure the tool pane; select Custom Style option.
4.	Download the TabStrip.CustomSkin file and within your CSS text editor or Notepad, make your changes such as the background color of the TabStrip.
5.	Upload the modified file to the Customskin folder. Based on the changes made in the web part as shown below:	The text-color is now red. The background color of level1 is pink. The background color of level2 is green. The background when an item is selected becomes yellow.

NOTES:

Description	Change
If you decide not to use the default folder (Customskin), you need to create a new folder Myskin at the same level as the Customskin folder and copy the images file and the CSS file to the Myskin folder. (We are using “Myskin” as an example, but you can call it what you want.) The Image file name should be called “TreeView” and the CSS file name should be called “TreeView.MySkin”.
Also, if you decide to do this, it is also required that you replace all the names of classes in your CSS file from “Customskin” to “Myskin”.
And it is also required that you change the path to the Myskin folder in the tool pane.

Configuring the Bamboo Tree Menu

Return to Overview of Web Part Configuration

Navigators allows you to create Tree Menu items to navigate to sites, pages, or lists within and across sites and site collections. SharePoint security is enforced by keeping users without appropriate access from accessing any SharePoint links you may configure in your navigation via item-level security trimming. These navigation controls can help you build a clean, user-friendly project management site, or any other type of site that requires customized navigation controls.

After adding the Bamboo Tree Menu web part to a page, configure the web part following the instructions below:

Step	Action	Result
1.	Click the arrow by the web part title and select Edit Web Part to open the configuration tool pane.
2.	Enter the Site URL	Type the URL address of the site you want to connect to, then click the green arrow button. Enter an absolute or relative URL. It is recommended that you enter a relative URL so that your site can be accessed via HTTP or HTTPS, and for portability when creating site templates. The syntax for entering the relative URL is shown in the screenshot below.
3.	Select List	Select the Bamboo Navigators list. You can also use your own list for creating your tab system. You just need to make sure that the list you use has similar columns to Menu Title, Description, URL Link, Parent Menu and Sort Order. If you do not want to use the Bamboo Navigators list, you can delete it manually. Create List – In case you deleted the unused Bamboo Navigators list, you can create it again by clicking on this button. NOTE: If the list exists, the Create list button will be grayed out.
4.	Select View	Select the view of the list that contains the columns you want to choose from. Bamboo Navigators list comes with the Navigators View, which includes all of the columns needed for proper configuration (i.e. in the Menu Title, Description, URL Link, Parent Menu, Sort Order fields).
5.	Menu Title	Select the column that contains the name of the tree menu item.
6.	Description	Select the column that contains the description of the tree menu item. This text is displayed in a tooltip when the user hovers the mouse over the tree menu item.
7.	URL Link	Select the column that contains the URL address for the tree menu item.
8.	Parent Menu	Select the tree menu item that is the parent of the item you are creating. This is a lookup column that looks up to the Menu Title column of the Bamboo Navigators list so that you can create submenus.
9.	Sort Order	Set the order of the tree items. For instance, for all of the tree menu items at the parent level (i.e. the Parent Menu column has no selection), you can set the order in which they are displayed.
10.	URL Icon	Select the column that contains the Icon URL.

Configuring the List and List View for the Navigator Web Parts

Return to Overview of Web Part Configuration

To get started configuring this web part, you need to begin with which site your list resides in and from there, select the view and map the columns in your list to the Navigators list that Bamboo provides. If you have not deleted the Bamboo-provided list, all the mapping options will contain the default column name.

Step	Action	Result
1.	Click the arrow by the Web Part title and select Edit Web Part to open the configuration tool pane.
2.	Enter the Site URL. Type the URL address of the site where the Bamboo Navigators list resides, then click the green arrow button. Enter an absolute or relative URL.	NOTE: It is recommended that you enter a relative URL so that your site can be accessed via HTTP or HTTPS, and for portability when creating site templates. The syntax for entering the relative URL is shown in the screenshot above.
3.	Select List. Select the Bamboo Navigators list.	You can also use your own list for creating your menu system. You just need to make sure that the list you use has similar columns to Menu Title, Description, URL Link, Parent Menu and Sort Order. If there is no Bamboo Navigators list in the site you specified, create one by clicking Create List. NOTE: If the list exists, the Create list button will be grayed out.
4.	Select View. Select the view of the list that contains the items you want included in your navigation.	The Bamboo Navigators list comes with the Navigators View which includes all items in the list. If you need several navigator web parts to use the same Bamboo Navigators list, create a filtered view of the list for each web part instance. Only items included in the configured view will appear on the navigation web part (i.e., menu, tabs, tree). NOTE: The columns included in the list view do not impact the display or configuration of the web part.
5.	Menu Title. Select the column that contains the name of the menu item.
6.	Description. Select the column that contains the description of the menu item.	This text is displayed in a tooltip when the user hovers over the menu item with a mouse.
7.	URL Link. Select the column that contains the URL address for the menu item.
8.	Parent Menu. Select the menu item that is the parent of the item you are creating.	This is a lookup column that looks up to the Menu Title column of the Bamboo Navigators list so that you can create submenus.
9.	Sort Order. Set the order of the menu items at their respective levels.	For instance, for all of the menu items at the parent level (i.e. the Parent Menu column has no selection), you can set the order in which they are displayed. For three child items under one of these parent menu items, you can set the order in which they display under the parent menu item.
10.	URL Icon. Select the column that contains the Icon URL.	You can choose to display a small icon next to the menu item; these icons must be in a column containing the image.

Configuring the Bamboo Navigators Tab Strip Web Part

Return to Overview of Web Part Configuration

To configure this web part, follow the steps for each section below.

Step	Action	Result
1.	Enter the Site URL	Type the URL address of the site you want to connect to, then click the green arrow button. Enter an absolute or relative URL. It is recommended that you enter a relative URL so that your site can be accessed via HTTP or HTTPS, and for portability when creating site templates.
2.	Select List	Select the Bamboo Navigators list. You can also use your own list for creating your menu system. You just need to make sure that the list you use has similar columns to Menu Title, Description, URL Link, Parent Menu and Sort Order. If you do not want to use the Bamboo Navigators list, you can delete it manually. Create List. In case you deleted the unused Bamboo Navigators list, you can create it again by clicking on this button. NOTE: If the list exists, the Create list button will be grayed out.
3.	Select View	Select the view of the list that contains the columns you want to choose from. The Bamboo Navigators List comes with the Navigators View, which includes all of the columns needed for proper configuration (i.e. in the Menu Title, Description, URL Link, Parent Menu, Sort Order fields).
4.	Menu Title	Select the column that contains the name of the tab.
5.	Description	Select the column that contains the description of the tab. This text is displayed in a tooltip when the user hovers with a mouse over the tab.
6.	URL Link	Select the column that contains the URL address for the tab.
7.	Parent Menu	The Tab Strip Web Part only displays first-level (i.e. parent level) tabs. It cannot display child items from a tab. This column should be blank in order to display each item in the list as a separate tab.
8.	Sort Order	Set the order of the tabs. For instance, for all of the tabs at the parent level (i.e. the Parent Menu column has no selection), you can set the order in which they are displayed.
9.	URL Icon	Select the column that contains the Icon URL.

Configuring the Bamboo Site Action Menu Feature

The Bamboo Site Actions Menu Feature allows you to create a menu system for just Administrators to access from the Site Actions menu. This is not a web part but a site collection feature that you activate and a list that you populate.

First you need to go to your Site Collection Features menu and activate the Bamboo Navigator Site Action Menu feature.

Once you activate the site collection feature, Bamboo creates a list called Bamboo Navigator – Site Actions Configuration. By default, if you do not add any content to Bamboo’s Site Actions Configuration list, the feature will use the Bamboo Navigators list items.

Follow the steps below to configure the Bamboo Navigator – Site Actions Configuration list:

Step	Action	Result
1.	Navigate to the Bamboo Navigator – Site Actions Configuration list on the top level site of the site collection where you activated this feature.
2.	Click New to create a configuration item. You only need one configuration item for this feature.	NOTE: You cannot create more than one Site Action Menu item – only child menu items can be created under the single Site Action Menu item.

3.	Menu Items List URL	Type the URL address to the list you want to use for the Site Actions menu items. You can use an existing Bamboo Navigators list or create one of your own as long as it contains the columns that can map to Menu Title, Description, Parent Column, URL Link and Sort Order. Enter an absolute or relative URL. We recommended that you enter a relative URL so that your site can be accessed via HTTP or HTTPS, and for portability when creating site templates.
4.	Site Actions Menu Title.	Type the name of your custom Site Actions menu.
5.	Site Actions Menu Description.	Type the description of the menu item. This text is displayed in a tooltip when the user hovers with a mouse over the menu item.
6.	Menu Title Column Name.	Type the exact name of the column in your list that contains the menu title.
7.	Menu Description Column Name.	Type the exact name of the column in your list that contains the menu item description.
8.	Menu Parent Column Name.	Type the exact name of the column in your list that contains the parent menu.
9.	Menu Sort Order Column Name.	Type the exact name of the column in your list that contains the sort order for the menu items.
10.	Parent Menu Icon URL.	Enter a relative or absolute path to an icon image to be displayed next to the parent menu title. A default icon has been included with the product installation. It can be found here: /_layouts/images/Bamboo.Navigators/parent.gif
11.	Child Menu Icon URL.	Enter a relative or absolute path to an icon image to be displayed next to the child menu title. A default icon has been included with the product installation. It can be found here: /_layouts/images/Bamboo.Navigators/child.gif

Once you populate the Bamboo Navigator – Site Actions Configuration list, you will see that list item within your Site Actions menu (under the Gear icon on SharePoint 2013).

NOTE: You may want to set unique permissions on the list so that only your site admins will see this menu; as a default, it inherits permission from the parent site.

Configuring the Bamboo Navigator Menu Web Part

To configure this Web Part, do the following:

Enter the Site URL. Type the URL address of the site you want to connect to, then click the green arrow button. Enter an absolute or relative URL. It is recommended that you enter a relative URL so that your site can be accessed via HTTP or HTTPS, and for portability when creating site templates.
Select List. Select the Bamboo Navigators list. You can also use your own list to create your menu system. You just need to make sure that the list you use has similar columns to Menu Title, Description, URL Link, Parent Menu and Sort Order.
Select View. Select the view of the list that contains the columns you want to choose from. The Bamboo Navigators list comes with the Navigators View which includes all of the columns needed for proper configuration (i.e. in the Menu Title, Description, URL Link, Parent Menu, Sort Order fields).
Menu Title. Select the column that contains the name of the menu item.
Description. Select the column that contains the description of the menu item. This text is displayed in a tooltip when the user mouses over the menu item.
URL Link. Select the column that contains the URL address for the menu item.
Parent Menu. Select the menu item that is the parent of the item you are creating. This is a lookup column that looks up to the Menu Title column of the Bamboo Navigators list so that you can create submenus.
Sort Order. Set the order of the menu items at their respective levels. For instance, for all of the menu items at the parent level (i.e. the Parent Menu column has no selection), you can set the order in which they are displayed. For three child items under one of these parent menu items, you can set the order in which they display under the parent menu item.
Select Skin. Select from a variety of user interface designs for your menus.
Select a Language. Select a language from the drop-down menu to translate the Web Part user interface and tool pane settings. You can also create your own translation or modify the default files available in the drop-down menu. See for more information.

NOTE: The translation options for Spanish, French, German and English are currently all still in English. You must customize the files directly to translate the Web Part user interface to the language you require. See Customizing the Translation Settings for more information.

Configure Navigator Look and Feel Settings

In the Web Part Tool Pane you can configure the following Look and Feel Settings to customize the Web Part Menu to individual needs. From release 1.5, it is possible to edit the skin and apply changes via the CSS also. See Customizing Navigators for more information.

Step	Action	Result
1.	Inherit from site theme. Select this option to change the skin to reflect your site theme.
2.	Custom Style. Select this option to apply custom style settings.
3.	Menu Style. Set skin and font format.
4.	Select Skin. Choose from the drop-down list to select from the available skin types.	See images below to see examples of how changing skins changes the look and feel of the web part.
5.	Font Format. Click on the checkbox with letter “A” to configure font settings in a dialogue box. Select Font (use the arrows for selection), Style and Size to format font.	Click OK and the selected format is displayed in the sample box. Change the color by picking a new color for Foreground and hover and select respectively. Click apply and ok and the selected format is displayed in the sample box.
6.	Automatically resize the Menu. This box is set by default. Deselect this box to set menu size manually.
7.	Menu Size. Add pixel(px) value for setting width of the menu.

Results of Skin Changes

Navigator Menu with Web 20 skin applied

Navigator Menu with CSS Green skin applied

Navigator Menu with Inox skin applied

Complementary Products for Navigators

You will find many of our products complement each other quite nicely saving you the time and trouble to write custom code. With Bamboo at the heart of your SharePoint investment, you gain access to a huge catalog of enhancements, components, and accessories that add the critical functionality your business requires.

The same components can be easily used in future applications and they all come from a single, trusted vendor, ensuring an easy purchase process and support you can count on. That’s the Bamboo Way!

Choosing which farm servers to license

Bamboo products are deployed to all servers in the farm running the Microsoft SharePoint Foundation Web Application service (or Windows SharePoint Services Web Application in WSSv3/MOSS), which may include servers that do not serve Web content. For most products, only servers that serve Web content need a license key (Alert Plus is an exception), but all servers that run the Microsoft SharePoint Foundation Web Application service will appear on the Web License Manager Status and Activation pages by default.

If you would like to see only certain servers displayed in the Web License Manager, follow these steps:

Step	Action
1.	Click the Choose License Server(s) link on the Bamboo Web License Manager main page.
2.	Although this step is optional, it makes it easier for SharePoint Administrators to see which servers in the farm need a license key, if not all do. On the page displaying the list of servers, check the box for each server functioning as a Web Front End (WFE). Some products, such as Alert Plus or List Rollup, may include optional features that require licensing of a SharePoint application server as well. If so, these servers can also be selected.

Step

Action

Click the Choose License Server(s) link on the Bamboo Web License Manager main page.

Although this step is optional, it makes it easier for SharePoint Administrators to see which servers in the farm need a license key, if not all do.

On the page displaying the list of servers, check the box for each server functioning as a Web Front End (WFE).

Some products, such as Alert Plus or List Rollup, may include optional features that require licensing of a SharePoint application server as well. If so, these servers can also be selected.

WLM-choosing license servers2.jpg

Can trials be extended?

Overview of Licensing and and Product Activation

Once you have installed a Bamboo product on your farm and the trial period has passed, you cannot install a second trial. Instead, you need to extend the original trial period. Contact your Bamboo Sales Account Manager (Sales@bamboosolutions.com) for a trial extension.

Before you uninstall

IMPORTANT: Before you uninstall a Bamboo product, make sure that it is no longer in use on any site in your farm. If a web part resides on a page and you uninstall the web part, an error will be displayed for users that visit that page. The uninstall process does not update individual pages in your SharePoint portal.

Also, if you uninstall Workflow Conductor (WFC) and some workflows built with WFC are still active, those workflows will fail.

You have several choices for how to uninstall your Bamboo product:

Option	Comment
Use the Updated Uninstall Process for Bamboo components	Based on feedback from our customers, Bamboo introduced updated install/uninstall processes for component products (web parts). Instead of the Setup.exe Installation Application, we now supply two PowerShell scripts – one for Install/Upgrade and the other for Uninstall – to be used to install, upgrade, or uninstall the product. For more information, see Overview of the Updated Installation Process for Bamboo components.
Bamboo Installation Package	IMPORTANT: As of April 2017, Bamboo no longer includes the Installation/Setup program in product download packages. You can use the Bamboo product installation package that you used to install the product to uninstall. This is the preferred method, because it performs some automated system checks to help ensure the uninstall will be successful. It also steps you through each component, so its easier to make sure everything is uninstalled. See Using the Setup program to Uninstall for more information.
SharePoint Central Administration	Many Bamboo products are deployed as SharePoint solutions, so you can retract and remove them from Central Administration. See Uininstalling from SharePoint Central Administration for more information.
PowerShell	Some Bamboo products are packaged with a PowerShell script that you can use to uninstall. See Manually uninstall using PowerShell for more information.
stsadm	If you prefer, you can use stsadm commands to retract and delete Bamboo SharePoint solutions. See Manually uninstall using stsadm for more information.
Add/Remove Programs	Some Bamboo products include components that are installed using an EXE or MSI installer. See Uninstalling a Bamboo .msi or .exe for more information.

Depending on the uninstall method you choose, there may be a solution left behind after the install. This is intentional, as several Bamboo products use some of the same components. See What is left behind after uninstalling? for more information and steps for how to uninstall completely.

Before you Migrate from SharePoint 2007 to SharePoint 2010 Read This

Overview

Microsoft recommends that you use one of two basic approaches when you upgrade from SharePoint 2007 to SharePoint 2010:

In-place upgrade. An in-place upgrade is used to upgrade all Microsoft SharePoint sites on the same hardware. See How to Migrate a Bamboo Web Part from SharePoint 2007 to SharePoint 2010 using the In-Place Upgrade Method for details.
Database attach upgrade. A database attach upgrade enables you to move your content to a new farm or new hardware. See How to Migrate a Bamboo Web Part from SharePoint 2007 to SharePoint 2010 using the Database Attach Upgrade Method for details.

You can also combine these two types of upgrade in hybrid approaches that reduce downtime during an upgrade. For more information about these approaches, see Determine upgrade approach (SharePoint Server 2010) from Microsoft TechNet.

General Migration Restrictions for Bamboo Products

Regardless of the upgrade method you choose, you MUST change existing SharePoint sites to use the new user SharePoint 2010 experience. If you don’t, some features of your Bamboo products will not work as expected.
You need to make sure that you are running the latest available Bamboo product release in your SP2007 environment before migrating. Review information specific to the product(s) you are migrating to learn the minimum product release to migrate. See Bamboo product releases that are supported for migration from SharePoint 2007 to SharePoint 2010 for details.
Bamboo Solutions does not support the migration of Bamboo products deployed on WSSv2/SharePoint 2003 environments to SharePoint 2010 farms.
Bamboo Solutions does not support the downgrade of SharePoint editions when migrating from SharePoint 2007 to SharePoint 2010. For example, Bamboo products are not supported when migrating from MOSS 2007 to SharePoint Foundation 2010.

Migration Restrictions for Specific Bamboo Products

Before following the instructions for the method you choose, review information specific to the product(s) you are migrating. The In-Place Upgrade method is sometimes easier, but it takes longer. Some Bamboo products do not support the In-Place upgrade method and we recommend a hybrid In-Place Upgrade method as an alternative.

Bamboo products that use Telerik

Product	Uses Telerik?
Alerts Administrator	Yes
Alert Plus	Yes
Bulk Export	No
Bulk Import	No
Calendar Plus	Yes
Chart Plus	Yes
Column Level Security	Yes
Community Central	Yes
Cross List	No
Cross Site Display	No
Custom Identifier	No
Data Viewer	Yes
Discussion Board Plus	Yes
File Share Library	No
Filters Collection	Yes
Grants Management	Yes
Group Email	Yes
Group Redirect	Yes
In/Out Schedule Board	Yes
Knowledge Base Solution Accelerator	Yes
KPI Column	Yes
List Consolidator	Yes
List Print	No
List Rollup	Yes
List Rotator	No
List Search	Yes
Lookup Selector	No
Mini Calendar	No
My Alerts Organizer	No
Navigators	Yes
Password Change	Yes
Password Expiration	No
Password Reset	No
Password Management Toolkit	Yes
PM Central	Yes
Poll	Yes
Project Portfolio Dashboard	Yes
Rating	Yes
Rich Text	Yes
Site Creation Plus	No
SQL View	No
Task Master	Yes
Team Calendar	Yes
Time Tracking and Management	Yes
Tree View	Yes¹ No²
User Account Setup	Yes
User Directory	Yes
User Manager for Sites	Yes
User Profile Plus	No
User Profile Sync	No
User Redirect	No
User Registration Accelerator	No
Validator column	No
Video Library	No
Virtual Map View	No
Visual Indicator column	No
Wiki Publisher	No
Workflow Conductor	Yes
World Clock and Weather	No

¹SharePoint 2007 and SharePoint 2013
²SharePoint 2010

Bamboo product releases that are supported for migration from SharePoint 2010 to SharePoint 2013

The table below shows the minimum required Bamboo product version required when migrating Bamboo products from SharePoint 2010 to SharePoint 2013. If you have an earlier version installed than the one listed, please upgrade that product before migrating to SharePoint 2013.

For additional information:

Product	minimum SP2010 version	minimum SP2013 version
Alert Plus	30.2.115	30.2.121.2013
Alerts Administrator	10.4.52	10.4.62.2013
Calendar Plus	40.1.143	40.1.155.2013
Chart Plus	30.5.109	30.5.143.2013
Column Level Security	10.3.34	10.3.48.2013
Community Central	10.1.91	10.5.76.2013
Cross List	10.5.20	N/A
Cross Site Display	10.2.26	10.2.40.2013
Custom Identifier Column	10.0.45	10.0.57.2013
Data-Viewer	30.5.67	30.5.57.2013
Discussion Board Plus	10.5.22	20.0.57.2013
DWG Parser SharePoint 2007 Only	N/A	N/A
Filters Collection	10.3.25	10.3.35.2013
File Share Library	20.0.60	20.0.81.2013
Grants Management	10.5.20	N/A
Group Email	10.7.43	10.7.46.2013
Group Redirect	20.3.27	20.3.33.2013
Hello	20.1.9	N/A
In/Out Schedule Board	10.4.56	10.4.57.2013
Knowledge Base	20.2.47	20.2.75.2013
KPI Column	10.3.65	10.3.78.2013
List Bulk Export	1.4.12	20.0.18.1
List Bulk Import	2.5.105	30.0.29.2013
List Consolidator	10.0.79	10.0.107.2013
List Print	10.4.31	10.4.35.2013
List Rollup	60.0.64	60.0.70.2013
List Rotator	20.5.82	20.5.99.2013
List Search Advanced	10.8.93	10.8.121.2013
List Search Simple	20.1.140	20.1.167.2013
Lookup Selector Column	20.3.61	20.3.88.2013
Mini-Calendar	20.8.67	20.8.86.2013
My Alerts Organizer	10.4.43	10.4.51.2013
Navigators	10.3.47	10.3.57.2013
Password Change	40.1.65	40.1.68.2013
Password Expiration	10.6.43	10.6.49.2013
Password Reset	20.4.51	20.4.70.2013
Poll	10.4.53	10.4.63.2013
Project Management Central	40.1.135	40.1.109.2013
Project Portfolio Dashboard	10.8.58	10.8.80.2013
Quick Add	10.0.29.0	10.0.29.2013
Rating Column	10.2.43	10.1.54.2013
Rich Text Column	10.3.27	10.3.28.2013
Site Creation Plus	10.4.66	10.4.71.2013
SQL View	10.6.26	N/A
Task Master	30.5.117	30.5.116.2013
Team Calendar	10.7.18	10.7.36.2013
Time Tracking and Management	1.6.46	10.6.88.2013
Tree View	10.7.83	10.8.23.2013
User Account Setup	40.0.107	40.0.148.2013
User Directory	10.7.53	10.7.81.2013
User Manager for Sites	10.3.46	10.3.62.2013
User Profile Plus	10.4.39	10.4078.2013
User Profile Sync	1.6.10	20.0.20.2013
User Redirect	10.5.16	10.5.27.2013
User Registration Accelerator	10.3.24	10.3.35.2013
Validator Column	10.3.20	10.3.35.2013
Video Library	20.0.87	20.0.106.2013
Virtual Map View	10.9.46	10.9.42.2013
Visual Indicator Column	10.3.59	10.3.79.2013
Wiki Publisher	10.0.65	10.0.85.2013
Workflow Conductor	30.0.0	30.0.1.2013
World Clock and Weather	20.4.47	20.4.52.2013

Bamboo product releases that are supported for migration from SharePoint 2007 to SharePoint 2010

The table below shows the minimum required Bamboo product release required when migrating Bamboo products from SharePoint 2007 to SharePoint 2010. If you have an earlier release installed than the one listed, please upgrade that product before migrating to SharePoint 2010.

For additional information:

Product	minimum SP2007 release	minimum SP2010 release
Alert Plus	3.0.62	30.0.59
Alerts Administrator	1.4.12	10.4.30
Calendar Plus	4.0.96	40.0.36
Chart Plus	2.5.43	20.5.25
Column Level Security	1.3.4	10.3.7
Cross List	1.5.5	10.5.6
Custom Identifier Column	1.0.35	10.0.35
Data-Viewer	3.3.59	30.3.67
DWG Parser	N/A	N/A
Filters Collection	1.3.5	10.3.13
File Share Library
Grants Management	TBD	TBD
Group Email	1.7.4	10.7.11
Group Redirect	2.3.11	20.3.14
Hello	TBD	TBD
In/Out Schedule Board
Knowledge Base	2.0.71 NOTE: Releases earlier than 1.2 are no longer supported for upgrade or migration.	20.0.56
KPI Column	1.2.40	10.3.33
List Bulk Export	N/A	N/A
List Bulk Import	N/A	N/A
List Consolidator	1.0.87	10.0.62
List Print	1.4.5	10.4.18
List Rollup	Classic: 5.0.55 Schema: 5.0.77	Classic: 40.5.13 Schema: 50.0.85
List Rotator	2.5.24	20.5.44
List Search Advanced	1.8.51	10.8.48
List Search Simple	1.8.64	10.8.60
Lookup Selector Column	1.3.24	20.3.15
Mini-Calendar	2.7.8	20.7.11
My Alerts Organizer	1.4.13	10.4.40
Navigators	1.3.11	10.3.12
Password Change	3.5.8	30.5.14
Password Expiration	1.5.11	10.5.19
Password Reset	2.4.11	20.4.31
Project Management Central	2.1.21	20.1.12
Rich Text Column	1.3.9	10.3.14
Site Creation Plus	1.4.31	10.4.18
SQL View	1.6.17	10.6.23
Task Master	2.0.150	20.0.34
Team Calendar	1.5.4	10.5.11
Tree View	1.7.29	10.7.27
User Account Setup	3.4.8	30.4.31
User Directory	1.7.1	10.7.2
User Manager for Sites	1.3.1	10.3.19
User Profile Plus	1.4.7	10.4.35
User Profile Sync	N/A	N/A
User Redirect	1.5.3	10.5.14
Validator Column	1.3.1	10.3.12
Virtual Map View	1.9.25	10.9.9
Visual Indicator Column	1.3.7	10.3.19
Wiki Publisher	1.0.26	10.0.25
Workflow Conductor	1.5.1	1.5.1
World Clock and Weather	2.3.15	20.3.15

Adding Content to Bamboo Navigators List

When you click the Create List button in the Navigators Web Part Tool Pane, the Bamboo Navigators list is created. It stores the values for the menu options displayed in the web part.

NOTE: Prior to Release 1.5, The Bamboo Navigators list was created automatically when any Navigator web part was added to a page in the site. With Release 1.5 and later, click the Create List button in the web part tool pane to create the list. It is no longer created automatically.

Below is a screen shot of the new form that opens when you create a new item in the Navigators list. Each option is described below to help make sense of what you see in the list and how the data shows up in the Navigators menu.

No.	Column	Description
1.	Menu Title	This is the title that displays on the menu.
2.	Desc- ription	When users hover a mouse over the menu, this is the tool tip message they will see.
3.	URL	You can enter an absolute URL (starts with http://) or a relative URL (for the current site, the relative notation is a dot followed by a slash, ./). Relative notation is recommended.
4.	Parent Menu	This is a lookup column that looks up the Menu Title in this same list; use it to group your menu items. We recommend you first add all the parent menu items and subsequently add the child items that can look up to the parent. In our screenshot in No. 2 above, our parent menu is called “Bamboo Solutions” and one of the child items is “Bamboo Products.” We first added the parent so that the parent menu was available for lookup when adding the child item. IMPORTANT: Not all Navigator web parts support multiple menu levels. Do not select a parent if you are using the Bamboo Navigator Tab Strip or the Bamboo Navigator Menu with the Mega Menu option enabled.
5.	Sort Order	You need to specify an ordering sequence beginning with 1 to put your menu options in a given order. This column is not required by default.
6.	Icon URL	Each menu option can have an icon displayed next to it. If you decide to show these icons, enter the Icon URL in this column. Example: /_layouts/images/BambooNavigators/icon.gif
7.	Nav- igation	This is optional. Recommended for use when there is more than one Navigator per site using the same list. Add the names of the different Navigation Views to the Navigation field and use this column to create filtered views of the Bamboo Navigators list. Select the appropriate list view when configuring each web part instance.
8.	Mega Content	Use Mega Content to add additional menus for users to see. IMPORTANT: Only the Bamboo Navigator Menu and Bamboo TabStrip web parts support Mega Menus.
9.	Save or Cancel	Always click Save to save your changes. Cancel will close the form without retaining any data you entered.

Also see:

Using the Drag & Drop Menu Editor

Add Navigator Menu to a Master Page

Use these instructions to add the Bamboo Navigator Menu Web Part to a master page in SharePoint. The steps are the same for all supported versions of SharePoint, although the master pages themselves vary from version to version. If you don’t have SharePoint Designer, you can download the master page from the SharePoint Master Page Gallery, edit it in a text editor, and upload it back to the Master Page Gallery. Sample master pages are included in the Navigator installation package from version 18.1 on.

Plain Team Site - before snip.png Specifically, the out-of-the-box Team Site v4.master looks like this before making any changes:

updated master page AFTER.png After adding the Bamboo Navigator Menu, it will look like this:

NOTE: Always make a backup of your master page before making any changes to it. If you rename your working copy of v4.master, be sure to change the site settings to reflect the new name of your master page.

Step	Action
1.	Go to the top site of the site collection where you want the master page changed and add a Bamboo Navigator Menu web part to a page on that site. Add values to the Bamboo Navigators list so the menu shows some options. The screenshot shows the Bamboo Navigator Menu web part with three options: Top A, Top B, and Top C. Home and PMC are links on the Top Link bar in the master page. NOTE: You will probably not want to show the web part Title in your master page, so be sure to configure the web part with Chrome Type set to None in the Appearance section of the tool pane as shown here.
2.	While viewing the web part page with the navigator web part in Internet Explorer, press F12 or click Tools > F12 Developer Tools to open the IE Developer window. It opens at the bottom of the page. Make sure the DOM Explorer window is displayed.
3.	Using the Select Element feature of the IE Developer tool, make a note of the tag above or below which you want to insert the navigator.
4.	Edit the web part page where you put the Bamboo Navigator Menu Web Part in SharePoint Designer. From the Page ribbon, expand the menu beneath Edit Page and click Edit in SharePoint Designer. The page (and the site) will open in the SharePoint Designer.
5.	At the top of the web part page code, locate the register tag for the Bamboo Navigator Menu Web Part. Copy the whole tag to your clipboard so you will be able to paste it into the v4.master file. NOTE: If you used the Bamboo Navigator Tab Strip or the Bamboo Tree Menu instead of the Bamboo Navigator Menu, this register tag will be slightly different than the one shown.
6.	In SharePoint Designer, edit the v4.master page in Advanced Mode. IMPORTANT: Always save a copy of the v4.master file before making any changes. As an alternative, consider saving the v4.master with another name and editing the copy rather than editing the v4.master.
7.	Paste the register tag you copied to your clipboard in Step 5 above to the top section of the v4.master file with the other Register tags.
8.	Go back to the web part page code and locate the Bamboo Navigator tag by searching for WpNs0. Copy the whole tag to your clipboard so you will be able to paste it into the v4.master file. NOTE: If you used the Bamboo Navigator Tab Strip or the Bamboo Tree Menu instead of the Bamboo Navigator Menu, this tag will be slightly different than the one shown.
9.	Create a new DIV tag in the v4.master file at the location where you want the Bamboo Navigator Menu Web Part to appear. NOTE: You may consider adding a style to the tag as shown in the code snippet below. When ready, paste the tag you copied in Step 8 into the new DIV tag.
10.	Save the changes to the v4.master and view your SharePoint site. You should see the navigator on all pages that use the v4.master.

Add Mega Menu to Navigators Menu Web Part

Return to Overview of Web Part Configuration

NOTE: Mega Menus are available only with the Bamboo Navigator Menu Web Part. When using the mega menu feature, you cannot have sub-menu items. The Parent Menu column for all menu items must be blank.

Step	Action	Result
1.	From your site where you want to have the Navigator Menu, edit the web part and check the box to “Show Mega Menu.”
2.	Add items to Bamboo Navigators list.
3.	Insert a table into the Mega Content Window and enter some data into each row.
4.	In order to hyperlink your data, highlight an item in one row and click on the Insert menu in the ribbon to locate the Link icon where you can select whether you link is in SharePoint or an external address.
5.	Insert your hyperlink either from SharePoint or from an external address. If you are using an external address, a dialog box will open to guide you in entering and testing the link.	When you are satisfied with your changes, click OK and click Save on the web part.
6.	Now when you hover your mouse over the Navigators menu, you have a more robust menu displayed.

Also See:

Using the Drag & Drop Menu Editor

Activating Your Bamboo Product License

Overview of Licensing and and Product Activation

Licenses for Bamboo products that are installed on SharePoint servers are activated in SharePoint Central Administration using the Bamboo Web License Manager. Follow these instructions to activate a Bamboo product license.

NOTE: Licenses for desktop/server applications such as List Bulk Import, User Profile Sync, and List Bulk Export are activated using a standalone version of the licensing application, called Bamboo License Manager. See Activating a Bamboo Desktop Product Using the License Manager for more information.

Before performing the steps listed below, be sure you have installed the Bamboo Web License Manager on your SharePoint farm. See Installing the Bamboo Web License Manager for more information.

Step	Action
1.	From SharePoint Central Administration, click Manage My License Keys under Bamboo Solutions. NOTE: If you don’t see this option listed, see Why isn’t Manage My License Keys displayed in SharePoint Central Administration?
2.	You may see two groupings on the page, Suites and Packs or Individual Products. When activating a Web Part or Application, expand the Individual Products section. Locate the product you need to activate. Hover over a product name to see a drop-down menu associated with the product. Select Activate/Deactivate from the menu.
3.	On the displayed page, the available servers in your SharePoint farm will be listed. You will need an individual License Key for each Web Front End server. Certain products, such as Alert Plus and List Rollup include features that can be run on application servers as well. In these cases, separate licenses may also be required for one or more application servers. NOTE: If some of the servers listed do not receive web traffic, or if there are application servers that do not need a license, you can remove them from the list. Please see Choosing which farm servers to license for more information. To activate a license for a server, type or copy and paste the License Key into the field provided and click Activate. NOTE: If your SharePoint server does not have Internet access, you may get an error when you click Activate. If you experience this, see Activating My Bamboo Product License Offline for more information.
4.	Your Bamboo product is now Active and is ready for use, as shown by the Status column. If you ever need to check which license key you used to activate each server, the license key used is shown on this status page.

Activating Your Bamboo Product License Offline

Overview of Licensing and and Product Activation

Licenses for Bamboo products that are installed on SharePoint servers are activated in SharePoint Central Administration using the Bamboo Web License Manager. Licenses are normally activated online, but sometimes SharePoint servers do not have access to the Internet. If this is the case with your servers, follow these instructions to activate a Bamboo product license offline.

NOTE: Before performing the steps listed below, be sure you have installed the Bamboo Web License Manager on your SharePoint farm. See Installing the Bamboo Web License Manager for more information.

Step	Action
1.	From SharePoint Central Administration, click Manage My License Keys under Bamboo Solutions. NOTE: If you don’t see this option listed, see The Bamboo Web License Manager does not show up in Central Administration. How do I fix that
2.	You may see two groupings on the Manage My License Keys page, Suites and Packs and Individual Products depending on what Bamboo products you’ve installed on the farm. When activating a Web Part or Application, expand the Individual Products section. Locate the product you need to activate. Hover over a product name to see a drop-down menu associated with the product. Select Activate/Deactivate from the menu.
3.	All servers in your SharePoint farm that are running the Microsoft SharePoint Foundation Web Application service will be listed. The license status for each will be Not Active or Trial. You will need an individual License Key for each server. If some of the servers listed do not receive web traffic, you can remove them from the list. Please see Choosing which farm servers to license for more information. To activate a license for a server, type or copy and paste the License Key into the field provided, check the Activate Offline box, and then click Activate.
4.	On the page displayed, a Machine Key will be displayed with the License Key and a space to enter the Activation Key. NOTE: Eight spaces are shown if you are running WSSv3/MOSS. If you are running SharePoint 2010 or 2013, there is just one space. Copy the License Key and the Machine Key to an email and send it to Bamboo’s Support Team at Support@bamboosolutions.com. They will reply via Email with the Activation Key. If you have several servers in your farm, you can send the License Key-Machine Key combinations for all of them in one Email message to the Support Team. Alternatively, you can generate the Activation Key yourself via the My Bamboo area of the Bamboo Solutions website. See Generating Activation Keys using My Bamboo for more information. Once you have the Activation Key, enter it in the space provided and click Activate. NOTE: The Machine Key, as you may have guessed, is tied to the HW profile of the server. As such, the Activation Key is also tied to the HW profile. If the HW profile of a server changes, the License will fail and need to be deactivated and then re-activated, similar to what is required when you move your farm to new servers. See Migrate your Bamboo Product License Key From one SharePoint version to another for more information on what to do when this happens.
5.	After the license is activated, it’s status will be displayed on the page.

How to activate a Bamboo Site Collection Feature

Product feature activations can be done automatically at the site collection level when the product is installed using the Bamboo Installation/Setup program. However, there are a few reasons why you may need to manually activate (or deactivate) Bamboo product features:

You are using the updated installation process for Bamboo components.
You opted out of automatic feature activation during installation using the older Setup program.
You added a new site collection and want to add Bamboo features to it.
You want to remove Bamboo product features from an existing site collection.

To manually activate (or deactivate) Bamboo product features, follow the instructions below.

IMPORTANT: Perform these steps using an account that is a Site Collection Administrator.

Step	Action
1.	From a page on the top level site of a site collection, click Site Actions and then Site Settings. In the Site Collection Administration section of the page displayed, click Site collection features. If you don’t see this section, you may not be a Site Collection Administrator. If you don’t see the link, you may not be on the top level site of the collection. A list of available features will be listed.
2.	Find the appropriate feature. The status column indicates if the feature is currently active. If it hasn’t yet been activated, click the Activate button. If it’s activated and you need to Deactivate, click Deactivate. For information about which feature to activate for a particular product, please see this article.

Step

Action

From a page on the top level site of a site collection, click Site Actions and then Site Settings. In the Site Collection Administration section of the page displayed, click Site collection features.

If you don’t see this section, you may not be a Site Collection Administrator. If you don’t see the link, you may not be on the top level site of the collection.

A list of available features will be listed.
SCA-Active SCFeatures.png

Find the appropriate feature. The status column indicates if the feature is currently active. If it hasn’t yet been activated, click the Activate button. If it’s activated and you need to Deactivate, click Deactivate.

For information about which feature to activate for a particular product, please see this article.

About the Installation Files

Options for Installing

image showing install files for Tree View web part When you extract the product EXE to a location on your SharePoint server, several folders are created that contain installation files and Setup program configuration files. The root level of the extracted file system includes the file Setup.bat, which launches the Setup program. The list below shows the installation files for the Tree View Web Part, as an example.

For manual installation, you will access the following folders that contain installation files:

Component.wsp: There may be several folders with names ending in .wsp, depending on your product. Each WSP folder contains the installation files for a specific SharePoint Solution. One or more SharePoint Solutions may be installed for each product component.
docs: Contains the Installation and Licensing Quick Start Guide.
misc: The MISC folder includes miscellaneous files, including PowerShell scripts for manually installing or uninstalling the product.
msi: If a MSI folder exists for your product, it could contain multiple files ending in .msi. Each is an installation executable. Some MSI installers in the msi installation folder have both a 32-bit and a 64-bit version. The 64-bit version will include .x64 in the file name. Run the version of the MSI that is appropriate for your operating system. Do not install both.
res: Contains files required by the Setup program but not necessarily needed during a manual install.

A license error occurs after successful license activation

SYMPTOM

You followed the directions in Activating Your Bamboo Product License successfully activated your license. However, when you go to a page where the web part is used you see a license error:

license error on web part page.png

CAUSE

If this happens immediately after successful activation, the error is typically that one or more WFE servers on the farm do not have an activated license. If you are sure all servers have been successfully activated, another cause could be that a trial extension file (.lic) remains on one of the WFE servers in the farm and is causing a conflict.

If the license error happens after you have been using your activated product for some time, the cause for the issue could be that the hardware profile of one of your WFE servers has changed. Bamboo product licenses are tied to the hardware profile. If that profile changes (i.e., you add a new hard drive), the license needs to be re-activated. See How to move your Bamboo Product License to a new server for resolution information.

RESOLUTION

Confirm that there are no Bamboo trial extension files (Bamboo.lic) on the any of the WFE servers. Follow these steps:

Step	Action
1.	From the SharePoint server, use Windows Explorer to drill down the inetpub folder structure to locate and access the appropriate virtual directory for the web application where the license error appears.
1.	Locate the ‘bin’ folder where the Bamboo product’s DLL should be found.
1.	Search for files that start with “Bamboo” and have a .lic extension. If one exists for the product with the license issue, delete it. NOTE: Be sure to check all WFE servers for the .lic file.

Step

Action

From the SharePoint server, use Windows Explorer to drill down the inetpub folder structure to locate and access the appropriate virtual directory for the web application where the license error appears.

Locate the ‘bin’ folder where the Bamboo product’s DLL should be found.

Search for files that start with “Bamboo” and have a .lic extension. If one exists for the product with the license issue, delete it.

NOTE: Be sure to check all WFE servers for the .lic file.

About Bamboo product Release Numbers

Overview

Bamboo products have several releases throughout the year. To understand more about the type of releases available, see the Bamboo Solutions Upgrade Policy.

Its important to know what release you have installed on your farm because:

You can better follow the Release Notes for the product, which tell you about new features and known limitations for each version/release.
If you are planning to migrate to a new version of SharePoint, you need to make sure you have a certain minimum version/release installed.
If you need to report an issue to our Support Team, they will need to know what version/release you are using.

Where to find Release Notes

As you look at each product’s documentation page, you will see there is a link to the Release Notes for that product at the top of the page.

Bamboo produces different version numbers of our products for the different SharePoint platforms.

SharePoint 2007 (WSSv3/MOSS) Release Numbers

If you are running SharePoint 2007, the version/release number consists of 4 parts, such as:

R1.2.3.0

The first digit indicates the Major Release. In the case above, this is “1”.
The second digit indicates the Minor Release (2 in the example above).
The third number indicates the build number.
The fourth number will always be 0 unless you are using SharePoint 2013 (see explanation below).

SharePoint 2010 Release Numbers

If you are running SharePoint 2010 (SharePoint Foundation 2010 or SharePoint Server 2010), the Major Release digit of the installed product’s file version includes a zero (0) in the digit such as:

10.2.3.0

To match your current installed product with the release notes, remove the first zero (0). The end result is version 1.2.3.0.

SharePoint 2013 Release Numbers

If you are running SharePoint 2013 (SharePoint Foundation 2013 or SharePoint Server 2013), the Major Release digit of the installed product’s file version includes a zero (0) and the fourth digit is “2013” such as:

10.2.3.2013

To match your current installed product with the release notes, remove the first zero (0) and the 2013. The end result is version 1.2.3.0.

Background

Resolution

Applies To

Calendar Plus

Chart Plus

Cross List

Data-Viewer

List Rotator

List Search

Mini Calendar

Navigators

Password Change

PM Central

Team Calendar

Virtual Map View

NOTES:

Results of Skin Changes

Overview

General Migration Restrictions for Bamboo Products

Migration Restrictions for Specific Bamboo Products

SYMPTOM

CAUSE

RESOLUTION

Overview

Where to find Release Notes

SharePoint 2007 (WSSv3/MOSS) Release Numbers

SharePoint 2010 Release Numbers

SharePoint 2013 Release Numbers