Difference between revisions of "Astronaut Client on a USB drive"

From VistApedia
Jump to: navigation, search
(Added glossary link to Configuration~)
 
(17 intermediate revisions by one other user not shown)
Line 1: Line 1:
A USB flashdrive is meant to be moved from one computer to the next, so environment variables will not be constant. To install the Astronaut CPRS client package and use it successfully from a USB flash drive, you will have to use the method for [[Astronaut_CPRS_client_package#Installing in a protected environment|installing to a protected environment]] (i.e. edit all connection shortcuts to use values instead of environment variables).
+
A USB flashdrive is meant to be moved from one computer to the next, so environment variables will not be constant. To install the Astronaut CPRS client package and use it successfully from a USB flash drive, you will have to use the method for [[Astronaut_CPRS_client_package#Installing in a protected environment|installing to a protected environment]] (i.e. edit all connection shortcuts to use specific values instead of environment variables).
  
 
== Install Astronaut clients to the USB drive ==
 
== Install Astronaut clients to the USB drive ==
 
''In the example below, I will use a USB drive on F:''
 
''In the example below, I will use a USB drive on F:''
  
*Create an ''Astronaut'' folder on your USB drive (e.g. ''F:/Astronaut/'').
+
*Create an ''Astronaut'' folder on your USB drive (e.g. ''F:\Astronaut\'').
 
*Run the Astronaut_clients installer. (Currently, this works best if the Astronaut_clients.x.x.x.x.exe installer program is located on (and run from) the hard drive, not the USB drive.)  
 
*Run the Astronaut_clients installer. (Currently, this works best if the Astronaut_clients.x.x.x.x.exe installer program is located on (and run from) the hard drive, not the USB drive.)  
 
:*Astronaut VistA Host Name or IP Address (use default if unsure): ''192.168.0.73''
 
:*Astronaut VistA Host Name or IP Address (use default if unsure): ''192.168.0.73''
:::Note: Use the URL or IP address of your own VistA server (or virtual machine containing the VistA server)
+
:::Note: Use the IP address or URL of your own VistA server (or virtual machine containing the VistA server)
:*Choose Install Location: Destination Folder: ''F:/Astronaut/VistA''
+
:*Choose Install Location: Destination Folder: ''F:\Astronaut\VistA''
 
:::Note: Use the drive letter of your USB drive, of course.
 
:::Note: Use the drive letter of your USB drive, of course.
 
:*Choose Start Menu Folder: Select the Start Menu folder... : ''AstronautUSB''
 
:*Choose Start Menu Folder: Select the Start Menu folder... : ''AstronautUSB''
Line 16: Line 16:
 
The Astronaut client installer creates shortcuts in 3 different locations:
 
The Astronaut client installer creates shortcuts in 3 different locations:
  
* In a global Start menu folder (C:/ProgramData/Microsoft/Windows/Start Menu/Programs/''AstronautUSB''/ in Windows 7, for example)
+
* In a global Start menu folder (C:\ProgramData\Microsoft\Windows\Start Menu\Programs\''AstronautUSB''\ in Windows 7, for example)
* In a local Start menu folder (C:/Users/''yourWindowsusername''/AppData/Roaming/Microsoft/Windows/Start Menu/Programs/''AstronautUSB''/ in Windows 7, for example)
+
* In a local Start menu folder (C:\Users\''yourWindowsusername''\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\''AstronautUSB''\ in Windows 7, for example)
* On the local desktop (C:/Users/''yourWindowsusername''/Desktop/ in Windows 7, for example)
+
* On the local desktop (C:\Users\''yourWindowsusername''\Desktop\ in Windows 7, for example)
  
Copy (or move) the shortcuts from these 3 locations into the ''F:/Astronaut/'' folder on your USB drive. (Personally, I only copy the shortcuts from the global Start menu folder.)
+
Copy (or move) the shortcuts from these 3 locations into the ''F:\Astronaut\'' folder on your USB drive. (Personally, I only copy the shortcuts from the global Start menu folder.)
  
== Edit shortcuts as if for use in a protected environment ==
+
== Edit shortcuts ==
  
= Installing in a protected environment =
+
The Astronaut Client(s) on a USB drive ought not change the environment variables on the computer to which it is attached. Therefore, the startup shortcuts in the ''F:/Astronaut'' folder on the USB drive must be changed so that environment variables are not used.
You may wish to install the Astronaut client package on a Windows computer whose access is restricted to certain administrators. The method for doing so is to install Astronaut to the
 
C:\Documents and Settings\All Users\Application Data\VistA
 
folder on your Windows machine. This folder is generally not protected (or restricted to administrators) and can then be accessed by all users.
 
  
Environment variables may not be able to be changed on the computer by anyone other than an administrator. When installing without administrator privileges, the startup shortcuts must be changed so that environment variables are not used.
+
=== Change Astronaut SSH shortcut ===
 
 
== Change Astronaut SSH shortcut ==
 
 
The "Astronaut SSH" shortcut that is used to invoke the PuTTY SSH client uses a command line:
 
The "Astronaut SSH" shortcut that is used to invoke the PuTTY SSH client uses a command line:
  "C:\Program Files\VistA\Putty\putty.exe" -ssh -l %ASTRO_SSH_clientID% -pw %ASTRO_SSH_CLIENT_PASS% -L %ASTRO_PORT%:127.0.0.1:%ASTRO_PORT% %ASTRO_SSH_HOST%
+
  "F:\Astronaut\VistA\Putty\putty.exe" -ssh -l %ASTRO_SSH_clientID% -pw %ASTRO_SSH_CLIENT_PASS% -L %ASTRO_PORT%:127.0.0.1:%ASTRO_PORT% %ASTRO_SSH_HOST%
  
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
Line 39: Line 34:
 
* %ASTRO_SSH_CLIENT_PASS% -> ''not#1sostrong'' (this is the default value)
 
* %ASTRO_SSH_CLIENT_PASS% -> ''not#1sostrong'' (this is the default value)
 
* %ASTRO_PORT% -> 9260
 
* %ASTRO_PORT% -> 9260
* %ASTRO_SSH_HOST% -> ''192.168.56.101'' (use the IP address of the installed VistA server)
+
* %ASTRO_SSH_HOST% -> ''192.168.56.101'' (use the IP address or URL of the installed VistA server)
  
 
The revised Astronaut SSH shortcut would therefore be:
 
The revised Astronaut SSH shortcut would therefore be:
  "C:\Program Files\VistA\Putty\putty.exe" -ssh -l client9260 -pw not#1sostrong -L 9260:127.0.0.1:9260 192.168.56.101
+
  "F:\Astronaut\VistA\Putty\putty.exe" -ssh -l client9260 -pw not#1sostrong -L 9260:127.0.0.1:9260 192.168.56.101
  
== Change TMG-CPRS shortcut ==
+
=== Change TMG-CPRS shortcut ===
 
The "TMG-CPRS" shortcut that is used to invoke the CPRS client uses a command line:
 
The "TMG-CPRS" shortcut that is used to invoke the CPRS client uses a command line:
  "C:\Program Files\VistA\tmg-cprs\CPRSChart.exe" S=%ASTRO_LOCAL_HOST% P=9260 CCOW=DISABLE SPOOF-VER=%ASTRO_CPRS_SPOOF%
+
  "F:\Astronaut\VistA\tmg-cprs\CPRSChart.exe" S=%ASTRO_LOCAL_HOST% P=9260 CCOW=DISABLE SPOOF-VER=%ASTRO_CPRS_SPOOF%
  
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
Line 54: Line 49:
 
The revised TMG-CPRS shortcut would therefore be:
 
The revised TMG-CPRS shortcut would therefore be:
  
  "C:\Program Files\VistA\tmg-cprs\CPRSChart.exe" S=127.0.0.1 P=9260 CCOW=DISABLE SPOOF-VER=1.0.26.66
+
  "F:\Astronaut\VistA\tmg-cprs\CPRSChart.exe" S=127.0.0.1 P=9260 CCOW=DISABLE SPOOF-VER=1.0.26.66
  
== Change Text client shortcut ==
+
=== Change Text client shortcut ===
 
The "Text client" shortcut that is used to invoke the Text client uses a command line:
 
The "Text client" shortcut that is used to invoke the Text client uses a command line:
  "C:\Program Files\VistA\Putty\putty.exe" -P 22 %ASTRO_SSH_HOST% -l %ASTRO_textID% -pw %ASTRO_TEXT_PASS%
+
  "F:\Astronaut\VistA\Putty\putty.exe" -P 22 %ASTRO_SSH_HOST% -l %ASTRO_textID% -pw %ASTRO_TEXT_PASS%
  
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
 
* %ASTRO_textID% -> ''text9260'' (this is the default value)
 
* %ASTRO_textID% -> ''text9260'' (this is the default value)
 
* %ASTRO_TEXT_PASS% -> ''not#1sostrong'' (this is the default value)
 
* %ASTRO_TEXT_PASS% -> ''not#1sostrong'' (this is the default value)
* %ASTRO_SSH_HOST% -> ''192.168.56.101'' (use the IP address of the installed VistA server)
+
* %ASTRO_SSH_HOST% -> ''192.168.56.101'' (use the IP address or URL of the installed VistA server)
  
 
The revised Text client shortcut would therefore be:
 
The revised Text client shortcut would therefore be:
  
  "C:\Program Files\VistA\Putty\putty.exe" -P 22 192.168.56.101 -l text9260 -pw not#1sostrong
+
  "F:\Astronaut\VistA\Putty\putty.exe" -P 22 192.168.56.101 -l text9260 -pw not#1sostrong
  
== Change VistA Config shortcut ==
+
=== Change VistA Config shortcut ===
The "VistA Config" shortcut that is used to invoke the VistA user configuration utility uses a command line:
+
The "VistA Config" shortcut that is used to invoke the VistA user [[configuration~|Configuration]] utility uses a command line:
  "C:\Program Files\VistA\GUI_Config\GUI_Config.exe" S=%ASTRO_LOCAL_HOST% P=%ASTRO_PORT% CCOW=DISABLE
+
  "F:\Astronaut\VistA\GUI_Config\GUI_Config.exe" S=%ASTRO_LOCAL_HOST% P=%ASTRO_PORT% CCOW=DISABLE
  
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
Line 79: Line 74:
 
The revised VistA Config shortcut would therefore be:
 
The revised VistA Config shortcut would therefore be:
  
  "C:\Program Files\VistA\GUI_Config\GUI_Config.exe" S=127.0.0.1 P=9260 CCOW=DISABLE
+
  "F:\Astronaut\VistA\GUI_Config\GUI_Config.exe" S=127.0.0.1 P=9260 CCOW=DISABLE
  
== Change CPRS Query Tool shortcut ==
+
=== Change CPRS Query Tool shortcut ===
 
The "CPRS Query Tool" shortcut that is used to invoke the CPRS Query Tool uses a command line:
 
The "CPRS Query Tool" shortcut that is used to invoke the CPRS Query Tool uses a command line:
  "C:\Program Files\VistA\CPRS_Query_Tool\CPRSQuery.exe" S=%ASTRO_LOCAL_HOST% P=%ASTRO_PORT% CCOW=DISABLE
+
  "F:\Astronaut\VistA\CPRS_Query_Tool\CPRSQuery.exe" S=%ASTRO_LOCAL_HOST% P=%ASTRO_PORT% CCOW=DISABLE
  
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
 
The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:
Line 91: Line 86:
 
The revised CPRS Query Tool shortcut would therefore be:
 
The revised CPRS Query Tool shortcut would therefore be:
  
   "C:\Program Files\VistA\CPRS_Query_Tool\CPRSQuery.exe" S=127.0.0.1 P=9260 CCOW=DISABLE
+
   "F:\Astronaut\VistA\CPRS_Query_Tool\CPRSQuery.exe" S=127.0.0.1 P=9260 CCOW=DISABLE
  
== Change other client module shortcuts ==
+
=== Change other client module shortcuts ===
 
Don't forget to change the shortcuts for the other modules in a similar fashion:
 
Don't forget to change the shortcuts for the other modules in a similar fashion:
  
Line 102: Line 97:
 
* Vitals
 
* Vitals
 
* Vitals Manager
 
* Vitals Manager
 +
 +
== Using Astronaut CPRS on a USB drive in Linux ==
 +
TMG-CPRS is a Windows-compatible program and does not currently work well in Linux. However, a virtual machine (running Windows as a guest operating system) can be created with the Astronaut CPRS package installed on it. Such a virtual machine could be placed on a USB flash drive and run from any computer able to run the virtual machine. For example, if a VirtualBox virtual machine were created, that virtual machine could be run on any computer running the VirtualBox program.
 +
 +
For more details on accomplishing this, see [[Astronaut CPRS in Linux]].

Latest revision as of 20:58, 10 October 2012

A USB flashdrive is meant to be moved from one computer to the next, so environment variables will not be constant. To install the Astronaut CPRS client package and use it successfully from a USB flash drive, you will have to use the method for installing to a protected environment (i.e. edit all connection shortcuts to use specific values instead of environment variables).

Install Astronaut clients to the USB drive

In the example below, I will use a USB drive on F:

  • Create an Astronaut folder on your USB drive (e.g. F:\Astronaut\).
  • Run the Astronaut_clients installer. (Currently, this works best if the Astronaut_clients.x.x.x.x.exe installer program is located on (and run from) the hard drive, not the USB drive.)
  • Astronaut VistA Host Name or IP Address (use default if unsure): 192.168.0.73
Note: Use the IP address or URL of your own VistA server (or virtual machine containing the VistA server)
  • Choose Install Location: Destination Folder: F:\Astronaut\VistA
Note: Use the drive letter of your USB drive, of course.
  • Choose Start Menu Folder: Select the Start Menu folder... : AstronautUSB
Note: It is important to use a separate folder name (such as AstronautUSB) for the shortcut folder to distinguish it from the folder used for the Astronaut clients installed on the hard drive (because the shortcuts will all be different). Later these USB drive-oriented shortcuts will be copied to the USB drive itself.

Move shortcuts to USB Drive

The Astronaut client installer creates shortcuts in 3 different locations:

  • In a global Start menu folder (C:\ProgramData\Microsoft\Windows\Start Menu\Programs\AstronautUSB\ in Windows 7, for example)
  • In a local Start menu folder (C:\Users\yourWindowsusername\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\AstronautUSB\ in Windows 7, for example)
  • On the local desktop (C:\Users\yourWindowsusername\Desktop\ in Windows 7, for example)

Copy (or move) the shortcuts from these 3 locations into the F:\Astronaut\ folder on your USB drive. (Personally, I only copy the shortcuts from the global Start menu folder.)

Edit shortcuts

The Astronaut Client(s) on a USB drive ought not change the environment variables on the computer to which it is attached. Therefore, the startup shortcuts in the F:/Astronaut folder on the USB drive must be changed so that environment variables are not used.

Change Astronaut SSH shortcut

The "Astronaut SSH" shortcut that is used to invoke the PuTTY SSH client uses a command line:

"F:\Astronaut\VistA\Putty\putty.exe" -ssh -l %ASTRO_SSH_clientID% -pw %ASTRO_SSH_CLIENT_PASS% -L %ASTRO_PORT%:127.0.0.1:%ASTRO_PORT% %ASTRO_SSH_HOST%

The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:

  •  %ASTRO_SSH_clientID% -> client9260 (this is the default value)
  •  %ASTRO_SSH_CLIENT_PASS% -> not#1sostrong (this is the default value)
  •  %ASTRO_PORT% -> 9260
  •  %ASTRO_SSH_HOST% -> 192.168.56.101 (use the IP address or URL of the installed VistA server)

The revised Astronaut SSH shortcut would therefore be:

"F:\Astronaut\VistA\Putty\putty.exe" -ssh -l client9260 -pw not#1sostrong -L 9260:127.0.0.1:9260 192.168.56.101

Change TMG-CPRS shortcut

The "TMG-CPRS" shortcut that is used to invoke the CPRS client uses a command line:

"F:\Astronaut\VistA\tmg-cprs\CPRSChart.exe" S=%ASTRO_LOCAL_HOST% P=9260 CCOW=DISABLE SPOOF-VER=%ASTRO_CPRS_SPOOF%

The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:

  •  %ASTRO_LOCAL_HOST% -> 127.0.0.1
  •  %ASTRO_CPRS_SPOOF% -> 1.0.26.66 (this is the default)

The revised TMG-CPRS shortcut would therefore be:

"F:\Astronaut\VistA\tmg-cprs\CPRSChart.exe" S=127.0.0.1 P=9260 CCOW=DISABLE SPOOF-VER=1.0.26.66

Change Text client shortcut

The "Text client" shortcut that is used to invoke the Text client uses a command line:

"F:\Astronaut\VistA\Putty\putty.exe" -P 22 %ASTRO_SSH_HOST% -l %ASTRO_textID% -pw %ASTRO_TEXT_PASS%

The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:

  •  %ASTRO_textID% -> text9260 (this is the default value)
  •  %ASTRO_TEXT_PASS% -> not#1sostrong (this is the default value)
  •  %ASTRO_SSH_HOST% -> 192.168.56.101 (use the IP address or URL of the installed VistA server)

The revised Text client shortcut would therefore be:

"F:\Astronaut\VistA\Putty\putty.exe" -P 22 192.168.56.101 -l text9260 -pw not#1sostrong

Change VistA Config shortcut

The "VistA Config" shortcut that is used to invoke the VistA user Configuration utility uses a command line:

"F:\Astronaut\VistA\GUI_Config\GUI_Config.exe" S=%ASTRO_LOCAL_HOST% P=%ASTRO_PORT% CCOW=DISABLE

The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:

  •  %ASTRO_LOCAL_HOST% -> 127.0.0.1
  •  %ASTRO_PORT% -> 9260

The revised VistA Config shortcut would therefore be:

"F:\Astronaut\VistA\GUI_Config\GUI_Config.exe" S=127.0.0.1 P=9260 CCOW=DISABLE

Change CPRS Query Tool shortcut

The "CPRS Query Tool" shortcut that is used to invoke the CPRS Query Tool uses a command line:

"F:\Astronaut\VistA\CPRS_Query_Tool\CPRSQuery.exe" S=%ASTRO_LOCAL_HOST% P=%ASTRO_PORT% CCOW=DISABLE

The individual environment variables must be specified if you do not have privileges to specify environment variables. For example:

  •  %ASTRO_LOCAL_HOST% -> 127.0.0.1
  •  %ASTRO_PORT% -> 9260

The revised CPRS Query Tool shortcut would therefore be:

 "F:\Astronaut\VistA\CPRS_Query_Tool\CPRSQuery.exe" S=127.0.0.1 P=9260 CCOW=DISABLE

Change other client module shortcuts

Don't forget to change the shortcuts for the other modules in a similar fashion:

  • Group Notes
  • GUI Mail
  • Shift Handoff Tool
  • Admin
  • Vitals
  • Vitals Manager

Using Astronaut CPRS on a USB drive in Linux

TMG-CPRS is a Windows-compatible program and does not currently work well in Linux. However, a virtual machine (running Windows as a guest operating system) can be created with the Astronaut CPRS package installed on it. Such a virtual machine could be placed on a USB flash drive and run from any computer able to run the virtual machine. For example, if a VirtualBox virtual machine were created, that virtual machine could be run on any computer running the VirtualBox program.

For more details on accomplishing this, see Astronaut CPRS in Linux.