Migrating from Collab managed site to Kenai Site, using the GlassFish Theme.

This page outlines the process that you will need to go through to start to make a project ready for the community.

Simple Sites

Projects that formerly worked within the Collabnet look & feel should consider using the Kenai wiki tool for their project home-page. This is easy to maintain, and can be designated as your project home-page. To implement this, perform the following actions:

1. Log in (you must be a project administrator to perform these steps)
2. Find the project "Features" page e.g. http://java.net/projects/[PROJECT-NAME]/features
3. Enable the Project Wiki. Look for Wiki on the features page and click the Add link. Add any wiki page name you like and click the "ADD" button.
4. Edit the wiki. Click on the Wiki link that you just added and you can edit this page. (The Kenai wiki uses a subset of MediaWiki format)
5. Find your old home-page data. You will find the copy of Index.html inside your migrated repository, for SVN, this is in: trunk/www
6. Copy the data that was formerly in your Collabnet project's index.html file, into the wiki page you just created
7. Navigate back to the "Feature" control page and under WikiHomePage, click "Add", enter anything you like in the description field and click the "Add" button.

That's it! Your project wiki will be the first thing that anyone will see if they browse to [PROJECT-NAME].java.net. (You can find more details about the wiki utility from the Wiki Help page.

Custom WebSites

Follow this procedure for sites that used custom layout.

Initial condition

Your project (let's call it "rotflmao") has just moved onto the Kenai based infrastructure. The project has been read-only for a few hours to a couple of days. Many of the links to your project are broken all over the internet. Things look bad. That is part of the reason you are here. This page walks you through the initial steps of bringing sanity back to your project.

if you access http://rotflmao.dev.java.net, the site is...

1. redirecting you to the page http://java.net and the page looks like a Kenai site
2. a directory listing
3. your site's index.html content, undecorated with any navigational fields

If you go to http://java.net/projects/rotflmao, you will see

Things you need to do.

1. Login to the new java.net. http://java.net/people/login
   • You may need to register or get your password reset, if you forgot it.
   • Your user authority should be transferred -- if you had project admin. access before, you'll have it now.
   • If you have a problem, contact mailto:kenai-staff@sun.com and ask to have your ID added as an admin for that project.
2. After you are an admin for the project, if you access http://java.net/project/rotflmao, you should see a link with the text 'Manage This Project'
   • Click it.
   • You will end up on the projects management page http://java.net/project/rotflmao/edit. There will be a number of tabs across the top of the page.
3. Click the tab labeled Features (http://java.net/project/rotflmao/features)
   • This will bring you to the list of features that are available for the project.
   • For the projects that are migrating from CollabNet, you should see a JIRA issue tracker, multiple mailing lists, a source code repository. You may see also see that the Downloads feature has been enabled. There are some other features that you may have an Add link, like Wiki, Message Forum and WikiHomePage. DO NOT ENABLE THESE FEATURES AT THIS TIME... OR MAYBE EVER.
4. Look for the Feature labeled Website
   1. If you do not see the feature in the list, your project did not get made public as part of the migration process.
      • Contact lea.wang@oracle.com and ask her to make the project public. This will make the Website feature available for your project. You will need to create the website
   2. If you see an Add link next to the Website feature, you need to create the website.
      • Click Add. This presents a couple of fields: Display Name; Description. It should also present a checkbox, labeled, "Include normal Navigation?". If the checkbox isn't there, contact lea.wang@oracle.com and ask her to update your site's configuration after you have created it.
      • Set the Display Name to the value "Website" and make sure the checkbox is checked, then press the Add button. The fields should have disappeared and they have been replaced by a line of the form, "Website<whitespace~>website<whitespace~>Edit<selection box, labeled more~>"
5. Click the Website link.
   • This should take you to a directory listing page... with nothing in it. This is temporary.
6. Hit your browser's Back button to get back to the Features page.
7. Click on the link under the 'Source Code Repository' feature. It is probably labelled "Subversion".
   • This brings up a page that gives you important info like the URLs to access your project's migrated source repository.
8. Use the URL to check out the project's source repo.
9. Download LookAndFeelTeamplates.zip. Unzip the downloaded file into the project's trunk/www directory.
   • This should create the following files: __modules/head.htmlx, __modules/header.htmlx, __modules/sample-project_tools.html, __modules/sample-left_sidebar.htmlx.
10. Use a diff tool to compare the two files __modules/sample_project-tools.html and __modules/sample-left_sidebar.htmlx.
    • You will need to apply a similar set of changes to transform your project's project_tools.html file into a file named __modules/left_sidebar.htmlx.__
    • The left_sidebar.htmlx file is applied to content that starts with a url prefix http://java.net/projects/$project and http://$project.java.net. This means that every href that doesn't start with http://$project.java.net probably should. The content of left_sidebar.htmlx must not contain relative links.
    • try using the scripts available http://kenai.com/projects/glassfish-migration/sources/source-code-repository/show/trunk/scripts to help transform project_tools.html into left_sidebar.htmlx
11. use 'svn add' to add the following files to your project: trunk/www/__modules/head.htmlx, trunk/ww/__modules/header.htmlx and trunk/www/__modules/left_sidebar.htmlx. Commit them, too.__
12. go back to your browser window and navigate to your project's feature management page.
13. Press the Add link, next to the Hook feature.
    • This displays additional fields: Display Name, Name and 'External WebHook URL'. It also displays a combobox, labeled 'Hook Type', with the value 'Web Hook'.
14. Change the value of the combobox to 'SCM Website Hook'.
    • This modifies the page again.
15. Fill in the field labeled 'Name' with a value.
16. Set the value of the 'Repository Base Directory' field to be /trunk/www.
17. add an additional space character into your project's index.html document and commit it.
18. Now, you need to wait for the website to get updated from the repository. For the site http://jersey.java.net, that takes about one hour.
19. Click on the 'Website' link in your browser.
    • At this point, you should see the content from /trunk/www/index.html displayed in your browser. If you do not see it the first time, you may want to wait a minute and reload the page. There can be a bit of a delay between committing changes and their appearance in the browser.
20. Press the back button to return to the Features page.
21. Click the link labeled Add, next to 'Custom Layout'.
22. Press the Add button.
23. Click on the link, labelled 'Website'.
    • At this point, you should see a site that 'looks like' a GlassFish project website.