Portal:Data Services/Admin/Runbooks/Enable NFS for a project
NFS is the primary shared storage system for projects in Cloud VPS and is the main platform for users to place code on the Toolforge execution environment. When a Cloud VPS project would like to use shared storage for one reason or another, we provide a fairly simple path for them to do so. Generally all this will be done in response to a ticket.
Unless special arrangements are made. The server to set up on is labstore1004 because the misc volume is there. All non-tools and non-maps shares end up on the misc volume.
Find out the GID for the project
On labstore1004, you can run:
$ useldap getent group project-$project_name
A labstore1004 does not lookup in LDAP by default. 'useldap' is a script that will fix that for you. Also any CloudVPS project is 'project-$name' in ldap.
user@labstore1004:~$ useldap getent group project-wikilink project-wikilink:*:54031:nskaggs,samwalton9,suecarmol,jsn,novaadmin,crucio
Create the shared folders on labstore1004 as /srv/misc/shared/$project_name/home and /srv/misc/shared/$project_name/project as appropriate. Leave ownership with "root:root". That is normal since we don't root squash projects.
Once puppet is patched, run
sudo puppet agent -t on labstore1004. This will trigger nfs-exportd's configuration changes and restart it. That should create a new file for the project under
/etc/exports.d on labstore1004 that will be configured with the project's ips.
Enabling on the VMs
Utilize hiera key
mount_nfs to opt-in / out. (e.g.
mount_nfs: true) The default is false at this time. A puppet run after the above work is completed on a VM with this key set to true will mount the NFS as specified.
Users can be instructed to do this step themselves. This will also enable tc traffic shaping on the VM client which will not remove itself if NFS is later removed. Setting
mount_nfs: false will not remove NFS mounts. You must do that by hand after changing hiera.
Communication and support
We communicate and provide support through several primary channels. Please reach out with questions and to join the conversation.
|Phabricator Workboard||#Cloud-Services||Task tracking and bug reporting|
|IRC Channel||#wikimedia-cloud connect
|General discussion and support|
|Mailing List||cloud@||Information about ongoing initiatives, general discussion and support|
|Announcement emails||cloud-announce@||Information about critical changes (all messages mirrored to cloud@)|
|News wiki page||News||Information about major near-term plans|
|Cloud Services Blog||Clouds & Unicorns||Learning more details about some of our work|
|Wikimedia Technical Blog||techblog.wikimedia.org||News and stories from the Wikimedia technical movement|