Virtual Server Appliance User manual (Version 2.0.0)  
 

6 Linux Runtime

The HELIOS Virtual Server Appliance Linux runtime is optimized for the exclusive use of HELIOS software server products. It includes only those Linux components that are required to run the HELIOS services. HELIOS provides full support for the Linux runtime, however non-HELIOS server products or additional Linux packages are not supported by HELIOS.

The Linux runtime is based on an 64 bit system (x86_64). Once Linux is started, a login as root will open the HELIOS Configuration Assistant.

6.1 Single-user/recovery mode

When starting the virtual machine, a blue “GNU GRUB” menu appears. Selecting “(recovery mode)” via the cursor and pressing RETURN allows booting into a single-user Linux for maintenance purposes, without any additional services (no HELIOS, no other Linux services). Entering the root password opens a shell. The root file system is mounted and the LVM (Logical Volume Manager) is active. Typing exit continues the regular boot process into multi-user mode.

6.2 SSH server

The only activated Linux network service after booting is the SSH server, to allow remote logins.

6.3 NFS services

HELIOS Virtual Server Appliance includes complete Linux NFS server and client services. These use RPC (Remote Procedure Call) services, which are always active by default. The NFS server will automatically be started when NFS shares are configured. The NFS server and client configuration is best done with the Configuration Assistant (see 4.2.2 “Network setup (hostname, IP addresses, DHCP, NFS)”). Consult your Linux manuals for more NFS details.

6.3.1 Features

6.3.2 Enable/disable NFS services

Manually enabling/disabling NFS/RPC services is only needed if customers wish to stop these services for security reasons (stop RPC service daemons from listening on IP ports anymore), or if they have no use for them.

Note:

Before these services can be disabled, make sure that neither NFS shares are exported nor NFS mounts are connected. If required, use Configuration Assistant to remove the exported shares and NFS mounts.

Stop related NFS/RPC services
hsymInstruction

Issue the following commands:

# service nfs-kernel-server stop
# service nfs-common stop
# service rpcbind stop
Disable them from getting started again after a reboot
hsymInstruction

Issue the following commands:

# update-rc.d nfs-kernel-server remove
# update-rc.d nfs-common remove
# update-rc.d rpcbind remove

In case you installed additional services that also require RPC or NFS services, you must disable these additional services before disabling NFS and RPC services.

You can check dependencies with the apt-cache rdepends command, e.g.:

#  apt-cache rdepends rpcbind
Enable NFS client/server functionality again

If required, NFS services can be re-enabled at a later point in time.

hsymInstruction

Issue the following commands:

# update-rc.d rpcbind defaults
# update-rc.d nfs-common defaults
# update-rc.d nfs-kernel-server defaults

# service rpcbind start
# service nfs-common start
# service nfs-kernel-server start

6.3.3 NFS usage scenarios

6.3.4 NFS client and server platform specifics

This section contains some information about platform specifics for NFS client or server for the currently supported HELIOS UB64 platforms Solaris (SPARC and x86), AIX, OS X, Linux. See also www.helios.de/platforms.

  NFS client file NFS server file NFS server command(s)
Solaris 8-9 /etc/vfstab /etc/dfs/dfstab share
Solaris 10-11 /etc/vfstab /etc/dfs/dfstab share, zfs
AIX /etc/filesystems /etc/exports exportfs
OS X /etc/fstab /etc/exports
Linux /etc/fstab /etc/exports exportfs

On other UNIX platforms, use man -k nfs to find out about NFS related commands and files.

6.3.5 VSA Linux man pages related to RPC/​NFS

The following tables include NFS and NFS-related manual pages. Man pages can be accessed via the man command, e.g. man exports.

Man page configuration files Description
exports NFS server export table
idmapd.conf Configuration file for “libnfsidmap”
fstab Static information about the file systems
nfs “fstab” format and options for the NFS file systems
Man page commands/processes Description
exportfs Maintain table of exported NFS file systems
filesystems Linux file system types: ext3, ext4, xfs, nfs, ...
rpc.idmapd NFSv4 ID to name mapper
rpc.mountd NFS mount daemon
mount Mount a file system
mount.nfs, mount.nfs4 Mount a Network File System
mountstats Displays NFS client per-mount statistics
nfsd Special file system for controlling Linux NFS server
nfsdcltrack NFSv4 client tracking callout program
nfsidmap The NFS “idmapper” upcall program
nfsiostat Emulate “iostat” for NFS mount points using “/proc/self/mountstats”
nfsstat List NFS statistics
rpcbind Universal addresses to RPC program number mapper
Man page commands/processes Description
rpcdebug Set and clear NFS and RPC kernel debug flags
rpc.gssd RPCSEC_GSS daemon
rpc.idmapd NFSv4 ID to name mapper
rpcinfo Report RPC information
rpc.mountd NFS mount daemon
rpc.nfsd NFS server process
rpc.statd NSM (Network Status Monitor) protocol service daemon
rpc.svcgssd Server-side “rpcsec_gss” daemon
showmount Show mount information for an NFS server
sm-notify Send reboot notifications to NFS peers
umount.nfs, umount.nfs4 Unmount a Network File System

6.4 Linux Java runtime

The server includes a headless 64-bit Java SE runtime which is compatible with all HELIOS server products.

6.5 Included Linux packages

The shell command dpkg -l lists a short description of all included packages, including version numbers.

6.6 Root file system

The HELIOS virtual server Linux runtime uses LVM2 for the root file system and for swapping. The system disk volume group is called “rootvg”. Advantages are a flexible storage management and snapshots. The “rootvg” volume group can be managed via the HELIOS Configuration Assistant, in the Manage other volume groups (Advanced storage setup) menu.


HELIOS Website © 2015 HELIOS Software GmbH  
HELIOS Manuals August 10, 2015