When you purchase a TeamForge license, you get the right to assign licenses to a specified number of users.

TeamForge License Framework

TeamForge supports a more flexible and granular approach to tool instantiation. TeamForge’s license model consists of the following license types: ALM, SCM, Version Control, DevOps, Collaboration, Trackers, and Baseline (Beta). These license types are tailored to suit the needs of specific set of users that need access to certain tools and functions. A TeamForge user’s license type determines the tools available to the user in TeamForge.

While TeamForge supports more selective tool options with these new license changes, there’s no impact on customers, both new and existing, requiring all the tools that TeamForge supports.

The following table lists the license types and the tools that go with them (refer to the table at the end of this topic for a complete list of tools and functions).

License Type Available Tools
ALM Offers the full range of ALM tools and functions to users.
SCM Offers core Source Code Management tools and functions to users. Includes all the ALM tools and functions but Tracker and Documents component.
Version Control Offers Source Code Management, File Releases and Review tools and functions to users.
DevOps Package Management (Application & Environment) and File Releases tools and functions to users.
Collaboration Offers a range of collaboration tools such as Documents, Wiki and Discussion Forums to users.
Trackers Offers TeamForge’s Tracker capability (Trackers, Planning Folder, Teams, Planning Board, Task Board and Kanban Board) to users. Also includes File Releases.
Baseline (Beta) Offers the baseline capability for Tracker Artifacts, Documents, Source Code Repositories (Git and Subversion), File Releases, and Binaries (Nexus).
In addition to the tools offering, the Reporting framework is also controlled by the licenses you have. Meaning, you can view and generate reports based on the license types assigned to you. For example, you must have SCM license to view or generate SCM activity reports. Check with your CollabNet representative if you aren’t sure how many licenses or what kind of licenses you want/have.
  • Your license key contains a few important numbers:
    • The number of users eligible to use specific licenses such as ALM, SCM, DevOps, Version Control, Collaboration, Trackers, and Baseline.
    • The IP address of the machine that your site runs on.

      For example, if your organization has 80 users who will use only the source code management features, 10 users who will use DevOps and 100 users who need the Application Lifecycle Management features, your license key string may look like this:

      ALM=100:SCM=80:DEVOPS=10:supervillaininc:144.16.116.25.:302D02150080D7853DB3E5C6F67EABC65BD3AC17D4D35CB3Z00214141D70455B18583BF0A5000CA56B34817ADF8DBFI32353A6E657492617369633A38372E3139342E3136102E31322E
      
  • Your license key only works for the IP address (or range of addresses) of the hardware that your CollabNet TeamForge is running on, as specified in your order form. If your site uses a separate server for its database or source code repositories, make sure your license key reflects the IP addresses of all the necessary servers. If any of these addresses change, ask your CollabNet representative to generate a new key.
  • When you create a user account, you can assign the user with available licenses.
  • You can purchase a TeamForge license for as many years as you want. The validity period is encoded into your license when it is generated by your CollabNet representative.
  • How many users your site can support depends on the type of license. Check with your CollabNet representative if you aren’t sure what kind of licenses you have.
  • Your license key is attached to the IP address of the server where your site runs. You can get a license key for a single IP address or for a range of IP addresses.
  • Your service year starts the first time you log into your site, or the first time you create or edit any item on your site, such as a tracker artifact or a document. Whichever of these events comes first starts the clock.
  • The expiration date of your license is shown on the License Info page. (Go to My Workspace > Admin and select Projects > License Info).
  • When your service year expires, you can still see the project data on your site, but you cannot make any changes to it. However, you can still carry out some critical maintenance functions for your site:
    • Enter a new license key.
    • Deactivate or delete users.
    • Change user passwords.
    • Get forgotten user passwords.

Tools Availability Matrix

Tools ALM SCM Version Control DevOps Collaboration Tracker Baseline (Beta)
Agile Task and Planning Boards
Trackers
Git/SVN Repository Management and Replication
Code Review
Build Automation
Test Management
File Releases
Binary Repository Management
EventQ/Activity Stream
Access Controls
Project Work Spaces
Wiki and Discussion Forums
Document Management
User Management
Flexible Process and Toolchain Templates
Reusable Dashboards
Categories and Groups
Cross Project Visibility
Cross Project Reporting and Dashboards
Cross Project Search
Site-wide Administration
Custom Branding and Custom Integrations
Security Architecture
Onsite and Hosted Provisioning
SVN Auto Updates
SVN Repository Backup and Monitoring
Baselines

Supply Your TeamForge License Key via Teamforge User Interface

Your license key enables you to use CollabNet TeamForge for the period of your contract.

Your license key will only work for the IP address of the machine that your CollabNet TeamForge is running on, as specified in your order form.

These steps are for installing your license key via the web interface. If you prefer, you can install it as a text file instead. See Supply your TeamForge License Key as a Text File.
  1. Locate the confirmation email you received from your CollabNet representative when you purchased your contract.
  2. Log into your site as a Site Administrator.
  3. Click Admin > License Info.

    If you have entered a license before, the IP address and current licensed number of users on your site are listed on the License Key page. Verify that the IP address is the same as the one you entered in your order form.

  4. Click Enter License Key.
  5. Copy your new license key from the confirmation email and paste it into the Enter License Key field.

    A license key string looks like this:

    ALM=100:SCM=80:DEVOPS=10:supervillaininc:144.16.116.25.:302D02150080D7853DB3E5C6F67EABC65BD3AC17D4D35CB3Z00214141D70455B18583BF0A5000CA56B34817ADF8DBFI32353A6E657492617369633A38372E3139342E3136102E31322EE
    
  6. Click Save.
  7. Verify that the new value for Licensed Number of Users matches the total number of licensed users in your contract.

Supply Your TeamForge License Key as a Text File

Your license key enables you to use CollabNet TeamForge for the period of your contract.

Your license key will only work for the IP address of the machine that your CollabNet TeamForge is running on.

  1. Locate the confirmation email you received from your CollabNet representative when you purchased your contract.
  2. Create a text file and copy-paste your license key from the confirmation email into it.

    For example, if your organization has 80 users who will use only the source code management features and 100 users who need the full range of application lifecycle management features, your license key string may look like this:

    alm=100:SCM=80:supervillaininc:144.16.116.25.:302D02150080D7853DB3E5C6F67EABC65BD3AC17D4D35CB3Z00214141D70455B18583BF0A5000CA56B34817ADF8DBFI32353A6E657492617369633A38372E3139342E3136102E31322E
    
  3. Save the text file as /opt/collabnet/teamforge/var/etc/sflicense.txt
  4. Make the license file usable by the application.
    chmod 0664 /opt/collabnet/teamforge/var/etc/sflicense.txt
    chown <APP_USER>:<APP_GROUP> /opt/collabnet/teamforge/var/etc/sflicense.txt
    

    Change the values of <APP_USER> and <APP_GROUP> with the values of APP_USER and APP_GROUP tokens respectively from the /opt/collabnet/teamforge/runtime/conf/runtime-options.conf file.

View License Information

You can obtain a summary of the license information from the License Info page.

The License Info page provides you with all the basic information about the licenses you purchased for your TeamForge site. This includes details such as the number of TeamForge licenses you had obtained, how many you have used, expiration date and so on.

  1. Go to My Workspace > Admin.
  2. Select LICENSE INFO from the Projects menu.