Gandi Agent and Server Configuration Files

The Role of Gandi Agent

In expert mode, the Gandi configuration agent is tasked with receiving information about server parameters, number of cores, RAM, new disk size, disks to be attached or detached, and so on.

Note

This agent is included in the gandi-hosting-vm2 package, which may need to be updated in order to take advantage of the latest improvements. To do this, use this command:

apt-get update && apt-get install gandi-hosting-vm2.

Gandi Config Files

Important

Certain files are required by the virtual server as a result of our hosting infrastructure.

The following section describes several files and directories that are available for you to adapt your Cloud server to your needs.

/etc/gandi

This directory contains our configuration scripts.

/etc/default/gandi

Note

For RPM-based distributions, this file is located at /etc/sysconfig/gandi.

In this file you can do the following by changing the contained parameters:

  • Choose between short hostname or FQDN
  • Create or activate swap at boot
  • Change the MOTD for SSH connections
  • Change the time zone
  • Activate or deactivate specific Gandi system options (sysctl)
  • Add or remove Gandi SSH keys to grant or revoke our access
  • Change SSH options (Compression, PermitRootLogin, EmptyPasswords)
  • Choose whether to update /etc/resolv.conf via DHCP
  • Automatically configure the emergency console
  • Activate or deactivate PAM changes for root access
  • Activate or deactivate automatic hostname configuration
  • Activate or deactivate automatic DNS server configuration
  • Change data disk mount options and default mount locations

/etc/udev/rules.d/86-gandi.rules & /etc/fstab

You have two ways of mounting disks on your virtual server:

udev (default)

By default, udev takes care of automatically mounting data disks on /srv/ with the name of the disk. For example, a data disk named d_data would be mounted at /srv/d_data/.

fstab (udev deactivated)

If you want to specify your own mount points, you must deactivate the udev rules related to the disks in the file /etc/udev/rules.d/86-gandi.rules. The Cloud Server will need to be rebooted in order for changes to this file to take effect.

Note

The two lines that need to be commented out to deactivate udev are :

SUBSYSTEMS=="xen", DRIVERS=="vbd", SUBSYSTEM=="block", RUN+="fake_blkid -o udev -p $tempnode", RUN+="/etc/gandi/manage_data_disk.py", OPTIONS+="last_rule"

SUBSYSTEM=="block", ENV{DEVTYPE}=="disk", ENV{ID_VENDOR}=="gandi.ne", RUN+="fake_blkid -o udev -p $tempnode", RUN+="/etc/gandi/manage_data_disk.py", OPTIONS+="last_rule"

/etc/init.d/gandi-mount & /etc/init.d/gandi-kernel

gandi-mount

This script allows disks attached to the server and present in /proc/partitions to be mounted on /srv/.

gandi-kernel

This script automates the installation of kernel modules.