Lua Forge New Project

wiki

disclaimer: these are currently rather unspecific notes from the top of my head -- I will return here soon after checking the description against the LuaForge UI and will update the page to better reflect reality

• create a user account
• register a project
• setup for project administration
• setup for development on the project

creating a user account

This one is easy. Either go to the [LuaForge main page] and follow the link to create an account from the list of steps to do for new projects at the top. Or go to the "My Page" tab where you can login or create a new account. Use this newly created account to login to LuaForge.

for the record: the URL to create an account is http://luaforge.net/account/register.php

registering a project

The top of the LuaForge main page has a link to the page where you apply to have your project hosted on LuaForge. That URL is http://luaforge.net/register/. You have to specify several parameters of the project:

• a short description of your goals and priorities, which is not publicly visible and will be used by the admins to accept your application or to reject it (unknown size limit FIXME, but it's not too much what can be specified here)
• the project's short name (up to 15 characters, must form a valid UNIX user name) and short title (up to 40 characters)
• the project's publicly visible short summary (up to 255 characters)
• which of the LuaForge resources you want to make use of and in which way

setting up for administration

Once the project was accepted, visit the project's page on LuaForge. Either by going to http://<projectname>.luaforge.net/ (which may not yet work before dns updates propagated through caches). Or by looking up the project in the bottom right hand corner of LuaForge's main page ("recently registered"). The project won't show up yet in the projects tree until it was categorized for Trove.

Browse through the individual tabs and their subpages. Setup or change passwords as needed (e.g. for mailing lists). Create additional mailing lists, forum groups, etc.

Uploading documents works at this moment. Uploading files may work too (FIXME haven't tested that). FTP access to upload or change the project's website works at this moment, too. However interactive logins and cvs access won't. These are handled in the next section.

setting up for development

As mentioned above, FTP access, documents and files upload works rather quickly. Access to sources hosted on LuaForge takes some more work:

Create a SSH key (either by running the GUI style PuTTYgen program from the [PuTTY suite] and exporting the public key in OpenSSH format, or by running the ssh-keygen(1) command line tool.

Upload your SSH public key in the "account management" tab, an appropriate form may have appeared at the bottom of that page. Paste the public key file text into the form's text input area and make sure that no line breaks were inserted. Make sure that the number of keys is listed as "1" (the number one) in your account details. Click the "update" button, and allow some two hours to pass by for the automat to propagate the change in the system.

Now you should be able to run a SSH session against cvs.luaforge.net, using the private key you have created. Beware that it's essential to use this very host name. Although the cvs.<projectname>.luaforge.net name exists, that's a different machine and will NOT accept the login!

It's important to understand that this ssh key will only get you CVS access to the project hosted on LuaForge. Interactive sessions are disabled, as is access to other machines than the CVS server.

Refer to the "SCM" tab of your project for commands to carry out CVS access.