Help:Getting Started

Still in draft!

So, your account has just been created, and you are dying to try the awesome tools on Wikimedia Labs. What is next?

Initial log in

If someone has made an account for you, you'll need to do the following for initial log in:

1. Go to the login page
2. Click "Forgotten your login details?"
   • If the "Forgotten your login details?" link does not appear, click "Log in"
3. Go through the process of resetting your password
4. After logging in, you should upload an ssh key to labs
5. Now log into gerrit. It'll ask you to upload a key. Upload your public key here as well.

Read the docs and rules

Sorry, Wikimedia Labs is still in beta, so not much docs yet. Rules ain't set yet either

Before you get started, you would need to read the documentation on how things work here. Here are some links:

• Help:Contents
• How to access your instances
• Rules you need to follow when using Wikimedia Labs

Useful links

Here are some links that might be of use to you as you develop your tools with Wikimedia Labs:

• Add and manage your public SSH keys

Once you add a key, you'll be able to log into the instance of any project you are a member of. Have a current project member, or an admin user add you to a project.

To create instances within a project, you'll need to have a sysadmin on the project, or have an admin add you to the sysadmin role for that project.

You can make queries for nova resources; currently only Nova instances have semantic properties enabled.

After logging in, you can also access Gerrit; if you wish to do git checkouts of the puppet repositories, you'll need to log into Gerrit, and add your SSH key there as well. Note: it would be nice if Gerrit could use LDAP for its SSH keystore, instead of its database. More information is provided here.

Admins

Wiki Admin

If you are a wiki admin, you can:

• Create/delete Nova projects and manage project and project role membership
• Manage global role membership.
• Manage sudo policies.

Net Admins

If you are a NetAdmin of your project, you can:

• Allocate and associate public IP addresses, and add public DNS entries to instances
• Manage security groups and rules.

Sys Admins

If you are a sysadmin of your project, you can:

• Create or manage instances.
• Create or manage volumes.

Final note

Wikimedia Labs features awesome features that you can use. If you encounter any problems, do drop by our IRC channel at #wikimedia-labs on FreeNode! Have fun hacking!