* Error report from attempt to run an HVM instance
@ 2008-08-23 18:22 Michael Litchard
2008-08-23 18:41 ` Manuel Bouyer
` (2 more replies)
0 siblings, 3 replies; 9+ messages in thread
From: Michael Litchard @ 2008-08-23 18:22 UTC (permalink / raw)
To: port-xen, xen-devel
Tried to run an HVM instance, here's the error report I got.
# /usr/pkg/sbin/xm create -c /usr/pkg/share/examples/xen/hvm-netbsd
Using config file "/usr/pkg/share/examples/xen/hvm-netbsd".
Started domain hvm-netbsd
Unexpected error: exceptions.OSError
Please report to xen-devel@lists.xensource.com
Traceback (most recent call last):
File "/usr/pkg/sbin/xm", line 10, in ?
main.main(sys.argv)
File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line 2497, in main
_, rc = _run_cmd(cmd, cmd_name, args)
File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line
2521, in _run_cmd
return True, cmd(args)
File "<string>", line 1, in <lambda>
File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line
1299, in xm_importcommand
cmd.main([command] + args)
File "/usr/pkg/lib/python2.4/site-packages/xen/xm/create.py", line
1298, in main
do_console(sxp.child_value(config, 'name', -1))
File "/usr/pkg/lib/python2.4/site-packages/xen/xm/create.py", line
1323, in do_console
(p, rv) = os.waitpid(cpid, os.WNOHANG)
OSError: [Errno 10] No child processes
kernel = "/usr/pkg/lib/xen/boot/hvmloader"
builder='hvm'
# Initial memory allocation (in megabytes) for the new domain.
memory = 256
# A name for your domain. All domains must have different names.
name = "hvm-netbsd"
#Network interface. By default emules a realtek 8139. For a NetBSD guest you
# have to disable re(4) and let rtk attach to use it.
# ne2k_pci emulates a pci ne2000 clone; this his cpu-hungry in dom0
# pcnet emulates a AMD PCnet-PCI controller; but it corrupts packets with
# pcn(4) under NetBSD.
#vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu, model=ne2k_pci' ]
#vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu, model=pcnet' ]
vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu' ]
#----------------------------------------------------------------------------
# device model to use: only qemu-dm available for now
device_model = '/usr/pkg/libexec/qemu-dm'
# Define the disk devices you want the domain to have access to, and
# what you want them accessible as.
# Each disk entry is of the form phy:UNAME,DEV,MODE
# where UNAME is the device, DEV is the device name the domain will see,
# and MODE is r for read-only, w for read-write.
# For hvm domains you can only use hda to hdd. You can set extra types
# (e.g. cdrom)
disk = [ 'file:/sys/domains/domU3/amd64cd.iso,ioemu:hdc:cdrom,r' ]
disk = ['phy:/dev/wd0i,ioemu:hdb,w']
# floppy images; this doesn't seem to work currently. Use a iso image instead.
#fda = '/home/domains/boot1.fs'
# boot device: a = floppy, c= hard drive, d= cdrom (with the disk entry
# before)# for the virtal framebuffer. You can have the virtal
framebuffer in vnc
# instead, and connect using a vnc client (using localhost:$vncdisplay)
# If vncunused is set to 1 (this is the default value), vncdisplay
# will be set to the first unused port; so it's recommended to
#vnc = 1
#vncdisplay = 0
#vncunused = 0
#Xen emulates a PS/2 mouse, but the pointer in the guest has difficulties
# tracking the absolute position. Xen can emulate a USB tablet in addition
# to the mouse which will report the absolute position of the pointer,
# and make the mouse much easier to use.
#
usb=1
usbdevice='tablet'
#usbdevice='mouse'
Here's my kernel info
NetBSD logos 4.99.72 NetBSD 4.99.72 (XEN3_DOM0) #0: Sat Aug 9
17:34:05 PDT 2008
builds@wb30:/home/builds/ab/HEAD/amd64/200808090002Z-obj/home/builds/ab/HEAD/src/sys/arch/amd64/compile/XEN3_DOM0
amd64
Any feedback helping me troubleshoot this would be appreciate this. Thanks.
Michael Litchard
^ permalink raw reply [flat|nested] 9+ messages in thread* Re: Error report from attempt to run an HVM instance 2008-08-23 18:22 Error report from attempt to run an HVM instance Michael Litchard @ 2008-08-23 18:41 ` Manuel Bouyer 2008-08-23 18:53 ` Michael Litchard 2008-08-23 20:12 ` Christoph Egger 2008-08-26 13:40 ` Ian Jackson 2 siblings, 1 reply; 9+ messages in thread From: Manuel Bouyer @ 2008-08-23 18:41 UTC (permalink / raw) To: Michael Litchard; +Cc: port-xen, xen-devel On Sat, Aug 23, 2008 at 11:22:51AM -0700, Michael Litchard wrote: > Tried to run an HVM instance, here's the error report I got. > > # /usr/pkg/sbin/xm create -c /usr/pkg/share/examples/xen/hvm-netbsd ^^ > Using config file "/usr/pkg/share/examples/xen/hvm-netbsd". > Started domain hvm-netbsd > Unexpected error: exceptions.OSError > > Please report to xen-devel@lists.xensource.com > Traceback (most recent call last): > File "/usr/pkg/sbin/xm", line 10, in ? > main.main(sys.argv) > File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line 2497, in main > _, rc = _run_cmd(cmd, cmd_name, args) > File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line > 2521, in _run_cmd > return True, cmd(args) > File "<string>", line 1, in <lambda> > File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line > 1299, in xm_importcommand > cmd.main([command] + args) > File "/usr/pkg/lib/python2.4/site-packages/xen/xm/create.py", line > 1298, in main > do_console(sxp.child_value(config, 'name', -1)) > File "/usr/pkg/lib/python2.4/site-packages/xen/xm/create.py", line > 1323, in do_console > (p, rv) = os.waitpid(cpid, os.WNOHANG) > OSError: [Errno 10] No child processes Could it be because you're trying to connect to a serial console, while you have none configured ? -- Manuel Bouyer <bouyer@antioche.eu.org> NetBSD: 26 ans d'experience feront toujours la difference -- ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Error report from attempt to run an HVM instance 2008-08-23 18:41 ` Manuel Bouyer @ 2008-08-23 18:53 ` Michael Litchard 2008-08-23 19:18 ` Manuel Bouyer 0 siblings, 1 reply; 9+ messages in thread From: Michael Litchard @ 2008-08-23 18:53 UTC (permalink / raw) To: Manuel Bouyer; +Cc: xen-devel, port-xen I'm not intending to, I used the hvm script that came with pkgsrc. I can't find any line in the script that suggests trying to connect to a serial console. If there is a line, could you point it out to me? Michael Litchard On Sat, Aug 23, 2008 at 11:41 AM, Manuel Bouyer <bouyer@antioche.eu.org> wrote: > On Sat, Aug 23, 2008 at 11:22:51AM -0700, Michael Litchard wrote: >> Tried to run an HVM instance, here's the error report I got. >> >> # /usr/pkg/sbin/xm create -c /usr/pkg/share/examples/xen/hvm-netbsd > ^^ >> Using config file "/usr/pkg/share/examples/xen/hvm-netbsd". >> Started domain hvm-netbsd >> Unexpected error: exceptions.OSError >> >> Please report to xen-devel@lists.xensource.com >> Traceback (most recent call last): >> File "/usr/pkg/sbin/xm", line 10, in ? >> main.main(sys.argv) >> File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line 2497, in main >> _, rc = _run_cmd(cmd, cmd_name, args) >> File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line >> 2521, in _run_cmd >> return True, cmd(args) >> File "<string>", line 1, in <lambda> >> File "/usr/pkg/lib/python2.4/site-packages/xen/xm/main.py", line >> 1299, in xm_importcommand >> cmd.main([command] + args) >> File "/usr/pkg/lib/python2.4/site-packages/xen/xm/create.py", line >> 1298, in main >> do_console(sxp.child_value(config, 'name', -1)) >> File "/usr/pkg/lib/python2.4/site-packages/xen/xm/create.py", line >> 1323, in do_console >> (p, rv) = os.waitpid(cpid, os.WNOHANG) >> OSError: [Errno 10] No child processes > > Could it be because you're trying to connect to a serial console, > while you have none configured ? > > -- > Manuel Bouyer <bouyer@antioche.eu.org> > NetBSD: 26 ans d'experience feront toujours la difference > -- > ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Error report from attempt to run an HVM instance 2008-08-23 18:53 ` Michael Litchard @ 2008-08-23 19:18 ` Manuel Bouyer 0 siblings, 0 replies; 9+ messages in thread From: Manuel Bouyer @ 2008-08-23 19:18 UTC (permalink / raw) To: Michael Litchard; +Cc: port-xen, xen-devel On Sat, Aug 23, 2008 at 11:53:24AM -0700, Michael Litchard wrote: > I'm not intending to, I used the hvm script that came with pkgsrc. I > can't find any > line in the script that suggests trying to connect to a serial > console. If there is a line, could you point it out to me? You're using 'xm create -c' -c instructs to connect to console -- Manuel Bouyer <bouyer@antioche.eu.org> NetBSD: 26 ans d'experience feront toujours la difference -- ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Error report from attempt to run an HVM instance 2008-08-23 18:22 Error report from attempt to run an HVM instance Michael Litchard 2008-08-23 18:41 ` Manuel Bouyer @ 2008-08-23 20:12 ` Christoph Egger 2008-08-24 7:43 ` Michael Litchard 2008-08-26 13:40 ` Ian Jackson 2 siblings, 1 reply; 9+ messages in thread From: Christoph Egger @ 2008-08-23 20:12 UTC (permalink / raw) To: Michael Litchard; +Cc: port-xen, xen-devel Michael Litchard wrote: > Tried to run an HVM instance, here's the error report I got. > [...] > kernel = "/usr/pkg/lib/xen/boot/hvmloader" > > builder='hvm' > > # Initial memory allocation (in megabytes) for the new domain. > memory = 256 > > # A name for your domain. All domains must have different names. > name = "hvm-netbsd" > > #Network interface. By default emules a realtek 8139. For a NetBSD guest you > # have to disable re(4) and let rtk attach to use it. > # ne2k_pci emulates a pci ne2000 clone; this his cpu-hungry in dom0 > # pcnet emulates a AMD PCnet-PCI controller; but it corrupts packets with > # pcn(4) under NetBSD. > #vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu, model=ne2k_pci' ] > #vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu, model=pcnet' ] > vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu' ] > > #---------------------------------------------------------------------------- > # device model to use: only qemu-dm available for now > device_model = '/usr/pkg/libexec/qemu-dm' > > # Define the disk devices you want the domain to have access to, and > # what you want them accessible as. > # Each disk entry is of the form phy:UNAME,DEV,MODE > # where UNAME is the device, DEV is the device name the domain will see, > # and MODE is r for read-only, w for read-write. > # For hvm domains you can only use hda to hdd. You can set extra types > # (e.g. cdrom) > > disk = [ 'file:/sys/domains/domU3/amd64cd.iso,ioemu:hdc:cdrom,r' ] > > disk = ['phy:/dev/wd0i,ioemu:hdb,w'] Replace these two disk lines by this: disk = [ 'phy:/dev/wd0i,ioemu:hdb,w', 'file:/sys/domains/domU3/amd64cd.iso,ioemu:hdc:cdrom,r' ] Christoph ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Error report from attempt to run an HVM instance 2008-08-23 20:12 ` Christoph Egger @ 2008-08-24 7:43 ` Michael Litchard 2008-08-24 10:31 ` Manuel Bouyer 0 siblings, 1 reply; 9+ messages in thread From: Michael Litchard @ 2008-08-24 7:43 UTC (permalink / raw) To: Christoph Egger; +Cc: xen-devel, port-xen okay the instance is created # /usr/pkg/sbin/xm list Name ID Mem VCPUs State Time(s) Domain-0 0 1024 1 r----- 57.3 hvm-netbsd 1 256 1 r----- 237.2 but when I did a xm create -c I got this error, and again when I tried to attach to the console # /usr/pkg/sbin/xm console hvm-netbsd xenconsole: Could not read tty from store: No such file or directory I'm close. The config file is the same except the changes christoph suggested. What can I do now? On Sat, Aug 23, 2008 at 1:12 PM, Christoph Egger <Christoph_Egger@gmx.de> wrote: > Michael Litchard wrote: >> >> Tried to run an HVM instance, here's the error report I got. >> > [...] > >> kernel = "/usr/pkg/lib/xen/boot/hvmloader" >> >> builder='hvm' >> >> # Initial memory allocation (in megabytes) for the new domain. >> memory = 256 >> >> # A name for your domain. All domains must have different names. >> name = "hvm-netbsd" >> >> #Network interface. By default emules a realtek 8139. For a NetBSD guest >> you >> # have to disable re(4) and let rtk attach to use it. >> # ne2k_pci emulates a pci ne2000 clone; this his cpu-hungry in dom0 >> # pcnet emulates a AMD PCnet-PCI controller; but it corrupts packets with >> # pcn(4) under NetBSD. >> #vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu, >> model=ne2k_pci' ] >> #vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu, model=pcnet' >> ] >> vif = [ 'mac=00:16:3e:00:00:13, bridge=bridge0, type=ioemu' ] >> >> >> #---------------------------------------------------------------------------- >> # device model to use: only qemu-dm available for now >> device_model = '/usr/pkg/libexec/qemu-dm' >> >> # Define the disk devices you want the domain to have access to, and >> # what you want them accessible as. >> # Each disk entry is of the form phy:UNAME,DEV,MODE >> # where UNAME is the device, DEV is the device name the domain will see, >> # and MODE is r for read-only, w for read-write. >> # For hvm domains you can only use hda to hdd. You can set extra types >> # (e.g. cdrom) >> >> disk = [ 'file:/sys/domains/domU3/amd64cd.iso,ioemu:hdc:cdrom,r' ] >> >> disk = ['phy:/dev/wd0i,ioemu:hdb,w'] > > Replace these two disk lines by this: > > disk = [ 'phy:/dev/wd0i,ioemu:hdb,w', > 'file:/sys/domains/domU3/amd64cd.iso,ioemu:hdc:cdrom,r' ] > > Christoph > ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Error report from attempt to run an HVM instance 2008-08-24 7:43 ` Michael Litchard @ 2008-08-24 10:31 ` Manuel Bouyer 0 siblings, 0 replies; 9+ messages in thread From: Manuel Bouyer @ 2008-08-24 10:31 UTC (permalink / raw) To: Michael Litchard; +Cc: Christoph Egger, port-xen, xen-devel On Sun, Aug 24, 2008 at 12:43:01AM -0700, Michael Litchard wrote: > okay the instance is created > > # /usr/pkg/sbin/xm list > Name ID Mem VCPUs State Time(s) > Domain-0 0 1024 1 r----- 57.3 > hvm-netbsd 1 256 1 r----- 237.2 > > but when I did a xm create -c I got this error, and again when I tried > to attach to the console > # /usr/pkg/sbin/xm console hvm-netbsd > xenconsole: Could not read tty from store: No such file or directory This is not the way you connect to a HVM console, unless you configured the HVM guest to use a serial console. By default it's the HVM's virtual framebuffer. The virtual framebuffer can be displayed in 2 ways, depending on the config file: 1) using the SDL library. qemu-dm will open a X window on the $DISPLAY from which xm create was run. If $DISPLAY isn't valid, I think the guest will start without console display. 2) qemu-dm act as a vnc server. You connect to the console using vncviewer on localhost. As you only have one guest, I guess it''ll be vncviewer localhost:0 -- Manuel Bouyer <bouyer@antioche.eu.org> NetBSD: 26 ans d'experience feront toujours la difference -- ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: Error report from attempt to run an HVM instance 2008-08-23 18:22 Error report from attempt to run an HVM instance Michael Litchard 2008-08-23 18:41 ` Manuel Bouyer 2008-08-23 20:12 ` Christoph Egger @ 2008-08-26 13:40 ` Ian Jackson 2008-08-26 18:17 ` [Xen-devel] " Michael Litchard 2 siblings, 1 reply; 9+ messages in thread From: Ian Jackson @ 2008-08-26 13:40 UTC (permalink / raw) To: Michael Litchard; +Cc: xen-devel, port-xen Michael Litchard writes ("[Xen-devel] Error report from attempt to run an HVM instance"): > Tried to run an HVM instance, here's the error report I got. Can we see your xend.log ? Ian. ^ permalink raw reply [flat|nested] 9+ messages in thread
* Re: [Xen-devel] Error report from attempt to run an HVM instance 2008-08-26 13:40 ` Ian Jackson @ 2008-08-26 18:17 ` Michael Litchard 0 siblings, 0 replies; 9+ messages in thread From: Michael Litchard @ 2008-08-26 18:17 UTC (permalink / raw) To: Ian Jackson; +Cc: port-xen, xen-devel [-- Attachment #1: Type: text/plain, Size: 3977 bytes --] I started to cut and paste, but it's a big honking file. Here's what I managed to paste. The entire thing is attached Michael Litchard [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:451) XendDomainInfo.shutdown(poweroff) [2008-08-24 16:08:05 177] INFO (XendDomainInfo:469) HVM save:remote shutdown dom 14! [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:998) XendDomainInfo.handleShutdownWatch [2008-08-24 16:08:05 177] INFO (XendDomainInfo:1192) Domain has shutdown: name=hvm-netbsd id=14 reason=poweroff. [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:1779) XendDomainInfo.destroy: domid=14 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:1798) XendDomainInfo.destroyDomain(14) [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:1444) Removing vif/0 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:574) XendDomainInfo.destroyDevice: deviceC lass = vif, device = vif/0 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:1444) Removing vbd/832 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:574) XendDomainInfo.destroyDevice: deviceC lass = vbd, device = vbd/832 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:1444) Removing vbd/5632 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:574) XendDomainInfo.destroyDevice: deviceC lass = vbd, device = vbd/5632 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:1444) Removing vfb/0 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:574) XendDomainInfo.destroyDevice: deviceC lass = vfb, device = vfb/0 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:1444) Removing console/0 [2008-08-24 16:08:05 177] DEBUG (XendDomainInfo:574) XendDomainInfo.destroyDevice: deviceC lass = console, device = console/0 [2008-08-24 16:08:10 177] DEBUG (XendDomainInfo:84) XendDomainInfo.create(['vm', ['name', 'hvm-netbsd'], ['memory', 256], ['vcpus', 1], ['on_xend_start', 'ignore'], ['on_xend_stop' , 'ignore'], ['image', ['hvm', ['kernel', '/usr/pkg/lib/xen/boot/hvmloader'], ['device_mod el', '/usr/pkg/libexec/qemu-dm'], ['pae', 1], ['vcpus', 1], ['boot', 'd'], ['fda', ''], [' fdb', ''], ['timer_mode', 0], ['localtime', 0], ['serial', 'pty'], ['stdvga', 0], ['isa', 0], ['nographic', 0], ['soundhw', ''], ['vncunused', 1], ['display', ':0.0'], ['xauthority ', '/sys/.Xauthority'], ['rtc_timeoffset', '0'], ['monitor', 0], ['acpi', 1], ['apic', 1], ['usb', 1], ['usbdevice', 'tablet'], ['keymap', '']]], ['device', ['vbd', ['uname', 'phy: /dev/wd0i'], ['dev', 'ioemu:hdb'], ['mode', 'w']]], ['device', ['vbd', ['uname', 'file:/sy s/domains/domU3/i386cd.iso'], ['dev', 'ioemu:hdc:cdrom'], ['mode', 'r']]], ['device', ['vi f', ['bridge', 'bridge0'], ['mac', '00:16:3e:00:00:13'], ['type', 'ioemu']]]]) [2008-08-24 16:08:10 177] DEBUG (XendDomainInfo:1520) XendDomainInfo.constructDomain [2008-08-24 16:08:10 177] DEBUG (balloon:115) Balloon: 1003332 KiB free; need 2048; done. [2008-08-24 16:08:10 177] DEBUG (XendDomain:434) Adding Domain: 15 [2008-08-24 16:08:10 177] DEBUG (XendDomainInfo:1580) XendDomainInfo.initDomain: 15 256 [2008-08-24 16:08:10 177] DEBUG (image:337) args: boot, val: d [2008-08-24 16:08:10 177] DEBUG (image:337) args: fda, val: None [2008-08-24 16:08:10 177] DEBUG (image:337) args: fdb, val: None [2008-08-24 16:08:10 177] DEBUG (image:337) args: soundhw, val: None [2008-08-24 16:08:10 177] DEBUG (image:337) args: localtime, val: 0 [2008-08-24 16:08:10 177] DEBUG (image:337) args: serial, val: pty [2008-08-24 16:08:10 177] DEBUG (image:337) args: std-vga, val: 0 [2008-08-24 16:08:10 177] DEBUG (image:337) args: isa, val: 0 [2008-08-24 16:08:10 177] DEBUG (image:337) args: acpi, val: 1 [2008-08-24 16:08:10 177] DEBUG (image:337) args: usb, val: 1 [2008-08-24 16:08:10 177] DEBUG (image:337) args: usbdevice, val: tablet [2008-08-24 16:08:10 177] DEBUG (image:337) args: k, val: None [2008-08-24 16:08:10 177] DEBUG (XendDomainInfo:1614) _initDomain:shadow_memory=0x0, memor y_static_max=0x10000000, memory_static_min=0x0. [2008-08-24 16:08:10 177] DEBUG (balloon:115) Balloon: 1002296 KiB free; need 273408; done ^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2008-08-26 18:17 UTC | newest] Thread overview: 9+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2008-08-23 18:22 Error report from attempt to run an HVM instance Michael Litchard 2008-08-23 18:41 ` Manuel Bouyer 2008-08-23 18:53 ` Michael Litchard 2008-08-23 19:18 ` Manuel Bouyer 2008-08-23 20:12 ` Christoph Egger 2008-08-24 7:43 ` Michael Litchard 2008-08-24 10:31 ` Manuel Bouyer 2008-08-26 13:40 ` Ian Jackson 2008-08-26 18:17 ` [Xen-devel] " Michael Litchard
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.