# Edge Extend Server Virtual Machine

This guide covers the network configuration of the **Edge Extend Server** running as a virtual machine in your own private or public cloud environment. Once network configuration is complete see [[:edgeextend/server]] to continue setup.

For general documentation see [[:edgeextend]].

## Prerequisites

You need to prepare/collect the following information before you can complete this configuration guide:

 * Machine image of the controller software in your preferred format. 
 * Ability to launch a virtual machine with:
   * A static IP address
   * A fully qualified domain name (recommended)
   * Open SSH port 22 for network configuration
   * Open HTTPS port 443 for administration
   * Open UDP port 443 for connection by one or more SMBStream Agents.

## Launch Virtual Machine

Download the Edge Extend Server image and deploy it to a hypervisor that is on the same local network as your target file servers.

### Sizing

The controller should be configured with at least:

 * vCPUs - 2
 * Memory - 2 GB
 * Disk - 40 GB (SSD)

On AWS this corresponds to a t3.small

### Ports

The following inbound firewall rules are required.

^ Type ^ Protocol ^ Port Range ^ Source ^ Description ^
| SSH     | TCP     | 22         | My IP* | SSH access for initial network configuration | 
| HTTPS | TCP     | 8081 | My IP* | User interface for administration |
| HTTPS | UDP     | 8445         |  Agent IPs  | Public endpoint for Edge Extend Server | 

* My IP - You could restrict this to the IP addresses you are logging in from.


### Verify Admin Interface

You should be able to bring up a web page at port 443.

    https://<ip-address>:8443

Since the virtual machine currently has a self-signed certificate your browser may show a warning that the site is untrusted.

### Verify SSH Access

Check that the instance can be accessed using a standalone SSH client. The username is **smbstream** and the initial password is ** QuickChangeM3**. For example:

    ssh smbstream@34.194.216.200
    
(If the command freezes check that your appliance allows SSH access (port 22) from your IP address.)

Check that you can become root with the initial password **MakeM4Secure**.

    su
    
This will be required to complete the configuration.

## Configure Static IP Address

Out of the box, the appliance comes preconfigured for DHCP. For most environments, you will need a static IP address. To change from DHCP to a static IP address edit the following file:

    /etc/network/interfaces

Comment out the "inet dhcp" line and uncomment the "inet static" section. The new configuration file, with your own IP addresses, will look like:

    # The primary network interface
    allow-hotplug eth0
    # iface eth0 inet dhcp

    iface eth0 inet static
           address 172.20.25.253
           netmask 255.255.255.0
           dns-nameservers 172.20.25.1
           gateway 172.20.25.1

Then restart the appliance to apply the network changes.

    reboot



### SSL Certificates

The appliance includes an untrusted SSL certificate.


### Next Steps

Once network configuration is complete return to the general [[:edgeextend/server]] documentation to continue agent setup.