OpenVistA Server in VirtualBox - Revision history

NeilArmstrong: Added a glossary link to Configuration~

2012-12-20T00:16:59Z

Added a glossary link to Configuration~

NeilArmstrong: Added a glossary link to record~

2012-04-01T13:46:10Z

Added a glossary link to record~

← Older revision		Revision as of 13:46, 1 April 2012
Line 39:		Line 39:
	* Task selection. A menu will appear to select options for additional packages to be installed along with the server. Now is a good time to install two packages that will be required by WorldVistA: the LAMP (Linux, Apache2, MySQL, and PHP) server package, and the OpenSSH package. Make sure these two packages are starred (use the space button to select them) before completing the installation.		* Task selection. A menu will appear to select options for additional packages to be installed along with the server. Now is a good time to install two packages that will be required by WorldVistA: the LAMP (Linux, Apache2, MySQL, and PHP) server package, and the OpenSSH package. Make sure these two packages are starred (use the space button to select them) before completing the installation.

	:*You will be prompted to enter an MySQL root user password during the LAMP server package installation. This password becomes important later on (in some instances). Record your chosen MySQL password in a safe location. Do not use your primary user password as the MySQL password; it ought to be unique.		:*You will be prompted to enter an MySQL root user password during the LAMP server package installation. This password becomes important later on (in some instances). [[Record~\|Record]] your chosen MySQL password in a safe location. Do not use your primary user password as the MySQL password; it ought to be unique.

	* Finish the remainder of the Ubuntu Server installation. At the conclusion the Ubuntu system will automatically reboot within the virtual machine. When it restarts, you will then have a fully function Ubuntu Server within the virtual machine. Login using the primary user and password (that you created during the Ubuntu Server installation process) and immediately update the operating system:		* Finish the remainder of the Ubuntu Server installation. At the conclusion the Ubuntu system will automatically reboot within the virtual machine. When it restarts, you will then have a fully function Ubuntu Server within the virtual machine. Login using the primary user and password (that you created during the Ubuntu Server installation process) and immediately update the operating system:

Perspectoff: /* Install the Astronaut WorldVistA Clients on the host OS */

2010-01-30T21:15:20Z

Install the Astronaut WorldVistA Clients on the host OS

← Older revision		Revision as of 21:15, 30 January 2010
Line 171:		Line 171:
	* The initial login ID is noted to be openvistaEHR with an initial default password vista!123. This is used for logging into the OpenVistA server directly from within the Ubuntu Server OS. It is ''not'' the access code/verify code pair that a user enters when logging in from a [[Astronaut CPRS client package\|VistA client module]] (e.g. TMG-CPRS).		* The initial login ID is noted to be openvistaEHR with an initial default password vista!123. This is used for logging into the OpenVistA server directly from within the Ubuntu Server OS. It is ''not'' the access code/verify code pair that a user enters when logging in from a [[Astronaut CPRS client package\|VistA client module]] (e.g. TMG-CPRS).

	=== Install the Astronaut ~~WorldVistA~~ Clients on the host OS ===		=== Install the Astronaut VistA Clients on the host OS ===
	* See [[Astronaut CPRS client package\|Connecting with a CPRS client]].		* See [[Astronaut CPRS client package\|Connecting with a CPRS client]].

	*When installing the Astronaut clients, use the IP address of the virtual machine (''192.168.56.101'', for example) as the server address.		*When installing the Astronaut clients, use the IP address of the virtual machine (''192.168.56.101'', for example) as the server address.

Perspectoff: /* Install the WorldVistA server into the virtual machine */

2010-01-30T21:15:04Z

Install the WorldVistA server into the virtual machine

← Older revision		Revision as of 21:15, 30 January 2010
Line 162:		Line 162:
	:If you get a response, then the internal networking connection is working properly.		:If you get a response, then the internal networking connection is working properly.

	=== Install the ~~WorldVistA~~ server into the virtual machine ===		=== Install the OpenVistA server into the virtual machine ===

	* Use the Astronaut VistA installer to install the OpenVistA server (downloaded in a [[#Download the Astronaut OpenVistA server package\|previous step]]) into the Ubuntu Server OS running in the virtual machine:		* Use the Astronaut VistA installer to install the OpenVistA server (downloaded in a [[#Download the Astronaut OpenVistA server package\|previous step]]) into the Ubuntu Server OS running in the virtual machine:

Perspectoff: /* NAT Adapter */

2010-01-30T21:13:07Z

NAT Adapter

← Older revision		Revision as of 21:13, 30 January 2010
Line 136:		Line 136:

	==== NAT Adapter ====		==== NAT Adapter ====
	This mode is a simplified networking mode in which the virtual machine obtains a DHCP-assigned temporary address from the LAN. The virtual machine cannot act as a server using this mode, but can still connect to the Internet (through the host adapter). This mode is useful for temporarily connecting to the Internet (to accomplish software updates for the guest OS, for example), since this cannot be done in Host-only adapter mode. This mode should not be enabled during the [[#Install the ~~WorldVistA~~ server into the virtual machine\|installation of the Astronaut ~~WorldVistA~~ server]] (use one of the other two modes instead).		This mode is a simplified networking mode in which the virtual machine obtains a DHCP-assigned temporary address from the LAN. The virtual machine cannot act as a server using this mode, but can still connect to the Internet (through the host adapter). This mode is useful for temporarily connecting to the Internet (to accomplish software updates for the guest OS, for example), since this cannot be done in Host-only adapter mode. This mode should not be enabled during the [[#Install the OpenVistA server into the virtual machine\|installation of the Astronaut OpenVistA server]] (use one of the other two modes instead).

	=== Check the IP address of the virtual machine ===		=== Check the IP address of the virtual machine ===

Perspectoff: /* Host-only Adapter */

2010-01-30T21:12:30Z

Host-only Adapter

← Older revision		Revision as of 21:12, 30 January 2010
Line 128:		Line 128:

	==== Host-only Adapter ====		==== Host-only Adapter ====
	* For a self-contained single-computer EHR, the VirtualBox "Host-only Adapter" mode can be useful. The virtual machine will create an IP address (from its own unique IP address pool). In this mode the Windows host operating system (which has the ~~WorldVistA~~ client modules) communicates directly with the Ubuntu Linux guest operating system running in the virtual machine (where the ~~WorldVistA~~ server resides). The SSH connection established by the Astronaut installer will then connect directly (through an internal "loopback" arrangement). No other computer on the LAN will be able to access the server in the virtual machine using this mode, however.		* For a self-contained single-computer EHR, the VirtualBox "Host-only Adapter" mode can be useful. The virtual machine will create an IP address (from its own unique IP address pool). In this mode the Windows host operating system (which has the VistA client modules) communicates directly with the Ubuntu Linux guest operating system running in the virtual machine (where the OpenVistA server resides). The SSH connection established by the Astronaut installer will then connect directly (through an internal "loopback" arrangement). No other computer on the LAN will be able to access the server in the virtual machine using this mode, however.

	:VirtualBox -> Machine -> Settings -> Network ->		:VirtualBox -> Machine -> Settings -> Network ->

Perspectoff: /* Configure virtual machine networking */

2010-01-30T21:11:01Z

Configure virtual machine networking

← Older revision		Revision as of 21:11, 30 January 2010
Line 84:		Line 84:

	=== Configure virtual machine networking ===		=== Configure virtual machine networking ===
	*(During the entire installation process I recommend turning off your firewall. Once everything is working properly, turn your firewall back on and then adjust it so that everything again functions properly. ~~VMWare~~ has a very complex networking structure that is sure to bamboozle even the most sophisticated firewall. I spent more than half my installation time working with the firewall.)		*(During the entire installation process I recommend turning off your firewall. Once everything is working properly, turn your firewall back on and then adjust it so that everything again functions properly. VirtualBox has a very complex networking structure that is sure to bamboozle even the most sophisticated firewall. I spent more than half my installation time working with the firewall.)

	*This can be a tricky exercise, depending on your intent. For VirtualBox networking options, read the Help Manual provided within the VirtualBox console:		*This can be a tricky exercise, depending on your intent. For VirtualBox networking options, read the Help Manual provided within the VirtualBox console:

Perspectoff: /* Download the Astronaut WorldVistA server package */

2010-01-30T21:10:30Z

Download the Astronaut WorldVistA server package

← Older revision		Revision as of 21:10, 30 January 2010
Line 72:		Line 72:
	sudo apt-get install whois xinetd update-inetd apache2-suexec		sudo apt-get install whois xinetd update-inetd apache2-suexec

	=== Download the Astronaut ~~WorldVistA~~ server package ===		=== Download the Astronaut OpenVistA server package ===

	Depending on the networking configuration selected in the next step, Internet access for the virtual machine may not be available (if the "host-only adapter" networking mode is selected, for example). Therefore, it is important to download all packages from the Internet prior to changing the network adapter configuration.		Depending on the networking configuration selected in the next step, Internet access for the virtual machine may not be available (if the "host-only adapter" networking mode is selected, for example). Therefore, it is important to download all packages from the Internet prior to changing the network adapter configuration.

	* Download (but do not install) the Astronaut ~~WorldVistA~~ server package:		* Download (but do not install) the Astronaut OpenVistA server package:
	wget -O astronaut-ov-server-current.deb <nowiki>http://sourceforge.net/projects/astronaut/files/Astronaut%20OpenVistA%28tm%29%20Server/astronaut-ov-server-beta-0.9-3.deb/download</nowiki>		wget -O astronaut-ov-server-current.deb <nowiki>http://sourceforge.net/projects/astronaut/files/Astronaut%20OpenVistA%28tm%29%20Server/astronaut-ov-server-beta-0.9-3.deb/download</nowiki>

Perspectoff: /* Install the WorldVistA server into the virtual machine */

2010-01-30T21:10:00Z

Install the WorldVistA server into the virtual machine

← Older revision		Revision as of 21:10, 30 January 2010
Line 164:		Line 164:
	=== Install the WorldVistA server into the virtual machine ===		=== Install the WorldVistA server into the virtual machine ===

	* Use the Astronaut VistA installer to install the ~~WorldVistA~~ server (downloaded in a [[#Download the Astronaut ~~WorldVistA~~ server package\|previous step]]) into the Ubuntu Server OS running in the virtual machine:		* Use the Astronaut VistA installer to install the OpenVistA server (downloaded in a [[#Download the Astronaut OpenVistA server package\|previous step]]) into the Ubuntu Server OS running in the virtual machine:
	sudo dpkg -i astronaut-ov-server-current.deb		sudo dpkg -i astronaut-ov-server-current.deb

	* The installer will automatically recognize the IP address of the VirtualBox virtual machine to be ''192.168.56.101'', as well as Instance Name: EHR and Port: 9260.		* The installer will automatically recognize the IP address of the VirtualBox virtual machine to be ''192.168.56.101'', as well as Instance Name: EHR and Port: 9260.

	* The initial login ID is noted to be ~~worldvistaEHR~~ with an initial default password vista!123. This is used for logging into the ~~WorldVistA~~ server directly from within the Ubuntu Server OS. It is ''not'' the access code/verify code pair that a user enters when logging in from a [[Astronaut CPRS client package\|~~WorldVistA~~ client module]] (e.g. TMG-CPRS).		* The initial login ID is noted to be openvistaEHR with an initial default password vista!123. This is used for logging into the OpenVistA server directly from within the Ubuntu Server OS. It is ''not'' the access code/verify code pair that a user enters when logging in from a [[Astronaut CPRS client package\|VistA client module]] (e.g. TMG-CPRS).

	=== Install the Astronaut WorldVistA Clients on the host OS ===		=== Install the Astronaut WorldVistA Clients on the host OS ===

Perspectoff: /* Install the WorldVistA server into the virtual machine */

2010-01-30T21:08:54Z

Install the WorldVistA server into the virtual machine

← Older revision		Revision as of 21:08, 30 January 2010
Line 165:		Line 165:

	* Use the Astronaut VistA installer to install the WorldVistA server (downloaded in a [[#Download the Astronaut WorldVistA server package\|previous step]]) into the Ubuntu Server OS running in the virtual machine:		* Use the Astronaut VistA installer to install the WorldVistA server (downloaded in a [[#Download the Astronaut WorldVistA server package\|previous step]]) into the Ubuntu Server OS running in the virtual machine:
	sudo dpkg -i astronaut-wv-server-current.deb		sudo dpkg -i astronaut-ov-server-current.deb

	* The installer will automatically recognize the IP address of the VirtualBox virtual machine to be ''192.168.56.101'', as well as Instance Name: EHR and Port: 9260.		* The installer will automatically recognize the IP address of the VirtualBox virtual machine to be ''192.168.56.101'', as well as Instance Name: EHR and Port: 9260.

← Older revision		Revision as of 00:16, 20 December 2012
Line 66:		Line 66:
	To run the VistA server, a GUI desktop is not required. (Personally, I don't use a desktop for the virtual machine server.) But to do this, several packages that are normally installed with the desktop must be installed individually:		To run the VistA server, a GUI desktop is not required. (Personally, I don't use a desktop for the virtual machine server.) But to do this, several packages that are normally installed with the desktop must be installed individually:

	* Install wget (to retrieve packages) and iptables (for firewall rules) and nano (for configuration file editing):		* Install wget (to retrieve packages) and iptables (for firewall rules) and nano (for [[configuration~\|Configuration]] file editing):
	sudo apt-get install wget iptables nano		sudo apt-get install wget iptables nano

Line 74:		Line 74:
	=== Download the Astronaut OpenVistA server package ===		=== Download the Astronaut OpenVistA server package ===

	Depending on the networking configuration selected in the next step, Internet access for the virtual machine may not be available (if the "host-only adapter" networking mode is selected, for example). Therefore, it is important to download all packages from the Internet prior to changing the network adapter configuration.		Depending on the networking [[configuration~\|Configuration]] selected in the next step, Internet access for the virtual machine may not be available (if the "host-only adapter" networking mode is selected, for example). Therefore, it is important to download all packages from the Internet prior to changing the network adapter [[configuration~\|Configuration]].

	* Download (but do not install) the Astronaut OpenVistA server package:		* Download (but do not install) the Astronaut OpenVistA server package:
	wget -O astronaut-ov-server-current.deb <nowiki>http://sourceforge.net/projects/astronaut/files/Astronaut%20OpenVistA%28tm%29%20Server/astronaut-ov-server-beta-0.9-3.deb/download</nowiki>		wget -O astronaut-ov-server-current.deb <nowiki>http://sourceforge.net/projects/astronaut/files/Astronaut%20OpenVistA%28tm%29%20Server/astronaut-ov-server-beta-0.9-3.deb/download</nowiki>

	The Astronaut installer recognizes the network configuration during installation, so Astronaut installation should not be started until the virtual machine's network adapter is configured correctly (see below).		The Astronaut installer recognizes the network [[configuration~\|Configuration]] during installation, so Astronaut installation should not be started until the virtual machine's network adapter is configured correctly (see below).

	*If the virtual machine cannot connect to the Internet, you must restore a network-adapter configuration that allows it. Use either the [[#NAT Adapter\|NAT Adapter mode]] or the [[#Bridged Adapter\|Bridged Adapter mode]]. Shutdown the Ubuntu Server OS (sudo halt) and close the virtual machine before changing the network adapter mode. Restart the virtual machine after changing the mode.		*If the virtual machine cannot connect to the Internet, you must restore a network-adapter [[configuration~\|Configuration]] that allows it. Use either the [[#NAT Adapter\|NAT Adapter mode]] or the [[#Bridged Adapter\|Bridged Adapter mode]]. Shutdown the Ubuntu Server OS (sudo halt) and close the virtual machine before changing the network adapter mode. Restart the virtual machine after changing the mode.

	=== Configure virtual machine networking ===		=== Configure virtual machine networking ===
Line 106:		Line 106:
	It is often desirable to have a static IP address on the LAN for your virtual machine server. The network administrator must assign the static IP address on the LAN for use by the virtual server (especially if a DNS nameserver is in use on the network). Let's say the LAN has a router/gateway address of 192.168.1.1, a static IP address range of 192.168.1.125 - 192.168.1.253, and the virtual server is assigned an IP address of 192.168.1.135. Then the Ubuntu Server guest OS (in the virtual machine) can be configured to use this static IP address.		It is often desirable to have a static IP address on the LAN for your virtual machine server. The network administrator must assign the static IP address on the LAN for use by the virtual server (especially if a DNS nameserver is in use on the network). Let's say the LAN has a router/gateway address of 192.168.1.1, a static IP address range of 192.168.1.125 - 192.168.1.253, and the virtual server is assigned an IP address of 192.168.1.135. Then the Ubuntu Server guest OS (in the virtual machine) can be configured to use this static IP address.

	*Once the virtual machine is again running and the Ubuntu Server OS re-started, edit the /etc/network/interfaces configuration file:		*Once the virtual machine is again running and the Ubuntu Server OS re-started, edit the /etc/network/interfaces [[configuration~\|Configuration]] file:
	sudo nano /etc/network/interfaces		sudo nano /etc/network/interfaces

Line 139:		Line 139:

	=== Check the IP address of the virtual machine ===		=== Check the IP address of the virtual machine ===
	When using the Bridged and Host-only Adapter modes, an IP address for the virtual machine will be generated. It is important to make sure that this IP address can then be reached from the host operating system. (If not, the problem most often resides with the firewall, or with the adapter-bridging configuration, or perhaps even with the LAN's router/DHCP server.)		When using the Bridged and Host-only Adapter modes, an IP address for the virtual machine will be generated. It is important to make sure that this IP address can then be reached from the host operating system. (If not, the problem most often resides with the firewall, or with the adapter-bridging [[configuration~\|Configuration]], or perhaps even with the LAN's router/DHCP server.)

	* Start the Ubuntu virtual machine and from a [http://ubuntuguide.org/wiki/Ubuntu:All#General_Notes command-line terminal] examine the IP address:		* Start the Ubuntu virtual machine and from a [http://ubuntuguide.org/wiki/Ubuntu:All#General_Notes command-line terminal] examine the IP address: