Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Project Control Center (PCC) is a platform that allows project administrators to set up the projects when they get associated with The Linux Foundation. You can set up the projects to use various services that are provided by The Linux Foundation.
PCC assists you to onboard an open source project with great ease. Project Control Center helps you get started quickly by providing all the support that you need with self-service configuration for governance, membership, IT, developer and collaboration tools, documentation, and community roles. You can read more about PCC by visiting our website.
PCC allows you to use various services that are provided by The Linux Foundation which will help the company or foundation to manage and administer the project in an efficient and effective way.
You can access PCC using the following URL:
You will get the access_denied message, if your are accessing the link for the first time. You need to click link to provide your contact details to the support team.
The support team will verify the account, and will authorize the associated SSO account.
The following graph illustrates the features offered by Linux Foundation PCC:
Some of the services that are offered through PCC by Linux Foundation are:
When you add a new project, you need to setup the project with some basic and generic services to administer the project in an effective way. The following are the Setup services for your project that are offered by Linux Foundation:
The following graphic provides a brief information on various setup services and its uses:
You can host your project in the Linux Foundation. Once the company decides to host its project on the Linux Foundation, you (administrator) needs to create a project for every new company that hosts their projects or foundation on Linux Foundation using PCC.
As a administrator, you need to create the projects and sub projects as per the needs of the company.
To add a main project on the PCC, perform the following steps:
1.Login into PCC.
If you do not have access to PPC, you need to raise the service ticket to get access to PCC. Refer .
2.The PCC dashboard appears. Click +Add Project.
3.The Add dialog box appears. Update the following details and click Add Project.
4. A success message is displayed when a project is created successfully. A can see the newly added project under My Projects tab.
For a new project, by default the project status is set to Prospect. You can change the status in the Basic setup service.
​
Category
Category will be enabled only when you select a Parent Project. You can select the project to categorize for better grouping and navigation.
Field
Action
Common Name
Enter the name of the project that you identify the project name with.
Slug
Slug will be auto added when you provide the common name. You can also edit it if you need.
Parent Project
Select the parent project if you want to associate or add your project as a child project.
Select No Parent, if you do not want to add any parent project.
PCC has a dashboard that provides you with the list of projects that are available in Linux Foundation. You can see the affiliated projects under MY PROJECTS tab. You can all also view all the project details in All PROJECTS tab.
This dashboard provides details such as:
Project name
Logo
Number of sub projects in the main project
Details of the sub project
Stage or the status of the project
The following icons are available on the dashboard:
To access PCC dashboard and its services, you need to login into using your LF SSO account. As you login into the PCC, the Dashboard appears.
The Show archived projects toggle button allows you to show or hide the archived projects from the list.
MY PROJECTS tab provides you the list of projects which are affiliated with you or your organization.
In case, if you don not see the projects that are managed by you, you can create a ticket for this.
To create a support ticket, perform the following steps:
1.Click Get Help and select Support.
2.You will be navigated to the LFX Support page. You have to enter the relevant details and click Create to submit your support request.
All Projects lists all the projects that are created irrespective of who has created them.
You can search for the required project using the search tabs available on right top of the dashboard as well as on the left menu bar.
​
Membership setup of project allows you to view information on:
Membership Billing
Membership Tier
Legal Setup
Membership Setup
IT Services
Domains
Mailing List
Issue Tracking
Meetings
Email Forwarding
Source Control
Wiki
Cloud Providers
Tools Status
EasyCLA
Security
Crowd Funding
Insights
Mentorship
General Icons
Progress Bar
Running
Warning
Disabled
Icons
Description
Setup Services
Basic Setup
Committees Setup
You can view membership billing information related to the project such as auto renew, payment frequency, prorated information and invoicing.
To view membership billing information for a project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Membership from the SETUP STATUS tab.
You can also navigate to Membership from the Vertical Sidebar navigation menu. Click Setup and then select Membership.
3. The Membership page appears. You can view the membership billing information details related to the project.
You can view membership tier information related to the project such as name, pricing type, price point, membership term and description.
To view membership tier information for a project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Membership from the SETUP STATUS tab.
You can also navigate to Membership from the Vertical Sidebar navigation menu. Click Setup and then select Membership.
3.The Membership page appears. You can view the membership tier information details related to the project.
To view committee for a project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Committees from the SETUP STATUS tab.
You can also navigate to Committees from the Vertical Sidebar navigation menu. Click Setup and then select Committees.
3.The Committee page appears. You can view the committee details related to the project.
​
​
​
PCC allows you to set up the Zoom account which can be used to setup a meeting and can be used as a chat application.
To setup a Zoom account for a meeting, perform the following:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Meetings from the IT SERVICES STATUS tab.
You can also navigate to Meetings from the Vertical Sidebar navigation menu. Click IT Services and then select Meetings.
3.The Zoom page appears. Click the Add Zoom Account button to add a Zoom account.
4.The Add Zoom Account dialog box appears. Enter the Account Name, Project Email Alias or Custom Email Address / Email Alias and click Add.
5.To create a New Project Email Alias, click Create New. The Create New dialog box appears. Enter the Alias name and provide the Recipients details. To add more recipients, click Add Recipient. Click Add to create an new Project Email Alias.
After successful setup of the account, the account will be listed under Account Name along with the Host(s) Email ID.
To edit the existing Zoom account, click the edit icon and update the changes.
To delete the existing Zoom account, click the delete icon. A confirmation message appears, click Yes to delete the Zoom account.
​
You can setup a knowledge base and documentation for your project using Confluence. The team can use this documentation repositories to create articles and documentation knowledge base related to the project.
PCC supports the following documentation tool:
Confluence
PCC allows you to setup Confluence repository for your project to create documentation related to your project.
To setup Confluence for your project, perform the following:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Wiki from the IT SERVICES STATUS tab.
You can also navigate to Wiki from the Vertical Sidebar navigation menu. Click IT Services and then select Wiki.
3.You have two option to setup a Confluence page:
Connect to existing
Deploy New
a) If you want to connect to the existing server, Click Connect Existing. Enter URL of the existing server and click Connect. The Confluence page will be setup to the existing server.
b) If you want to connect to a new server, Click Deploy New. Enter Cloud Provide details and click Deploy. The Confluence page will be setup to a new service provider.
​
Legal setup of project allows you to view information on:
Legal Details
You can view legal details related to the project such as parent object, entity type, legal parent, formation date, uploading governance document, managing services agreement and many other details.
To view legal details for a project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Legal from the SETUP STATUS tab.
You can also navigate to Legal from the Vertical Sidebar navigation menu. Click Setup and then select Legal.
3.The Legal page appears. You can view the legal details related to the project.
​
​​EasyCLA streamlines the management and execution of Contributor License Agreements (CLAs), to help projects ensure that contributions are made in accordance with project policies. It is the only CLA management tool to correctly support both individual and corporate CLA workflows in an automated environment.
To setup the EasyCLA service using PCC:
1.Login into PCC.
2. Search for the required project. On Project dashboard , click CLA under the TOOLS STATUS tab.
You can also navigate to CLA from the Vertical Sidebar navigation menu. Click Tools and then select CLA.
3.For detailed information on how to setup the CLA, see .
​
IT services allows you to setup the IT infrastructure for your project. Various IT services that are provided by Linux Foundation and that can be used to setup for a project are listed as follows:
The IT services dashboard provides you with the progress bar that indicates the progress on your IT services setup for your project. The green progress bar indicates that the setup has been initiated for your project whereas a grey bar indicates that the setup has not been started on your project.
The following graphic provides a brief information on various IT services and its uses:
​
You can also navigate to Cloud Providers from the Vertical Sidebar navigation menu. Click IT Services and then select Cloud Providers.
3.The Cloud Providers page appears. You need to enable the AWS account first, click Create to enable the account.
4.The associated AWS account will be enabled for the project. The green tick under the status will indicate that the AWS is successfully enabled for the project.
You can also associate a different AWS account for a project.
To associate other AWS account, perform the following steps:
1.Search for the required project. The Project dashboard appears. Click Cloud Providers from the IT SERVICES STATUS tab.
2.The Cloud Providers page appears. Click icon from the Other AWS Account. Enter the AWS Account ID and click Connect.
​
​
A domain name provides a unique identity for your project. You can set up a unique domain name that will allow you to have a administrative autonomy as well as control within the internet world.
To setup a domain for the project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Domains from the IT SERVICES STATUS tab.
You can also navigate to Domains from the Vertical Sidebar navigation menu. Click IT Services and then select Domains.
2.The Domains page appears. Click + Add Domain to add a domain for your project.
You cannot change the primary domain for the project, if you want to change the primary domain, you need to raise a support ticket.
You can update the domains details by click of the edit icon.
3.The Add Domain dialog box appears. Enter the Domain Name and click the Check Availability button.
4.The domain will be searched and checked against the following points:
The domain is already owned by the project that's being setup
The domain is already owned but by another project (when the project name unknown)
The domain is already owned but by another known project.
5.If the domain name is available, a green tick mark is displayed next to the Domain Name. Click the Register Domain button to register the domain. Refer Register Domain for more details.
6.If the domain is already taken by an another project, you have the option to bid for that domain. Refer Bid Domain for more details.
You should have the domain setup for a project in order to setup other IT Services such as Mailing List, Wiki, Issue Tracking, and Email Forwarding services.
You can setup a primary domain for a project within the available and registered domains for a project.
To setup a primary domain for a project, perform the following:
1.Go to the Domains page for the required project. The domain page appears with the list of domains registered with the project.
2.Place the cursor in the Search Domain box, select the required domain and click the Set As Primary Domain button.
3.The domain will be selected and listed as Primary Domain.
You can redirect a domain from one domain to another. Redirects are a way to forward visitors and search engines to a different URL than the one they requested. You can use redirects when you’re moving content around and you want the content to retain its value.
To redirect a domain from one domain to another domain, perform the following:
1.Go to the Domains page for the required project. The domain page appears with the list of domains registered with the project.
2.Click icon available under Manage pane.
3.The Edit Domain dialog box appears. Click Redirects, enter the redirect domain under To box and click Add.
4.The redirected domain is listed under Existing Redirects list.
If you want to update the redirect domain, click the edit icon.
If you want to delete the redirect domain, click the delete icon.
You can add service record such as Pantheon, Netlify and GitHub pages for your domain.
To setup service record, perform the following steps:
1.Go to the Domains page for the required project. The domain page appears with the list of domains registered with the project.
2.Click icon available under Manage pane.
3.The Edit Domain dialog box appears. Click Services, select the required Service from the list and click Add.
4.The service records are listed under Existing Service Records list.
​
​
​
Basic setup of project allows you to view information related:
Basic
Branding
Personnel
You can update basic information related to the project such as common name of the project, stage of the project, slug name.
To update basic information for a project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Basic from the SETUP STATUS tab.
You can also navigate to Basic from the Vertical Sidebar navigation menu. Click Setup and then select Basic.
3.The Basic page appears. Click Edit available in the Basic tab.
4.The Edit Basic dialog box appears. Update the following details and click Save.
You can also provide details related to branding of the project like uploading the logo for the project, providing brand color and website details.
To update branding information for a project, perform the following steps:
1.Click on the required project and click Basic.
Basic
2.The Basic Edit page appears. Click Edit to update the basic details.
Edit
3.The Basic dialog box appears. Click Branding, update the following details and click Save:
Branding Details
Basic setup also allows you to update personnel information like executive name, owner details, and program manager details.
To update personnel information for a project, perform the following steps:
1.Click on the required project and click Basic.
Basic
2.The Basic Edit page appears. Click Edit to update the basic details.
Edit
3.The Basic dialog box appears. Click Personnel, update the following details and click Save:
Personnel Details
Expected Announcement Date
Select the date when the project will be released.
Technology Sector
Select an appropriate technology sector for your project. You can also select more then one sector.
If you feel that your project falls across all sectors, check the Cross Technology box.
Industry Sector
Select an appropriate industry sector for your project. You can also select more then one sector.
If you feel that your project falls across all sectors, check the Cross-Industry box.
Technical Activity
Select an appropriate technical activity for your project. You can also select more then one sector.
Funding
Select funding type for your project. If you select the funding type as Funded, then the Model field becomes mandatory.
Model
Select an appropriate model for your project. This filed becomes mandatory when the funding type of your project is Funded.
CII Project ID
Enter the CII Project ID.
Description
Provide a short description for your project.
Field
Action
Common Name
You can update the common name that you have provided at the time of creating the project.
Category
Category can be updated only when you have selected a parent project at the time of creating the project.
Stage
Select the appropriate stage of the project. By default, the stage is selected to Prospect when you create a new project.
The LFX Security tool provides automated vulnerability scanning and provides visibility into potential vulnerabilities to help projects address top security concerns.
For more information on Security Services, visit Security Documentation.
Onboarding projects into LFX Security is done from the PCC (Project Control Center). As part of this onboarding a Security Bot is installed on GitHub Organizations of the project.
To setup the Security service using PCC, perform the following steps:
1.Login into .
2. Search for the required project. The Project dashboard appears. Click Security from the TOOLS STATUS tab.
You can also navigate to Security from the Vertical Sidebar navigation menu. Click Tools and then select Security.
3.The Security page appears. Enter the GitHub organization name in the Organization Name and click Connect.
Make sure that you logged into the GitHub.
4.The Install Security Bot on GitHub.org instructions page appears. You can read the instructions on how to install the Security Bot from this page. Click Install Security Bot button.
5. A list of GitHub organization associated with the login account are listed and displayed. Select the required organization for which you want to install the Security bot.
6.The Install & Authorize LFx Security GitHub App page appears. This page provides the following information:
Information on the permission requested for the selected repositories. The LFX Security requests the following permissions from the GitHub:
Read access to administer, code, check commit status, lookup members, and other metadata.
Read and write access to organization hooks, pull requests, and repository hooks.
Click Install & Authorize to install the LFX Security GitHub App.
7.The LFX Security Service GitHub app is installed successfully. You can see the installation success message.
You will also receive an email after successful installation of the LFX Security GitHub App.
8.In the PCC page, you need to click I'm Done Installing the Security Bot after completing the installation process.
9.You can see the list of GitHub organizations along with the repositories for which the Security bot has been successfully configured.
A green dot present with the GitHub organization name indicates that the Security bot is successfully installed.
You can uninstall the security bot at any point of time from the PCC. When you uninstall the security bot, the security scanning for the GitHub organization is discontinued. You cannot see the vulnerabilities associated with your GitHub organizations.
To uninstall Security service from PCC, perform the following steps:
1.Login into .
2. Search for the required project. The Project dashboard appears. Click Security from the TOOLS STATUS tab. The GitHub organizations are listed, select the settings icon and click Disassociate GitHub Org.
3.The Uninstall Security Bot on GitHub.org instructions page appears. You can read the instructions on how to uninstall the Security Bot from this page. Click Uninstall Security Bot button.
4.The LFx Security GitHub App opens in a new tab. Click Uninstall from the Danger Zone.
You can uninstall the Security bot from all the repositories associated with your GitHub organization by selecting All Repositories or select specific repositories for which you want to uninstall the Security bot by selecting Only Select Repositories.
5. A pop message appears informing that the Security bot will be uninstalled for the selected repositories. Click OK to continue with the uninstallation process.
6.In the PCC page, you need to click I'm Done Uninstalling the Security Bot after completing the uninstallation process.
7.The GitHub repositories will be removed from the Security dashboard. But, you can see the GitHub organization name in the Security dashboard.
A red dot present with the GitHub organization name indicates that the Security bot is successfully uninstalled.
8.If you want to remove the GitHub organization completely from the Security dashboard, click Disassociate Organization.
9.A pop message appears informing that the GitHub organization will be disassociated. Click Disassociate to continue with the disassociation process.
You have an option to suspend the Security service scanning without uninstalling the Security bot. When you suspend the Security service, the bot will not be uninstalled. You can revoke the suspension at any point of time by Unsuspending.
To suspend the Security service, perform the following steps:
1.Login into .
2. Search for the required project. The Project dashboard appears. Click Security from the TOOLS STATUS tab. The GitHub organizations are listed, select the settings icon and click Configure Security Bot.
3.The LFx Security GitHub App opens in a new tab. Click Suspend from the Danger Zone.
4.A pop message appears informing that the Security bot will be suspended. Click OK to continue with the suspension process.
5.The GitHub repositories are suspended from the Security dashboard.
A orange dot present with the GitHub organization name indicates that the Security bot is suspended.
To revoke the suspended Security service, click settings icon and click Configure Security Bot and click Unsuspend from the Danger Zone.
​
After setting up the domain for a project, you can setup the email services for the project. The email forwarding services will allows you to enable email service and add recipients emails.
You need to have a Primary Domains setup for the project in order to enable Email Forwarding service.
To enable email forwarding, perform the following:
1.Login into PCC.
Installing and authorizing LFX Security GitHub App grants these permissions on your account:
Read access to emails
Access to the repositories. You can either provide access to all the repositories or selected repositories within the GitHub Organization.
You can also navigate to Email Forwarding from the Vertical Sidebar navigation menu. Click IT Services and then select Email Forwarding.
3.The Email Forwarding page appears. Click Enable to enable the email forwarding service.
You can add the email recipients after enabling the email forwarding service. Adding email recipients allows the users to use project domain specific email service. Using domain specific email service will help to have more secured email exchanges among the users associated with the project.
To add email recipients, perform the following:
1.After enabling the email forwarding service, the Email Forwarding page appears. Click + Add Forward.
2.The Add Email Forwarding dialog box appears. Enter the Alias name. Click Add Recipient and enter the email ID and click Add.
​
Mailing List is a collection of names and addresses used by an individual or an organization to send material to multiple recipients. PCC allows you to setup different mailing list which will allow you to send the mails to the concerned mailing lists.
In order to send an email to a particular mailing list, you need to enable the mailing list first.
To enable the Mailing List, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Mailing Lists from the IT SERVICES STATUS tab.
You can also navigate to Mailing List from the Vertical Sidebar navigation menu. Click IT Services and then select Mailing List.
3.The Mailing List page appears. You need to enable the Mailing List first, enter the Service Administrator Email ID and click Enable.
4.If the email is valid, the Mailing List will be successfully setup.
After setting up the Mailing List, you can add a Service Administrator to the Mailing List.
To add a Service Administrator to the Mailing List for a project, perform the following steps:
1.Search for the required project. The Project dashboard appears. Click Mailing Lists from the IT SERVICES STATUS tab.
2.In the Group & Service Admin tab, click +Add Service Administrator.
3.The Add Service Administrator dialog box appears. Enter the Full Name of the user and the Email Address and click Save.
If you want to update the existing Service Administrator details, click the edit icon.
If you want to delete the existing Service Administrator, click the delete icon.
You can manage the committee for the mailing list, for more details, please refer .
After setting up the Mailing List, you can add different mailing list.
To add a Mailing List for a project, perform the following steps:
1.Search for the required project. The Project dashboard appears. Click Mailing Lists from the IT SERVICES STATUS tab.
2.In the Additional Mailing List tab, click Add Mailing List.
3.The Add Mailing List dialog box appears. Update the following details and click Submit:
​
​
Issue Tracking service allows you to setup the Jira board to track issues and backlog activities related to your project. You can setup the Jira board, add, update and delete service administrators.
You can deploy a new Jira board to your project.
To deploy a new Jira board for a project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Issue Tracking from the IT SERVICES STATUS tab.
You can also navigate to Issue Tracking from the Vertical Sidebar navigation menu. Click IT Services and then select Issue Tracking.
3.The Issue Tracking page appears. Click the icon available in front of Connect Existing/Deploy New and click Deploy New, enter the Jira URL and then click Deploy.
You an option to connect to the existing Jira board to your project.
To connect to the existing Jira board for a project, perform the following steps:
1.Search for the required project. The Project dashboard appears. Click Issue Tracking from the IT SERVICES STATUS tab.
2.The Issue Tracking page appears. Click the icon available in front of Connect Existing/Deploy New and click Connect Existing, enter the existing Jira URL and then click Connect.
After setting up the Jira board, you can add a Service Administrator to the Jira board.
To add a Service Administrator to the Jira board for a project, perform the following steps:
1.Search for the required project. The Project dashboard appears. Click Issue Tracking from the IT SERVICES STATUS tab.
2.In the Jira tab, click +Add Service Administrator.
3.The Add Service Administrator dialog box appears. Enter the Full Name of the user and the Email Address and click Save.
If you want to update the existing Service Administrator details, click the edit icon.
If you want to delete the existing Service Administrator, click the delete icon.
You can add different Jira projects under your Jira board.
To add a Jira project to the Jira board, perform the following steps:
1.Search for the required project. The Project dashboard appears. Click Issue Tracking from the IT SERVICES STATUS tab.
2. In the Jira Projects tab, click +Add Jira Project.
3.The Add Jira Project dialog box appears. Enter the Project Name and the Project Link and click Save.
​
​
​
​
​
​
​
Type
Select the type of the mailing list
Description
Provide a description for the mailing list
Field
Action
Name
Enter the name of the mailing list
Visibility
Select the required visibility
Posting Permissions
Select the required posting permissions
Source Control allows you to track and manage updates to your code. It gives you the control to manage the right version of the code. PCC allows your to setup Source Control to your projects.
For compliance reasons, the Linux Foundation platform needs to have access to each GitHub organization you use to host your code. Your governance body and authorized community members will still be responsible and accountable for day-to-day administration of repositories, teams, and users, unless covered by a specific managed-services-agreement with the Linux Foundation.
You can setup the following Source Controls tools to your projects:
GitHub
GitLab
You can use GitHub as a source control tool to manage your project.
To setup the GitHub account to your project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Source Control from the IT SERVICES STATUS tab.
You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Source Control.
3.The Source Control page appears. Click GitHub and click the icon available in front of Connect.
4.The Connect GitHub Organization dialog box appears. Enter the Organization Name and click Connect.
Make sure to enter a valid GitHub organization name.
For more information on how to create an organization, refer .
For more information on how to transfer a repository, refer .
5.Once the connection is setup, you can see the status of GitHub project and its repositories.
If the Organization name is changed in the GitHub, you need to connect the renamed organization again. The renamed organization wont be automatically connected even though the organization with the old name was connected.
Your project should have its own GitHub organization, separate from your company's GitHub organization, and which is not shared with other, non-Linux-Foundation projects. If you need to, create a new GitHub organization for this project, and have a user who is an owner in both organizations transfer each project repository to this organization.
Then, invite the user “thelinuxfoundation” as an owner at the organization level (not per repository) to the GitHub organization, and connect them in Project Control Center.
For more information on how to invite users to join organization, refer .
For more information on how to transfer a repository, refer .
You can delete the added GitHub organization from the PCC.
To delete the GitHub organization that is added in the PCC, perform the following:
1.Login into PCC.
2.Click the Source Control.
3.Under GitHub, click on the required GitHub organization that you want to delete.
4.Click the icon and click Disassociate.
5.The Confirm Disassociation dialog box appears, click Delete to delete the GitHub Organization.
You can use GitLab as a source control tool to manage your project.
To setup the GitLab account to your project, perform the following steps:
1.Login into PCC.
2. Search for the required project. The Project dashboard appears. Click Source Control from the IT SERVICES STATUS tab.
You can also navigate to Source Control from the Vertical Sidebar navigation menu. Click IT Services and then select Source Control.
3.The Source Control page appears. Click GitLab and click the icon available in front of Connect.
4.The Connect GitLab Group dialog box appears. Enter the Group Name and click Connect.
5.Once the connection is setup, you can see the status of GitLab project and its repositories.
​
​
​
