<p>VirtualBox環境でのIOSXRv検証を容易にするため、vagrantで一発起動できるようにしたい。</p>
<p>本記事ではVirtualBoxとvagrantが事前にインストールされていることを前提とする。IOSXRvイメージファイルはCiscoサイトから取得可能だが、CiscoのパートナーとなりCisco.com IDにService Contractを設定しておく必要がある。<br>
以下では、次のソフトウェアを利用し動作を確認している。</p>
<ul>
<li>Windows 10 with WSL</li>
<li>iosxrv-k9-demo-5.3.3.ova</li>
<li>VirtualBox 6.1.20</li>
<li>vagrant 2.2.15</li>
</ul>
<h1 id="iosxrv%E3%81%AEbase%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#iosxrv%E3%81%AEbase%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B" aria-hidden="true"></a> IOSXRvのbaseイメージを作成する</h1>
<p>iosxrv-k9-demo-5.3.3.ovaイメージファイルをダブルクリック等で起動する。<br>
ova拡張子がVirtualBoxに関連付けられている環境であれば、仮想アプライアンスのインポートが開始される。</p>
<p>ここでは以下のようにCPUを1, RAMを2048MB程度に設定しておく。ネットワークアダプタは初期状態で8個作成されることになるが、この時点ではMgmtEthとなる最初のひとつ以外は必要ないためチェックボックスを外しておく。最後に<code>インポート</code>をクリックする。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/3yl6my0ez5mk56xna0pva0n7tau8" alt="virtualboxにovaイメージファイルを登録" loading="lazy" class="md-img"></p>
<p>無事にインポートが完了したのち、NamedPipe機構を利用したコンソールを追加するため作成されたイメージから<code>設定(S)</code>をクリックする。以下イメージのように<code>シリアルポート</code>タブを選択し、<code>ポートモード(M)</code>は<code>ホストにパイプ</code>を選択、<code>存在するパイプ/ソケットに接続(C)</code>のチェックを外し、<code>パス/アドレス(P)</code>欄には<code>\\.\pipe\iosxrv</code>と記載する。</p>
<p><img src="https://storage.googleapis.com/zenn-user-upload/4yj7u1itsz7c4odp45iuixslpjxv" alt="virtualboxからコンソールを設定する" loading="lazy" class="md-img"></p>
<p>さて、コンソールに接続するためにはNamedPipeをアタッチする必要があるが、ここでは<br>
NamedPipeをTCPポートに変換してくれる<a href="https://shvechkov.tripod.com/nptp.html" target="_blank" rel="nofollow noopener noreferrer">Named Pipe TCP Proxy</a>を利用する。サイトからソフトウェアをダウンロードしてインストール。<br>
Named Pipe TCP Proxy起動後の設定画面から、以下のように<code>\\.\pipe\iosxrv</code>を<code>9001/tcp</code>にプロキシさせる。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/3e612mr1u94poxk1dit3yar3xwq2" alt="Named Pipe TCP Proxyを設定する" loading="lazy" class="md-img"></p>
<p>さて、この状態でVirtualBoxから<code>com.cisco.ios-xrv</code>イメージの<code>起動(T)</code>をクリックし、直後にWSL等のターミナルから以下のように<code>9001/tcp</code>にtelnetアクセスすることでコンソールに起動ログが流れ始める。<br>
<code>Enter root-system username:</code>とプロンプトが表示されるまで待つ。</p>
<div class="code-block-container"><pre><code>$ telnet localhost 9001

                             GNU GRUB  version 2.00

 +--------------------------------------------------------------------------+
 |IOS XRv                                                                   |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 |                                                                          |
 +--------------------------------------------------------------------------+

      Use the ^ and v keys to select which entry is highlighted.
      Press enter to boot the selected OS, `e' to edit the commands
      before booting or `c' for a command-line. ESC to return
      previous menu.

...snip...
</code></pre></div><p>root-systemに設定するusername/secretはどちらも<code>vagrant</code>としておく。このusername/secretがadmin-configに設定され、vagrantからアクセスする際に利用される。</p>
<div class="code-block-container"><pre><code>!!!!!!!!!!!!!!!!!!!! NO root-system username is configured. Need to configure root-system username. !!!!!!!!!!!!!!!!!!!!

         --- Administrative User Dialog ---


  Enter root-system username: vagrant
  Enter secret:
</code></pre></div><p>VMにログインするにはここからさらに少し待つ必要がある。<br>
次のようにプロンプトが表示されると、ようやく設定済みの<code>vagrant</code>ユーザでログインできるようになる。</p>
<div class="code-block-container"><pre><code>User Access Verification

Username: vagrant
Password:


RP/0/0/CPU0:ios#
</code></pre></div><p>それでは、ここからIOSXRvイメージの初期コンフィグを投入していく。</p>
<div class="code-block-container"><pre><code>RP/0/0/CPU0:ios#configure
RP/0/0/CPU0:ios(config)#hostname iosxrv
RP/0/0/CPU0:ios(config)#aaa authentication login default local
RP/0/0/CPU0:ios(config)#ssh server v2
RP/0/0/CPU0:ios(config)#ssh server logging
RP/0/0/CPU0:ios(config)#telnet vrf default ipv4 server max-servers 15
RP/0/0/CPU0:ios(config)#interface MgmtEth 0/0/CPU0/0 ipv4 address dhcp
RP/0/0/CPU0:ios(config)#no interface MgmtEth 0/0/CPU0/0 shutdown
RP/0/0/CPU0:ios(config)#commit
RP/0/0/CPU0:ios(config)#exit
</code></pre></div><p>外部からのsshアクセスを可能にするためには、さらにIOSXRvイメージにキーペアを作成しておく必要があるので忘れずに。</p>
<div class="code-block-container"><pre><code>RP/0/0/CPU0:iosxrv#crypto key generate rsa

The name for the keys will be: the_default
  Choose the size of the key modulus in the range of 512 to 4096 for your General Purpose Keypair. Choosing a key modulus greater than 512 may take a few minutes.

How many bits in the modulus [1024]:
Generating RSA keys ...
Done w/ crypto generate keypair
[OK]
</code></pre></div><p>設定がすべて完了すれば以下のようになる。</p>
<div class="code-block-container"><pre><code>RP/0/0/CPU0:iosxrv#show running-config
Building configuration...
!! IOS XR Configuration 5.3.3
!! No configuration change since last restart
!
hostname iosxrv
telnet vrf default ipv4 server max-servers 15
aaa authentication login default local
interface MgmtEth0/0/CPU0/0
 ipv4 address dhcp
!
ssh server v2
ssh server logging
end

RP/0/0/CPU0:iosxrv#admin show running-config
Building configuration...
!! IOS XR Admin Configuration 5.3.3
username vagrant
 group root-system
 secret 5 $1$gszu$edh0GNZQTZe7mfx8QNBk.1
!
end

RP/0/0/CPU0:iosxrv#show crypto key mypubkey rsa
Key label: the_default
Type     : RSA General purpose
Size     : 1024
Created  : 00:00:00 UTC Mon May 10 2021
Data     :
 30819F30 0D06092A 864886F7 0D010101 05000381 8D003081 89028181 00CE553D
 F00E7081 DCA54B0A 1CC81CAE 038B289E 802D295C CEAB8244 3D8A0C2C 706CD6D2
 FEDC0EA7 2A928F02 41D1F82D B0E41E57 292575E5 81F9FC78 3399D649 E6C248D0
 76B06369 F1EA3DCB B9BA8F39 89C4A0C4 63B3529D 42A9BC83 102A4FBB 938C4CD0
 836BA6A9 E35D089B 349F65E5 4D37F482 1C187E36 88B92D11 54241F28 A5020301
 0001
</code></pre></div><h1 id="iosxrv-base%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%81%8B%E3%82%89vagrant-box%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B">
<a class="header-anchor-link" href="#iosxrv-base%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%81%8B%E3%82%89vagrant-box%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%82%92%E4%BD%9C%E6%88%90%E3%81%99%E3%82%8B" aria-hidden="true"></a> IOSXRv baseイメージからvagrant boxファイルを作成する</h1>
<p>IOSXRvイメージはboxファイル作成にあたって、事前にVirtualBoxからshutdownさせておく必要がある。</p>
<p>まずはboxファイルを作成するために必要なVagrantfileを作成する。</p>
<div class="code-block-container"><pre><code>$ cat &lt;&lt;EOL&gt; embedded_vagrantfile
# -*- mode: ruby -*-
# vi: set ft=ruby :

Vagrant.configure(2) do |config|
  config.vm.synced_folder ".", "/vagrant", disabled: true
  config.vm.boot_timeout = 400

  config.ssh.username = "vagrant"
  config.ssh.password = "vagrant"
  config.ssh.insert_key = false
end
EOL
</code></pre></div><p>続いて、以下のコマンドでIOSXRvイメージからboxファイルを作成する。</p>
<div class="code-block-container"><pre><code>$ vagrant package --base com.cisco.ios-xrv --output iosxrv-k9-demo-5.3.3.box --vagrantfile embedded_vagrantfile
==&gt; com.cisco.ios-xrv: Exporting VM...
==&gt; com.cisco.ios-xrv: Compressing package to: /tmp/iosxrv/iosxrv-k9-demo-5.3.3.box
==&gt; com.cisco.ios-xrv: Packaging additional file: embedded_vagrantfile
</code></pre></div><p>このboxファイルをvagrantに登録する。boxの名前はここでは<code>iosxrv/5.3.3</code>とする。</p>
<div class="code-block-container"><pre><code>$ vagrant box add iosxrv-k9-demo-5.3.3.box --name iosxrv/5.3.3
==&gt; box: Box file was not detected as metadata. Adding it directly...
==&gt; box: Adding box 'iosxrv/5.3.3' (v0) for provider:
    box: Unpacking necessary files from: file:///tmp/iosxrv/iosxrv-k9-demo-5.3.3.box
==&gt; box: Successfully added box 'iosxrv/5.3.3' (v0) for 'virtualbox'!

$ vagrant box list
iosxrv/5.3.3       (virtualbox, 0)
</code></pre></div><h2 id="vagrant%E3%81%8B%E3%82%89iosxrv%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%82%92%E8%B5%B7%E5%8B%95">
<a class="header-anchor-link" href="#vagrant%E3%81%8B%E3%82%89iosxrv%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%82%92%E8%B5%B7%E5%8B%95" aria-hidden="true"></a> vagrantからIOSXRvイメージを起動</h2>
<p>VM起動時にもVagrantfileが必要なので、まずはこれを作成する。<br>
IOSXRvのバージョンが(おそらく)6.0.0より古い場合、IOSXRvイメージに作成したキーペアのalgorithmは<code>aes256-cbc, aes192-cbc, aes128-cbc</code>でvagrantの<code>Net::SSH</code>が標準ではサポートしていない。そのためVagrantfileの冒頭でこれらを暫定的かつ強制的にサポートさせる記述を加えた。</p>
<div class="code-block-container"><pre><code>$ cat &lt;&lt;EOL&gt; Vagrantfile
# -*- mode: ruby -*-
# vi: set ft=ruby :

class Net::SSH::Transport::Algorithms
  DEFAULT_ALGORITHMS[:encryption].unshift('aes256-cbc', 'aes192-cbc', 'aes128-cbc')
end

Vagrant.configure(2) do |config|
  config.vm.box = "iosxrv/5.3.3"
  config.vm.boot_timeout = 400
  config.vm.synced_folder ".", "/vagrant", disabled: true

  config.ssh.username = "vagrant"
  config.ssh.password = "vagrant"
  config.ssh.insert_key = false
end
EOL
</code></pre></div><p>さていよいよIOSXRvイメージを起動。<br>
イメージが正常に起動完了するまですこし時間を要するので気長に待つ。私の環境では3～4分ほど必要だった。</p>
<div class="code-block-container"><pre><code>$ vagrant up
Bringing machine 'default' up with 'virtualbox' provider...
==&gt; default: Importing base box 'iosxrv/5.3.3'...
==&gt; default: Matching MAC address for NAT networking...
==&gt; default: Setting the name of the VM: iosxrv_default_1620643366529_81167
==&gt; default: Clearing any previously set network interfaces...
==&gt; default: Preparing network interfaces based on configuration...
    default: Adapter 1: nat
==&gt; default: Forwarding ports...
==&gt; default: Running 'pre-boot' VM customizations...
==&gt; default: Booting VM...
==&gt; default: Waiting for machine to boot. This may take a few minutes...
    default: SSH address: 127.0.0.1:2222
    default: SSH username: vagrant
    default: SSH auth method: password
</code></pre></div><p>無事に起動すれば以下ようにvagrantからsshでログインできる。<br>
パスワードはもちろん<code>vagrant</code>。</p>
<div class="code-block-container"><pre><code>$ vagrant ssh
==&gt; default: The machine you're attempting to SSH into is configured to use
==&gt; default: password-based authentication. Vagrant can't script entering the
==&gt; default: password for you. If you're prompted for a password, please enter
==&gt; default: the same password you have configured in the Vagrantfile.
vagrant@192.168.33.191's password:


RP/0/0/CPU0:iosxrv#
</code></pre></div><p>さて、Mgmtインタフェースに設定されているIPv4アドレスを確認してみる。</p>
<div class="code-block-container"><pre><code>RP/0/0/CPU0:iosxrv#show ipv4 interface MgmtEth 0/0/CPU0/0 brief

Interface                      IP-Address      Status                Protocol
MgmtEth0/0/CPU0/0              192.168.33.191 Up                    Up
</code></pre></div><p>ホストPCからはMgmtインタフェースに設定されたこのIPv4アドレスにアクセスが可能。ためしにtelnet接続してみると以下の通り。<br>
username/passwordは<code>vagrant/vagrant</code>でもよいが、IOSXRvイメージのデフォルト<code>cisco/cisco</code>でもログイン可能。</p>
<div class="code-block-container"><pre><code>$ telnet 192.168.33.191
Trying 192.168.33.191...
Connected to 192.168.33.191.
Escape character is '^]'.



IMPORTANT:  READ CAREFULLY
Welcome to the Demo Version of Cisco IOS XRv (the "Software").
The Software is subject to and governed by the terms and conditions
of the End User License Agreement and the Supplemental End User
License Agreement accompanying the product, made available at the
time of your order, or posted on the Cisco website at
www.cisco.com/go/terms (collectively, the "Agreement").
As set forth more fully in the Agreement, use of the Software is
strictly limited to internal use in a non-production environment
solely for demonstration and evaluation purposes.  Downloading,
installing, or using the Software constitutes acceptance of the
Agreement, and you are binding yourself and the business entity
that you represent to the Agreement.  If you do not agree to all
of the terms of the Agreement, then Cisco is unwilling to license
the Software to you and (a) you may not download, install or use the
Software, and (b) you may return the Software as more fully set forth
in the Agreement.


Please login with any configured user/password, or cisco/cisco


User Access Verification

Username: cisco
Password:


RP/0/0/CPU0:iosxrv#
</code></pre></div><p>あとはnetconf設定を追加してみたり、好きに検証を進めればよい。</p>
<p>起動したVMを停止・削除する方法は下記。</p>
<div class="code-block-container"><pre><code>$ vagrant halt
$ vagrant destroy -f
</code></pre></div><p>Enjoy! 🎉</p>


IOSXRvをvagrantとVirtualBoxで一発起動する

IOSXRv baseイメージからvagrant boxファイルを作成する

haccht

<p>PCの性能によってはVMの起動に少し時間がかかってTimeoutしてしまうかも。その場合は下記の時間を長くすること。</p>
<div class="code-block-container"><pre><code>config.vm.boot_timeout = 400
</code></pre></div>

Discussion