Skip to main content
This revision made January 13, 2011 20:54, by leawang

» Project Kenai Documentation and Training     » How Do I ...

Working With Your Project's Website

As described at Managing a Project: Website, after you enable your own web site for a project on Project Kenai, you can use either a SCM Website Hook to update website site content or use a WebDAV client to upload the files to https://java.net/website/your-project-name.

Some operating systems have WebDAV built in, and some require that you install a WebDAV client.

  • The OSX Finder's WebDAV works well on Apple Macintosh OSX machines.
  • The WebDAV client for the File Explorer in Microsoft Windows XP does not work well, so you'll need to install a WebDAV client, as described below.
  • Linux OS's have various ways of supporting WebDAV, for example, through KDE and Gnome, with the Cadaver client, or with Konqueror.
  • Linux OS's can also use the davfs2 file system instead of WebDAV clients.
  • Another client to consider is sitecopy, which has binary packages for several versions of Linux, UNIX, OS/2, and Macintosh OSX. It's useful if you want to maintain the website on a local machine and send file updates to the web. See Should I Use Sitecopy? for more information on choosing it.

For a list of WebDAV clients, see http://www.webdav.org/projects/.

Before installing a separate client, try using your operating system's WebDAV to see if it works.


Using Finder with Macintosh OSX

Note: Before you can use WebDAV with your project's web site, you must first enable the web site as described at Managing a Project: Website. You can also use sitecopy on a Macintosh system, as described below at Setting Up and Using Sitecopy.

On Macintosh OSX systems, you can use the Finder to connect to a WebDAV server. Here's how you do that:

  1. In the Finder, choose Go > Connect to Server.
  2. In the Server Address field, enter https://java.net/website/your-project-name/.
  3. If you want to add the server permanently, click the + button.
  4. To connect to the server, click Connect.
  5. When prompted for authentication, enter your Kenai username and password.
  6. Use either drag and drop or the command line to copy files to the Kenai directory.
    • Drag and Drop: Drag local files or directories to the remote website directory
    • Command Line: Copy files or subdirectories from your local machine to the website directory. For example:
      cp local_files /Volumes/project_name.

Using WebDAV With a Linux System

Note: Before you can use WebDAV with your project's web site, you must first enable the web site as described at Managing a Project: Website.

At present, our Linux documentation covers Kubuntu 9.04 with the KDE 4 desktop, using the davfs2 file system, and using sitecopy. We plan to add documentation for more Linux systems as we get more information on them. Some addtional options reported to be available are direct support through Gnome and support through the Cadaver client.

If you use a Linux system to work with your website on Project Kenai, you could help us out by sending instructions to users@help.kenai.com.

Using Kubuntu 9.04 With the KDE Desktop

These instructions, supplied by a Project Kenai member, are for Kubuntu 9.04 with the KDE 4 desktop.

In KDE 4, you can use the KDE default file explorer, Dolphin, to access the website with WebDAV. With KDE 3.5, you can use Konqueror for WebDAV access.

To use Dolphin for WebDAV access:

  1. Start Dolphin and enter the following URL in the address bar:
    webdavs://java.net/website/your-project-name/
  2. You see your website in Dolphin. The first time you create or modify something, you will be asked for a username and password. Use your Project Kenai username and password.
  3. You can work in Dolphin the same way as on a local drive. You can create folders and files, upload and copy files with drag and drop, overwrite files, and so on.

Note: Trying to delete a folder can return Error Code 301. This might be due to the following KDE bug: KDE [Bug 187970]: "Dolphin webdav avoids to remove folders in mydisk.se with code 301."

Using the davfs2 File System

As described at http://savannah.nongnu.org/projects/davfs2, davfs2 enables you to access WebDAV resources as though they were a typical filesystem, which means that standard applications that have no built-in support for WebDAV can use these resources.

To use davfs2:

  1. Install davfs2 on your machine.

  2. Mount your website directory. For example,

    sudo mount -t davfs https://java.net/website/project_name /where_to_mount

    Note: Write access to the mounted directory requires that you use sudo.

  3. After finishing your work, just umount the directory. All changes should be synchronized and updated. If the data is not synchronized, use the sync command before you unmount.

Setting Up and Using sitecopy

The downloads area at http://www.manyfish.co.uk/sitecopy has binary packages for several versions of Linux as well as UNIX, OS/2, and Macintosh OSX. You might want to use it instead of a WebDAV client if you maintain your web site on a local machine and want to use something similar to FTP to work with your java.net web site.

Setting Up sitecopy

  1. Make sure you have enabled the Website feature for your project on java.net, as described at Managing a Project: Website.
  2. Download and install sitecopy from http://www.manyfish.co.uk/sitecopy/.
    Note: For Macintosh OSX, download sitecopy at http://pdb.finkproject.org/pdb/package.php/sitecopyuse and use Fink to install it.
  3. Create a directory named .sitecopy in your user_dir and give it 0700 permissions. For example:
      cd /home/myusername
      mkdir .sitecopy
      chmod 0700 .sitecopy
  4. Create a file named .sitecopyrc in your user_dir directory and give it 0600 permissions.
  5. Edit .sitecopyrc and enter the following settings:
    site site-name
    server java.net
    remote /website/project-name
    local path-to-local-directory
    http secure
    protocol webdav
    port 443
    username kenai-username
    password kenai-password

Notes:

  • site-name is just a name you use to distinguish this site's settings from other site settings in the .sitecopyrc file. You use it in the sitecopy -f command to initiate a transfer of files for this site to the corresponding website on java.net.
  • remote requires a slash (/) before the first directory name. For example, for the Bluebird project, whose project home page URL is http://java.net/projects/bluebird, you would enter /website/bluebird.
  • local is the path to the directory on your local file system where you maintain the website files.

Using Sitecopy

The first time you use sitecopy, you need to initialize the site:

  $sitecopy -i site-name

Here's a typical series of steps for using Sitecopy.

  1. Perform a fetch:
     $sitecopy -f site-name

  2. Synchronize your local repository with your remote repository:
     $sitecopy -s site-name

    Note: There is a bug with sitecopy synchronization that requires you to synchronize as many times as you have subdirectories. For more information, see http://lists.manyfish.co.uk/pipermail/sitecopy/2009-June/000140.html.

  3. Make changes in your local repository.

  4. Update the remote repository with changes from your local repository:
     $sitecopy -u site-name

You can get a list of all available sitecopy commands by entering

    sitecopy --help

Using BitKinex with Microsoft Windows XP and Vista

Note: Before you can use WebDAV with your project's web site, you must first enable the web site as described at Managing a Project: Website.

A free WebDAV client, BitKinex, is available for Microsoft Windows XP and Vista. You can download it from http://www.bitkinex.com.

Setting Up BitKinex for Your Project

  1. After installing BitKinex, click its icon to run it.
  2. Select the Http/WebDAV node.

  3. Choose Data Source > New > Http/WebDAV.

  4. Enter a name for the new data source and right click it and choose properties .

  5. Make sure Server is selected in the tree on the left.

  6. For Server address, enter java.net.
  7. For Security, choose SSL.
  8. Enter your Project Kenai username and password.
  9. Click Site Map under the Server node on the left.

  10. Double-click the / entry under Path and change it to /website/your-project-name/.
    For example, for the Bluebird project, whose project home page URL is http://java.net/projects/bluebird, you would enter /website/bluebird/.
  11. Make sure that The location specifies: is set to Directory (WebDAV-compliant).
  12. Click Update.
  13. Click OK at the bottom of the dialog.

BitKinex should now be set up to work with your project's web site location on Project Kenai.

Using BitKinex With Your Project's Website Directory

After setting up BitKinex to work with your project on Project Kenai, you have a node for your project under the Http/WebDAV node when BitKinex first opens. Basically, you click that node, establish a connection, and transfer files to java.net. You can also delete files on java.net with BitKinex, and you can replace files by uploading new versions.

To use BitKinex with your project's Website directory:

  1. Double-dlick the node for your project under the Http/WebDAV node.

  2. You see the connection window open.

  3. To populate your java.net web site, click and drag files from your local machine on the right to the server directory on the left.
  4. You can work directly with files and directories on the server. For example, if you right-click a server directory, you see a menu with choices like New > Directory or File.

  5. BitKinex comes with a set of help files for when you get stuck. Most of the operations are similar to using a file browser on Windows.

Difference compared to previous revision
<span>[[Home| &raquo; Project Kenai Documentation and Training]] &nbsp; &nbsp; [[Howdoi| &raquo; How Do I ...]] <h1>Working With Your Project's Website </h1> As described at [[ManageProject#Website|Managing a Project: Website]], after you enable your own web site for a project on Project Kenai, you can use either a [[SCMWebsiteHooks|SCM Website Hook]] to update website site content or use a [http://en.wikipedia.org/wiki/WebDAV WebDAV] client to upload the files to <tt><nowiki>https://</nowiki><span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>/website/''your-project-name''</tt>. Some operating systems have WebDAV built in, and some require that you install a WebDAV client. * The OSX Finder's WebDAV works well on Apple Macintosh OSX machines. ... On Macintosh OSX systems, you can use the Finder to connect to a WebDAV server. Here's how you do that: # In the Finder, choose Go > Connect to Server. # In the ''Server Address'' field, enter <tt><nowiki>https://<span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>/website/</nowiki>''your-project-name''</tt>/. # If you want to add the server permanently, click the <tt>+ </tt>button. # To connect to the server, click ''Connect''. # When prompted for authentication, enter your Kenai username and password. ... In KDE 4, you can use the KDE default file explorer, Dolphin, to access the website with WebDAV. With KDE 3.5, you can use Konqueror for WebDAV access. '''To use Dolphin for WebDAV access:''' # Start Dolphin and enter the following URL in the address bar:<br/><tt><nowiki>webdavs://<span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>/website/</nowiki>''your-project-name''/</tt> # You see your website in Dolphin. The first time you create or modify something, you will be asked for a username and password. Use your Project Kenai username and password. # You can work in Dolphin the same way as on a local drive. You can create folders and files, upload and copy files with drag and drop, overwrite files, and so on. ... '''To use davfs2:''' # Install davfs2 on your machine.<br/><br/> # Mount your website directory. For example, <br/><br/><tt>sudo mount -t davfs <nowiki>https://<span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>/website/project_name /where_to_mount</nowiki></tt><br/><br/>'''Note:''' Write access to the mounted directory requires that you use <tt>sudo</tt>.<br/><br/> # After finishing your work, just <tt>umount</tt> the directory. All changes should be synchronized and updated. If the data is not synchronized, use the <tt>sync</tt> command before you unmount. ===Setting Up and Using sitecopy=== The downloads area at [http://www.manyfish.co.uk/sitecopy] has binary packages for several versions of Linux as well as UNIX, OS/2, and Macintosh OSX. You might want to use it instead of a WebDAV client if you maintain your web site on a local machine and want to use something similar to FTP to work with your <span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span> web site. ====Setting Up sitecopy==== # Make sure you have enabled the Website feature for your project on <span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>, as described at [[ManageProject#Website|Managing a Project: Website]]. # Download and install sitecopy from [http://www.manyfish.co.uk/sitecopy/].<br/>'''Note:''' For Macintosh OSX, download sitecopy at [http://pdb.finkproject.org/pdb/package.php/sitecopyuse] and use Fink to install it. # Create a directory named <tt>.sitecopy</tt> in your <tt>user_dir</tt> and give it 0700 permissions. For example:<br/><tt> &nbsp;&nbsp;cd /home/myusername</tt><br/><tt> &nbsp;&nbsp;mkdir .sitecopy</tt><br/><tt> &nbsp;&nbsp;chmod 0700 .sitecopy</tt> # Create a file named <tt>.sitecopyrc</tt> in your <tt>user_dir</tt> directory and give it 0600 permissions. ... # Create a file named <tt>.sitecopyrc</tt> in your <tt>user_dir</tt> directory and give it 0600 permissions. # Edit <tt>.sitecopyrc</tt> and enter the following settings: site ''site-name'' server <span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span> remote /website/''project-name'' local ''path-to-local-directory'' http secure ... password ''kenai-password'' '''Notes:''' * <tt>'''site-name'''</tt> is just a name you use to distinguish this site's settings from other site settings in the <tt>.sitecopyrc</tt> file. You use it in the <tt>sitecopy -f </tt> command to initiate a transfer of files for this site to the corresponding website on <span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>. * <tt>'''remote'''</tt> requires a slash (<tt>/</tt>) before the first directory name. For example, for the Bluebird project, whose project home page URL is <tt><nowiki>http://<span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>/projects/bluebird</nowiki></tt>, you would enter <tt>/website/bluebird</tt>. * <tt>'''local'''</tt> is the path to the directory on your local file system where you maintain the website files. ====Using Sitecopy==== ... # Choose Data Source > New > Http/WebDAV.<br/><br/>[[image:bitkinex-choose-datasource.png]] # Enter a name for the new data source and right click it and choose properties .<br/><br/>[[image:bitkinex-click-newdatasource.png]] # Make sure '''Server''' is selected in the tree on the left.<br/><br/>[[image:bitkinex-server-settings.png]] # For '''Server address''', enter <tt><span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span></tt>. # For '''Security''', choose SSL. # Enter your Project Kenai username and password. # Click '''Site Map''' under the Server node on the left.<br/><br/>[[image:bitkinex-sitemap-settings.png]] # Double-click the <tt>/</tt> entry under Path and change it to <tt>/website/''your-project-name''/</tt>.<br/>For example, for the Bluebird project, whose project home page URL is <tt><nowiki>http://<span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>/projects/bluebird</nowiki></tt>, you would enter <tt>/website/bluebird/</tt>. # Make sure that '''The location specifies:''' is set to <tt>Directory (WebDAV-compliant)</tt>. # Click Update. # Click OK at the bottom of the dialog. ... BitKinex should now be set up to work with your project's web site location on Project Kenai. ===Using BitKinex With Your Project's Website Directory=== After setting up BitKinex to work with your project on Project Kenai, you have a node for your project under the Http/WebDAV node when BitKinex first opens. Basically, you click that node, establish a connection, and transfer files to <span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span>. You can also delete files on <span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span> with BitKinex, and you can replace files by uploading new versions. '''To use BitKinex with your project's Website directory:''' # Double-dlick the node for your project under the Http/WebDAV node.<br/><br/>[[image:bitkinex-choose-site.png]] # You see the connection window open.<br/><br/>[[image:bitkinex-connection-window.png]] # To populate your <span style="text-decoration:line-through;color:red">ken</span><span style="text-decoration:underline;color:green">j</span>a<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">va</span>.<span style="text-decoration:line-through;color:red">com</span><span style="text-decoration:underline;color:green">net</span> web site, click and drag files from your local machine on the right to the server directory on the left. # You can work directly with files and directories on the server. For example, if you right-click a server directory, you see a menu with choices like New > Directory or File.<br/><br/>[[image:bitkinex-connection-window-newdir.png]] # BitKinex comes with a set of help files for when you get stuck. Most of the operations are similar to using a file browser on Windows.<br/><br/>[[image:bitkinex-help.png]]<span>
 
 
Close
loading
Please Confirm
Close