» Project Kenai Documentation and Training » How Do I ...
If you created a project or you're an administrator for the project, you can change the project's settings on the Manage page.
To manage a project:
On the Manage page, you see the following tabs:
To open the page this tab is on, see Opening the Manage Page.
This tab enables you to set basic settings for the project, available when the project was first created. You can change any of the settings on this tab. For example, if you just chose defaults or did the bare minimum to get the project created, you can fix that on this tab. You can also use this tab to delete the project. The Delete button is at the bottom of the page.
Note: The project name, which is part of the project URL, is not on the Settings tab because it cannot be changed once the project has been created.
For more information on creating projects, see Creating a Project.
Only the owner of a project can delete it. To see if you're the owner, check the Project Owner field on the Settings tab of the project's Manage page (see Settings Tab above).
Before you delete a project, be sure to notify all your project members and give them time to move data off the project.
Note: You must remove all members from the project before the Delete button will show.
To delete the project, click the Delete button at the bottom of the Settings tab.
To open the page this tab is on, see Opening the Manage Page.
On this tab you can upload an image for your project. Make sure you have rights to use the image before uploading it.
Since the image will be cropped to a square image and resized to 100 pixels by 100 pixels, you might want to work with the image in a graphics editor to get it close to that size before uploading it. In particular, cropping the image to make it square will make the biggest difference. Also, you might need to resave it as a smaller image if it's bigger than 500 KB.
For example, the following image isn't square. Here's how it looks before uploading:
And here's how it looks after being uploaded to the site and automatically cropped and resized:
One way to make this image look better is to edit it before you upload it. If you crop it to a square image and center the part you think is important, you're more likely to see what you want on the site. For example, the original image was cropped around the frog's face and made into a square. Here's how it looked after uploading:
To open the page this tab is on, see Opening the Manage Page.
You can add links that are relevant to this project as a convenience for your members and others looking at the project page. Click Add Link to add a new link. The link text can be up to 25 characters, and the URI must be a fully formed Web address, such as http://meta.wikimedia.org/wiki/Help.
To open the page this tab is on, see Opening the Manage Page.
You can add members to your project if they have usernames on this site. To see a list of usernames, click the People link (or right-click it and open it in a new tab or window so you don't lose this settings tab). People can also request to become members of the project by signing up on the project page and requesting a role. If someone does that, you as a project administrator will receive a notification of the request.
Here's a quick guide to the default definitions for project roles:
Role | Description of Default Permissions |
Administrator | King of the Mountain. Owns the project and can perform all project administration tasks. |
Software Developer | Top level developer. Can do anything with the code and content. |
Tester | Someone who's job it is to test the software. Defaults to same permissions as Software Developer. |
Content Developer | Second level developer. Typically, can edit the wiki, but not commit code. |
Observer | Here to watch, comment, and connect. |
Unregistered | Logged in as a Project Kenai user, but not watching or otherwise participating in this project. |
Unauthenticated | Not logged in as a user of Project Kenai. |
Note: The project administrator can set the permissions for all the roles to those that make sense for the project. Each feature described below under Features Tab has its own permissions settings. Also, a single member can have more than one role. For example, if Content Developers have permission to add, delete, and change pages on the project wiki, but someone in a Software Developer role typically does not, a member who is permitted to both check in code and write wiki pages could be given both roles.
For a table showing all the default permissions settings, see Default Project Activity Permissions.
On this tab, you can remove project features, add features, like a source code management system or bug tracker, or manage features, for example, by setting permissions for actions for each user role or by changing the feature's name or description.
Note: To open the page this tab is on, see Opening the Manage Page.
Here's what you can do with each feature.
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
Issue tracking is a feature that helps you keep track of bugs and feature requests. You can have two issue trackers for a project.
For general information on working with issue tracking, see About Issue Tracking.
There are two issue trackers that are directly supported, Bugzilla and Jira. If you prefer to use an issue tracker external to the site, you can do that by specifying External Issue Tracker when you add an issue tracker (see Adding an Issue Tracker below). The following figure shows the issue tracking section of the Manage page with an existing issue tracker:
Note: The message saying that you cannot add another issue tracker is replaced by Add when there is no issue tracker, as you can see below.
You can do the following management tasks with issue tracking.
If you see Add next to the Issue Tracking feature name, you can add an issue tracker to your project.
Note: If you add an issue tracker, your project automatically gets an Issues mailing list tied to the issue tracking system.
To add an issue tracker:
Click more to the right of the issue tracker name and click Delete.
Note: After the issue tracker is deleted, Add appears next to the Issue Tacking feature name.
Click Edit to the right of the issue tracker name.
In the Edit dialog, you can change the Display Name that users of your project see for your issue tracker, as well as the description.
From the Project Kenai point of view, the tasks users can perform in an issue tracker (like creating bugs, editing bugs, and so on) depend on their roles in the project. You can't change the issue tracker permissions for individual project roles in Project Kenai as you can with other features, but you can move your project members to new Kenai roles. To see how the roles map for each type of issue tracker, see Issue Tracking on the Default Project Activity Permissions page.
Note: In addition to changing your members' roles in your Kenai project, you can change individual users' roles in the Jira issue tracker, and you can change what groups can do in Bugzilla.
For information on the Kenai roles, see the role definitions above.
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
You can add new mailing lists, delete lists, and manage them here.
Note: If you add an issue tracker, your project automatically gets an Issues mailing list tied to the issue tracking system. If you add a code repository, your project gets a Commits mailing list tied to the source control system.
You can do the following management tasks with mailing lists:
For general information on using mailing lists, see About Mailing Lists.
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
You can choose a supported source code management (SCM) system, Subversion, Mercurial, or Git, and your project will be set up with a repository for that SCM. If you choose External Source Code Repository, nothing will be set up for you on this site, and you have to do it yourself as described below under Adding an External Repository.
You can have more than one repository of more than one type. This feature lets you add, delete, and manage repositories, and also lets you determine who can check files in and out and who can browse your repositories.
You can do the following management tasks with source code repositories:
Note: If you add a code repository, your project also gets a Commits mailing list tied to the source control system.
To add a Subversion, Mercurial, or Git repository:
To add a repository for your project that's external to this site:
Click Edit to the right of the repository name.
Change the Commit Message Type (shown in the figure above) to:
Click the more droplist to the right of the repository name and choose Delete.
You will be asked to confirm the deletion because deleting a repository can destroy a lot of code and code history.
Click Edit to the right of the repository name.
The fields you can edit are described above under Adding a Subversion, Mercurial, or Git Source Code Repository. You cannot change the type of repository, but you can change the feature name, display name, and commit message type.
Click the more droplist to the right of the repository name and choose Set Role Permissions.
You see a table of checkboxes showing roles and actions those roles can take with a repository. The tasks you can set for the various roles are simple: Perform Checkouts and Perform Checkins.
Perform Checkouts includes source code browsing, so changing permissions for this task also changes who can browse your source code.
For information on the roles, see the role definitions above.
Note: Changes to repository permission don't take effect immediately, but take about 15 minutes to propagate.
If you have an existing external Subversion repository that you would like to begin using in your Kenai project, you can:
To copy the repository with svnsync:
Note: SSH access is faster and more secure than HTTPS access. Therefore, these instructions assume that you'll use SSH.
> svnsync init svn+ssh://<your-username>@svn.java.net<project-name>~<project-svn-repos> https://www.<some-site>.org/<your-ext-project>/svn/<your-repos>
> svnsync sync svn+ssh://<your-username>@svn.java.net/<project-name>~<project-svn-repos>
> svn propdel 'svn:sync:lock' --revprop -r 0 svn+ssh://<your-username>@svn.java.net/<project-name>~<project-svn-repos>
> svn co svn+ssh://<your-username>@svn.java.net/<project-name>~<project-svn-repos>
Note: You don't have to set up the pre-revprop-change hook. It's already set up for your Kenai Subversion repositories. The Kenai hook script requires only that you be a project administrator.
For more information on svnsync, see http://svn.collab.net/repos/svn/trunk/notes/svnsync.txt.
For general information on working with source code management and repositories, see Source Code Management.
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
A project can have one wiki that can have many pages.
You can do the following management tasks with wikis:
For general information on working with wikis and using wiki formatting tags, see About Wikis.
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
Message Forums, or just forums, are message boards where your members can discuss the project.
You can do the following things with forums:
For general information on using forums, see About Forums.
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
A project has one Downloads list for project files that you want your members to be able to download, such as the latest build of the project.
You can do the following management tasks with the Downloads list:
For general information on working with the Downloads list, see About Downloads. This page also tells you how to get a summary of data about your project's downloads.
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
A chat room is an area where your members can discuss the project with IM (instant messaging). You can have one chat room per project and use the Project Kenai chat client to access it. You can also use your own client, like Pidgin or Adium, or you can use NetBeans 6.7 and later. See About Instant Message (IM) Chat for more information on using IM chat clients.
You can do the following things with chat rooms:
This feature is on the Features tab on the Manage page, as described under Opening the Manage Page.
A Website is a set of web pages that you have uploaded to Project Kenai to use as your project's public home page. This home page is accessed through a web browser at the URL http://your-project-name.java.net. The site can be a public face for users of your software and can include multimedia, your own CSS, and your designed HTML pages. Content for the site could include software downloads and release information, upcoming plans, marketing information, and so on. Additionally, a Java-based project could host its Javadoc here.
You can use either a SCM Website Hook or a WebDAV client to upload a set of HTML, CSS, image, and other files for your web site to https://java.net/website/your-project-name. For information on uploading files, see Working With Your Project's Website.
If you don't set this feature, the URL http://your-project-name.java.net defaults to your project home page, http://java.net/projects/your-project-name.
This web site is completely under your control. If you select the "Include Normal Navigation?" option, then you only need to supply the main content, and it will be surrounded by the automatic navigation you see with many pages on this site, like the left navbar that links to your project features, the breadcrumbs list, or search. Otherwise, leaving the option unchecked will require you to supply your own links if you want the user to be able to navigate to your project.
Note: Your project will continue to have a project home page accessible from Project Kenai. The project website does not replace the project home page, making the project website useful as a site for users of your software. The project home page can continue to be used by developers and others who want to participate in the project on Project Kenai. If you want to customize the project home page, see the section, WikiHomePage.
You can do the following things with this feature:
This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.
A Wiki Home Page is a way to provide a customized project home page for your project. You edit your project's wiki Home page to add the content about your project that you want people to see on the Project Kenai site. After you set this feature, project administrators continue to see the default home page. For all other users who are permitted to see your wiki pages, this page replaces the default project home page.
To control who sees your wiki pages, see Setting Role Permission above under Wiki.
Note: You can have both a wiki home page and a project website. The wiki home page replaces your project home page and is for use by developers and other Project Kenai members who want to participate in or learn about your project. The project website is available externally to a wider audience and can be used to provide information to the users of your software, such as information on the latest releases, plans for upcoming releases, marketing information, and so on.
For example, here's how the default project home page for the Bluebird project looks:
And here's the new project home page in the Bluebird wiki:
As you can see, with the customized wiki home page, all the project navigation is still available in the left navigation bar, and you provide the look you want for your project page.
You can do the following things with this feature:
This feature is on the Emails tab on the Manage page, as described above under Opening the Manage Page.
This tab enables you to customize the email that gets sent when you add a new member in the Members tab. You can edit any of the fields, and you can use a set of predefined template variables in the email, such as {{project_display_name}}, which cause text to be inserted when the email is sent.
The template variables are listed at the bottom of the page with some of the default values filled in. Here's what they would be for the Bluebird project:
This feature is on the Web Hooks tab on the Manage page, as described above under Opening the Manage Page.
This tab enables you to set a URL, a callback to a page that can accept web hook data from your Project Kenai project. Web hooks provide a way for you to handle data resulting from changes in your Kenai projects on a web page of your choosing (as opposed to using something like an RSS feed). In this tab, you provide the URL of the web page that has code to interpret and handle the JSON data sent by Project Kenai. In addition, you need to click the checkbox next to the features you want to track. At present, there is one feature you can track, source code repository updates.
Note: A web hook is automatically disabled after 10 failed connection attempts. After a web hook is disabled, you must change the URL to re-enable the web hook.
For general information on working with web hooks, see About Web Hooks.
This tab enables you to add the tracking code from a profile you have set up on Google Analytics so your project's web page statistics can be gathered by Google. Click Add Analytic, add the tracking code code to that field, and click Add. Within 24 hours you will have data on your project in your Google account. For more information, see Using Analytics With Your Projects.