Difference between revisions of "Installation"

From VyOS Wiki
Jump to: navigation, search
m (Dmbaturin moved page Install to Installation: Clarity)
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
In any city, in any country, go to any [[mirrors|mirror]] or the [http://mirror.vyos.net load balancer] you can get yourself to.
 
When you reach the server, go to the '''/vyos/iso/release''' directory and download the latest image.
 
  
If you are planning to use it on 32-bit x86 machines, use the image that ends with -i586.iso, or it will not boot.
+
{{Migrated | url = https://vyos.readthedocs.io/en/latest/install.html }}
If you are using it on physical 64-bit machines or virtual machines use the image that ends with -amd64.iso
+
 
This image is one of the 538 items you need for VyOS installation<ref>Instructions for obtaining the other 537 items can be found [http://theholders.org here]</ref>.
+
== Downloading Image ==
 +
 
 +
=== Stable Builds ===
 +
 
 +
This is the recommended build to use for all production environments. We suggest to use the [http://mirror.vyos.net/ automatic load balancer] to download the VyOS image from one of the official [[mirrors]]. The current stable release is 1.1.8.
 +
 
 +
* vyos-*-amd64.iso
 +
: This is the standard ISO, and should be used for most installations.
 +
* vyos-*-amd64-signed.ova
 +
: Vmware OVA file, for use with Vmware ESXi.
 +
* vyos-*-i586.iso
 +
: '''Warning: Deprecated.''' This is for older machines that do not support 64 bit instructions.
 +
 
 +
=== Nightly (Unstable) Builds ===
 +
 
 +
Nightly builds are available at [http://dev.packages.vyos.net/iso/current/amd64/ the build server]. The format of the file is vyos-999.YYYYMMDDHHMM-amd64.iso. 32 Bit builds [http://dev.packages.vyos.net/iso/current/i586/ are also available], but are not recommended. Nightly builds contain the newest features and functions, however you should only use it for testing purposes.
 +
 
 +
== Installation ==
  
 
Boot the target machine from that image. If you are using serial console, set your target machine serial port settings to '''9600/8/N/1'''.
 
Boot the target machine from that image. If you are using serial console, set your target machine serial port settings to '''9600/8/N/1'''.
  
Wait until the machine boots. It will show you a banner with version and default credentials and eventually the login prompt.
+
When the machine boots, you will see the ISOLINUX banner, with basic instructions. Simply push 'enter' to boot.
Do not use any other credentials but '''vyos''' with password '''vyos'''.
+
 
 +
After the machine has booted, you will see the login prompt. Log in with the username ''vyos'' and the password ''vyos''
  
Once you are logged in, use the command '''install image''' to initiate installation. Answer to the installer questions. When the installation is finished,
+
Once you are logged in, use the command '''install image''' to initiate installation, and answer the few questions. When the installation is finished,
 
reboot the machine (with '''reboot''' command).
 
reboot the machine (with '''reboot''' command).
  
Line 23: Line 39:
 
* Welcome to VyOS, an open source network operating system! *
 
* Welcome to VyOS, an open source network operating system! *
 
*                                                          *
 
*                                                          *
* Version: 1.1.3 (Helium)                                  *
+
* Version: 1.1.7 (Helium)                                  *
 
*                                                          *
 
*                                                          *
 
* Default login:    vyos                                    *
 
* Default login:    vyos                                    *
Line 39: Line 55:
 
Password: vyos
 
Password: vyos
  
Linux vyos 3.13.11-1-amd64-vyos #1 SMP Wed Jan 7 22:24:09 UTC 2015 x86_64
+
Linux vyos 3.13.11-1-amd64-vyos #1 SMP Wed Aug 12 02:08:05 UTC 2015 x86_64
 
Welcome to VyOS.
 
Welcome to VyOS.
 
This system is open-source software. The exact distribution terms for  
 
This system is open-source software. The exact distribution terms for  
Line 92: Line 108:
 
Copying /config/config.boot to sda.
 
Copying /config/config.boot to sda.
 
Enter password for administrator account
 
Enter password for administrator account
Enter password for user 'vyos':somelongpass
+
Enter password for user 'vyos': '''Enter a password here.''' (Note, you will not see the password as you enter it)
  
Retype password for user 'vyos':somelongpass
+
Retype password for user 'vyos': '''Enter the same password here'''
  
 
I need to install the GRUB boot loader.
 
I need to install the GRUB boot loader.

Latest revision as of 21:52, 22 June 2019

Warning sign.png This page is migrated to Readthedocs .
Information found on this page is migrated to readthedocs and information found here could be outdated or misleading. https://vyos.readthedocs.io/en/latest/install.html
For a complete status of all migrations, see Project:Migration


Downloading Image

Stable Builds

This is the recommended build to use for all production environments. We suggest to use the automatic load balancer to download the VyOS image from one of the official mirrors. The current stable release is 1.1.8.

  • vyos-*-amd64.iso
This is the standard ISO, and should be used for most installations.
  • vyos-*-amd64-signed.ova
Vmware OVA file, for use with Vmware ESXi.
  • vyos-*-i586.iso
Warning: Deprecated. This is for older machines that do not support 64 bit instructions.

Nightly (Unstable) Builds

Nightly builds are available at the build server. The format of the file is vyos-999.YYYYMMDDHHMM-amd64.iso. 32 Bit builds are also available, but are not recommended. Nightly builds contain the newest features and functions, however you should only use it for testing purposes.

Installation

Boot the target machine from that image. If you are using serial console, set your target machine serial port settings to 9600/8/N/1.

When the machine boots, you will see the ISOLINUX banner, with basic instructions. Simply push 'enter' to boot.

After the machine has booted, you will see the login prompt. Log in with the username vyos and the password vyos

Once you are logged in, use the command install image to initiate installation, and answer the few questions. When the installation is finished, reboot the machine (with reboot command).

Here is an example installation session:

ISOLINUX 4.02 debian-20101014  Copyright (C) 1994-2010 H. Peter Anvin et al

*************************************************************
*                                                           *
* Welcome to VyOS, an open source network operating system! *
*                                                           *
* Version: 1.1.7 (Helium)                                   *
*                                                           *
* Default login:    vyos                                    *
* Default password: vyos                                    *
*                                                           *
* To start installation, login and use command:             *
*     install image                                         *
*************************************************************

...

Welcome to VyOS - vyos ttyS0

vyos login: vyos
Password: vyos

Linux vyos 3.13.11-1-amd64-vyos #1 SMP Wed Aug 12 02:08:05 UTC 2015 x86_64
Welcome to VyOS.
This system is open-source software. The exact distribution terms for 
each module comprising the full system are described in the individual 
files in /usr/share/doc/*/copyright.
vyos@vyos:~$ install image
install image
Welcome to the VyOS install program.  This script
will walk you through the process of installing the
VyOS image to a local hard drive.
Would you like to continue? (Yes/No) [Yes]: 

Probing drives: OK
Looking for pre-existing RAID groups...none found.
The VyOS image will require a minimum 1000MB root.
Would you like me to try to partition a drive automatically
or would you rather partition it manually with parted?  If
you have already setup your partitions, you may skip this step

Partition (Auto/Parted/Skip) [Auto]: 


I found the following drives on your system:
 sda	8589MB


Install the image on? [sda]:


This will destroy all data on /dev/sda.
Continue? (Yes/No) [No]: Y
Y

How big of a root partition should I create? (1000MB - 8589MB) [8589]MB: 


Creating filesystem on /dev/sda1: OK
Done!
Mounting /dev/sda1...
What would you like to name this image? [1.1.3]: 

OK.  This image will be named: 1.1.3
Copying squashfs image...
Copying kernel and initrd images...
Done!
I found the following configuration files:
    /config/config.boot
    /opt/vyatta/etc/config.boot.default
Which one should I copy to sda? [/config/config.boot]: 


Copying /config/config.boot to sda.
Enter password for administrator account
Enter password for user 'vyos': '''Enter a password here.''' (Note, you will not see the password as you enter it)

Retype password for user 'vyos': '''Enter the same password here'''

I need to install the GRUB boot loader.
I found the following drives on your system:
 sda	8589MB


Which drive should GRUB modify the boot partition on? [sda]:


Setting up grub: OK
Done!