Web Platform Install¶
Team Flex¶
This document covers the setup and installation of TeamFlex from a zip release. Requirements for installation are presented with an overview of the standard download structure.
Standard Structure
Requirements / Pre-Requisites¶
- Windows Server 2k8 R2
- .NET 4.0
- ASP.NET MVC 3 RTM (http://www.microsoft.com/downloads/en/details.aspx?FamilyID=d2928bc1-f48c-4e95-a064-2a455a22c8f6&displaylang=en)
- SharePoint 2007 or SharePoint 2010. TeamFlex interfaces with the SharePoint web services (Lists services) so as long as you have an installation available with these web services already running you can simply provide some details to TeamFlex during configuration presented later in this documentation. If you don't already have a SharePoint server setup, you might like to start with SharePoint Foundation Server 2010 which is Micorsoft's new SharePoint offering (http://www.microsoft.com/downloads/en/details.aspx?FamilyID=49c79a8a-4612-4e7d-a0b4-3bb429b46595&displaylang=en). This will be fine for a TeamFlex installation, but you might like to consider what other requirements your business has or might have in the future before arriving upon a particular version of SharePoint. As previously states, the key integration from TeamFlex with SharePoint is through SharePoint web services. You can choose any version of SharePoint >= 2007 that includes the SharePoint list web services (formerly WSS3).
The standard structure of the VastSocial website looks like this;
TeamFlex/bin
TeamFlex /Content
TeamFlex /Plugins
TeamFlex /Views
TeamFlex /Global.asax
TeamFlex /packages.config
TeamFlex /Web.config
Configure Cache¶
When TeamFlex is running within IIS, IIS requires read and write access to the /Content/Cache folder within the TeamFlex website. This cache folder is used to cache thumbnails and images used by TeamFlex
1. Navigate to the root of the website within windows explorer and find the content folder and within the content folder there should be a Cache folder
2. Right click on the cache folder and go to properties > Security > Edit > Add dialog
3. Enter the IIS user name that the website is running under (On this windows server 2k8 machine it is IIS_USRS)
4. Grant Read/Write access
Website Configuration¶
The following is a list of configuration options available in the TeamFlex web.config file found within the root of the TeamFlex website folder. These will be key/value settings within an <appSettings> tag. Please note that the key names should NOT be changed. The system references these settings in order to obtain their mapped values. It is the values of these keys which should be configured for the intended operating environment.
| Key | Description | Example |
|---|---|---|
| VastService.VastId.MinPasswordLength | The minimum password length required when creating new VastId accounts via TeamFlex. | 6 |
| VastService.VastId.DomainId | The database identifier for the VastId domain TeamFlex will be bound to. | 1 |
| VastService.VastId.DomainName | The name of the VastId domain matching the previously set domain identifier. | YourCompany |
| VastService.VastId.ServiceUri | The service URI to a hosted VastId service. | http://id.vastpark.com/VastId |
| VastService.VastCommunity.ServiceUri | The service URI to a hosted VastCommunity service | http://id.vastpark.com/VastCommunity |
| VastPark.ApiKey | This is a unique generated key that Is used to identify a VastSocial instance with VastServices | {generated_key} |
| VastPark.SharePoint.Site | The domain where a sharepoint site can be found | sharepoint.yourcompany.com |
| VastPark.SharePoint.Username | An administrative username TeamFlex can use to communicate with SharePoint | sp_teamflex |
| VastPark.SharePoint.Password | An administrative username TeamFlex can use to communicate with SharePoint | av3#z$1UPs3$! |
| VastPark.Web.ThemeName | The theme directory name. | PlayerDark |
| TeamFlex.Breadcrumb.Length | The number of breadcrumb items appended to the bread manager in TeamFlex. | 6 |
Please note that all values above are examples only and should be substituted with the proper values corresponding to your deployment configuration and environment. The VastService.VastId.DomainId and DomainName respectively should be retrieved from a record in the membership entity table of your VastId database describing the VastId domain.
Website Deployment¶
This section describes how this package is intended to be deployed in IIS 7.
1. Extract the TeamFlex zip file to you host location (this will likely be next to your VastServices folder).
2. In Internet Information Services (IIS) manager Right Click the ‘Sites’ folder and select ‘Add Web Site’.
3. Fill out the following dialog and hit OK. Remember the application pool name (it will default to having the same name as the site).
4. Select Application pools and find the one which corresponds to the website you just added. Check that the .Net version is v4.0 or above.
5. To change the version right click the application pool and select advanced settings. Find .Net Framework version and using the drop down list select v4.0.
Once the above change has been confirmed the installation process is now complete.
6. In your web browser of choice navigate to the your TeamFlex page. This address will depend on your individual settings.
