Server Configuration

This section covers the information needed to login to the running NIM VM server and configure the network and server connections.

Login Credentials

After starting the NIM VM you will be presented with the NIM prompt.

Enter the username: nim

The default password is: password

You may change the default user password using the following command:

passwd

The default root password is: password

You may change the default root password using the following command:

sudo passwd

Networking

NIM needs a static IP address to be accessable on your network. You must change the default settings to reflect your network settings. Please check with your network administrator to obtain a static IP range, default subnet, gateway, and DNS server information.

Setup Network Script

For easy network configuration use the nim-setup-network script to configure the VM network settings.

  • At the NIM server prompt enter:

    sudo /home/nim/nim-setup-network
    

IMPORTANT - Be sure that the IP Address you select is unique on your network and is outside any available DHCP range.

In a typical configuration the Subnet Mask, Gateway, and DNS Servers will match those of the host computer.

Leaving a field blank and pressing enter will reset the entry to its default value.

You will be prompted to enter the following information:

  • IP Address - the IP address you wish to assign to the NIM VM (Default: 192.168.1.200)
  • Netmask (Subnet Mask) - the subnet mask of the network the NIM VM will reside on (Default: 255.255.255.0)
  • Gateway (Router) - the gateway address for the network the NIM VM will reside on (Default: 192.168.1.1)
  • DNS Nameservers - the DNS servers available on the Network (Default: 8.8.8.8,8.8.4.4)
After entering all data you will be shown the proposed updates and prompted if you would like to make these changes.
Press y to confirm your changes or n to cancel.

Available Flags:

  • -h : Help Mode - This flag displays a description of the script as well as the current network settings
  • -d : DHCP - This flag sets the network interface to use DHCP

Mounting Servers

If you plan on using NIM to manage your project structures and use the 3rd party connectors to organize your files you will want to mount your file servers on the NIM server. A single file server is all that is needed, however you can mount multiple servers as needed per your facilities needs. Typically facilities with multiple locations will want to mount each of their file servers and assign it a location in the Administrative panel.

Shared Folders

If you are using VirtualBox as your VM hosting software you can easily setup mounted folders on the NIM VM using Shared Folders.

Please refer to the Virtual Appliance documentation for more information.

Create Mount Points

You can manually mount any share type that Ubuntu natively supports. The NIM VM is delivered with NFS and CIFS support.

IMPORTANT: The www-data user will need read/write permissions for any project location.

NFS Mounts

Here is an example command to mount an nfs share:

mount -t nfs 192.168.1.24:/ifs/raid /n/isilon

The above example assumes your servers IP address is 192.168.1.24 and is sharing a folder at /ifs/raid. On the NIM server this share will be accessible at the /n/isilon folder. Replace the IP address and directories with the information that matches your network configuration.

To make this share permanent you will need to edit the /etc/fstab file (with root privilages). You can edit the file using the vi editor by typing the command:

sudo vi /etc/fstab

For a basic nfs mount using the above example, add the line below to the bottom of the file and save:

192.168.1.24:/ifs/raid          /n/isilon               nfs             defaults        0       0

To test the mount issue this command:

sudo mount -a

If there are no errors try rebooting the VM. The new share should mount automatically.

As with the command line example replace the sample information with the information that matches your network configuration.

CIFS Mounts

Here is an example command to mount an cifs (Windows) share:

//wserver/share    /ubuntushare    cifs    uid=www-data,username=server-username,password=server-password,iocharset=utf8,sec=ntlm    0    0
  • wserver - the server you wish to share… ie your windows share
  • ubuntushare - this is the mount point (folder) for the share on the NIM VM.. ie /media/myWindowsShare
  • www-data - this is the actual username that NIM uses to access data and needs read/write permission to the share (should NOT be changed)
  • server-username - this is the username for the windows share allowing the NIM VM to access the share
  • server-password - this is the password for the windows share allowing the NIM VM to access the share

For example:

If you have a Windows server with the IP of 192.168.1.110 and a shared folder called PRJ and on the NIM VM you want that folder to be accessible at /media/windowsPRJ and the username and password that has access to the windows share is Jim and jimsPassword

To make this share permanent edit your /etc/fstab file (with root privilages) and add this line:

//192.168.1.110/PRJ    /media/windowsPRJ    cifs    uid=www-data,username=Jim,password=jimsPassword,iocharset=utf8,sec=ntlm    0    0

To test the mount issue this command:

sudo mount -a

If there are no errors try rebooting the VM. The new share should mount automatically.

Please refer to the official Ubuntu documentation for specific details on adding different types of shares to the server. http://www.ubuntu.com