Difference between revisions of "RPMS Installation"

From VistApedia
Jump to: navigation, search
(RPMS Installation Instructions)
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
= RPMS Installation Instructions =
 
= RPMS Installation Instructions =
Written by Sam Habiel. I want to acknowledge Rick Pullen and Nancy
+
Written by [[User:Shabiel|Sam Habiel]]. I want to acknowledge Rick Pullen and Nancy Anthracite, who helped me put this together.
Anthracite, who helped me put this together.
 
  
For development use; consult a Vista Cache expert for production system set-up.
+
For development use; consult a Vista [[Cache]] expert for production system set-up. Optional steps marked with *.
Optional steps marked with *.
 
  
# Install Cache or Ensemble (lastest versions); answer no to the question that asks weather to put the key in now if you have the key as a file.
+
# Install [[Cache]] or Ensemble (lastest versions); answer no to the question that asks whether to put the key in now if you have the key as a file.
 
# In the Mgr directory, copy the key and make sure it's named cache.key
 
# In the Mgr directory, copy the key and make sure it's named cache.key
 +
# In the C:\Intersystems\[Cache or Ensemble]\mgr directory, make a subdirectory (let's call it rpms) for you database and place your RPMS cache.dat into that [rpms] directory.
 
# Log into the System Mangement Portal. Right-click on notification icon, choose that option, and if you set a password, log in
 
# Log into the System Mangement Portal. Right-click on notification icon, choose that option, and if you set a password, log in
# Home > Configuration > Advanced Settings
+
# Home > [[Configuration~|Configuration]] > Advanced Settings (newer Cache, different places, as below)
## IO
+
## IO ([[Configuration~|Configuration]] > Compatibility Settings)
 
##* <tt>Filemode = True</tt>
 
##* <tt>Filemode = True</tt>
 
##* <tt>Openmode = 1  for Read/Write</tt>
 
##* <tt>Openmode = 1  for Read/Write</tt>
## Memory
+
## Memory (Can't find in newest version of Cache, 2010)
 
##* <tt>GenericHeapSize = 10000.  More may be needed for shadowed systems.</tt>
 
##* <tt>GenericHeapSize = 10000.  More may be needed for shadowed systems.</tt>
 
##* <tt>ZFHEAP = 125000 (minimum).  May require more depending on software running and OS platform.</tt>
 
##* <tt>ZFHEAP = 125000 (minimum).  May require more depending on software running and OS platform.</tt>
## Miscellaneous
+
## Miscellaneous ([[Configuration~|Configuration]] > Startup Settings)
 
##* <tt>WebServerPort = 57772 (default) This can be changed and is the port number that the System Management Portal uses.</tt>
 
##* <tt>WebServerPort = 57772 (default) This can be changed and is the port number that the System Management Portal uses.</tt>
## ObjectScript
+
## ObjectScript ([[Configuration~|Configuration]] > Compatibility Settings)
 
##* <tt>Set ZEOF = True</tt>
 
##* <tt>Set ZEOF = True</tt>
## Telnet
+
## Telnet ([[Configuration~|Configuration]] > Device Settings > Telnet Settings)
 
##* <tt>DNSLookup = True (if DNS server is available).  Set to False if no DNS server available. Only affects Windows OS.</tt>
 
##* <tt>DNSLookup = True (if DNS server is available).  Set to False if no DNS server available. Only affects Windows OS.</tt>
## *Home > Configuration > Memory and Startup
+
## *Home > [[Configuration~|Configuration]] > Memory and Startup
 
##* <tt>Routine Cache: Min 50MB</tt>
 
##* <tt>Routine Cache: Min 50MB</tt>
 
##* <tt>Database Cache (8 KB): Min 1500MB. Leave 2 KB Cache at 0.</tt>
 
##* <tt>Database Cache (8 KB): Min 1500MB. Leave 2 KB Cache at 0.</tt>
# Create a blank database
+
# Create your database
## Configuration > Local Databases > Create New Database
+
## [[Configuration~|Configuration]] > Local Databases > Create New Database
## Give it a 2-5 letter name, and put in a directory with the same name
+
## Give it the same name you gave the mgr subdirectory (perhaps rpms) earlier in the process and choose that directory. When you click next, Cache or Ensemble should find the Cache,dat you placed in the mgr subdirectory you creaated. Accept using it. The database size will be set automatically.
## Size: 1MB
 
 
## Jounal: No
 
## Jounal: No
## Resource: %DB_%Default
 
 
# Create a namespace
 
# Create a namespace
## Configuration > Namespaces > Create New Namespace
+
## [[Configuration~|Configuration]] > Namespaces > Create New Namespace
 
## Give it the same name as your DB created in #4
 
## Give it the same name as your DB created in #4
 
## Map it to your DB
 
## Map it to your DB
Line 44: Line 41:
 
# *Home > Security Management > Services > Edit %Service_Telnet. Enable it and choose appropriate authentication.
 
# *Home > Security Management > Services > Edit %Service_Telnet. Enable it and choose appropriate authentication.
 
# *Home > Security Management > Resources > Edit %Development and enable it (only for systems on which development will be performed).
 
# *Home > Security Management > Resources > Edit %Development and enable it (only for systems on which development will be performed).
# Shutdown Cache/Ensemble, put your real CACHE.DAT in the folder, and start Cache/Ensemble again.
 
 
# *For databases migrated from Cache 5.0.x, recompile the routines and update database objects.
 
# *For databases migrated from Cache 5.0.x, recompile the routines and update database objects.
 
#* Enter Programmer Mode
 
#* Enter Programmer Mode
 
#* Go to your namespace
 
#* Go to your namespace
 
#* Execute the following:
 
#* Execute the following:
:: <tt>D ^%RCOMPIL</tt>
+
#** <tt>D ^%RCOMPIL</tt>
:: <tt>Routine(s): %*</tt>
+
#** <tt>Routine(s): %*</tt>
:: <tt>Routine(s): *</tt>
+
#** <tt>Routine(s): **</tt>
:: <tt>ZN "%SYS"</tt>  
+
#** <tt>ZN "%SYS"</tt>  
:: <tt> D $System.OBJ.UpgradeAll()</tt>
+
#** <tt>W $System.OBJ.UpgradeAll()</tt>
 
#* Go back to your namespace
 
#* Go back to your namespace
:: <tt>D RebuildIndex^%R("","",1)</tt>
+
#** <tt>D RebuildIndex^%R("","",1)</tt>
# In Programmer mode, D ^ZTMGRSET, choose OpenM for OS, and type your namespace on the three quetions, and rename fileman routines.
+
# In Programmer mode, [[ROUTINE ZTMGRSET|D ^ZTMGRSET]], choose OpenM for OS, and type your namespace on the three quetions, and rename fileman routines.
# Correct the Volume Set and Default HFS fields in the Kernel Systems Parameters file
+
# Correct the Volume Set and Primary HFS Directory fields in the [[FILE 8989.3 |Kernel Systems Parameters]] file
# Correct the Volume in Volume Set file
+
# Correct the Volume in [[FILE 14.5|Volume Set]] file
 
# Taskman Site Parameters need to be XXX:CACHE or XXX:ENSEMBLE or XXX:<INSTANCE NAME>
 
# Taskman Site Parameters need to be XXX:CACHE or XXX:ENSEMBLE or XXX:<INSTANCE NAME>
 
# Check the Mailman Site Params file for the correct entry in the below field: CPU (UCI,VOL) FOR FILER TO RUN: XXX,XXX
 
# Check the Mailman Site Params file for the correct entry in the below field: CPU (UCI,VOL) FOR FILER TO RUN: XXX,XXX
# Before you proceed, fix the volume set field for devices |TRM| and |TNT| or otherwise you won't be able to use fileman features.
+
# Before you proceed, fix the volume set field for devices |TRM| and |TNT| or otherwise you won't be able to use FileMan features.
# In Option Scheduling file, correct Volume field for tasks by stuffing the right one
+
# In [[FILE 19.2|Option Scheduling]] file, correct Volume field for tasks by stuffing the right one
# In Device File, correct Volume Set field also by stuffing
+
# In [[FILE 3.5|Device]] File, correct Volume Set field also by stuffing
# Kill ^%ZTSK and ^%ZTSCH. Reindex the Option Scheduling file (all indeces)
+
# Kill [[GLOBAL %ZTSK|^%ZTSK]] and [[GLOBAL %ZTSCH|^%ZTSCH]]. Reindex the Option Scheduling file (all indices)
17. Fix the RPMS Site file. Set OS to DOS
+
# Fix the RPMS Site file. Set OS to DOS
18. In CIA LISTENER file, correct UCI.
+
# In CIA LISTENER file, correct UCI.
19. In XUP, go to CIANB MAIN MENU, edit the CIA broker package parameters
+
# In XUP, go to [[OPTION CIANB MAIN MENU|CIANB MAIN MENU]], edit the CIA broker package parameters and remove old UCI and put new one.
  and remove old UCI and put new one.
+
# Start the listener.
20. Start the listner.
+
# In BMXMENU, edit all the ports to have a correct namespace, and then start all of them.
21. In BMXMENU, edit all the ports to have a correct namespace, and then
+
# In the portal, go to system services and enable telnet.
  start all of them.
+
# Go to XUP, and add yourself as a user.
22. In the portal, go to system services and enable telnet.
+
# Find your [[DUZ~|DUZ]]
23. Go to XUP, and add yourself as a user.
+
# Give yourself the "@"
24. Find your DUZ
+
# Assign yourself all the keys in the universe by [[ROUTINE AKMOSUSR|D ^AKMOSUSR]]
25. Give yourself the "@"
+
# Make a folder where your ehr client will reside. Share that folder with read access to all users.
26. Assign yourself all the keys in the universe by D ^AKMOSUSR
+
# Find lastest major version of EHR (currently 1.1) and double click on the exe and extract the files to folder you just created.
27. Make a folder where your ehr client will reside. Share that folder with
+
# In the resulting dialog, put the UNC path of the shared folder in the first box; in the last box, add /trace to enable tracing by default (for developers).
  read access to all users.
+
# Install EHR 1.1 patch 1
27. Find lastest major version of EHR (currently 1.1) and double click on
+
# Install EHR 1.1 patch 4. It contains the last license (the permanent one).
  the exe and extract the files to folder you just created.
+
# Edit the VueCentric Framework defaults. In [[ROUTINE XUP|XUP]], choose [[OPTION CIAV MANAGER|CIAV MANAGER]]
28. In the resulting dialog, put the UNC path of the shared folder in the
+
#* Choose site parameter edit
  first box; in the last box, add /trace to enable tracing by
+
#* Object source path is the UNC to your lib folder
default (for developers).
+
#* You may choose to change the default VueCentric Template now or later
29. Install EHR 1.1 patch 1
 
30. Install EHR 1.1 patch 4. It contains the last license (the permanent one).
 
31. Edit the VueCentric Framework defaults. In XUP, choose CIAV MANAGER
 
  - Choose site parameter edit
 
  - Object source path is the UNC to your bin folder
 
  - You may choose to change the default VueCentric Template now or later
 
  
 
Stuff to do later...
 
Stuff to do later...
 
There is so much set-up you can work on. Here are some things that are needed:
 
There is so much set-up you can work on. Here are some things that are needed:
1. *Add Mailman Domain; Christen; have Kernel point to it.
+
# *Add Mailman Domain; Christen; have Kernel point to it.
2. *Add Institution; Set-up Medical Center Division to point to it;
+
# *Add Institution; Set-up Medical Center Division to point to it; have Kernel point to default division.
have Kernel point to default division.
+
# *Setup Backup and Journalling in Cache/Ensemble.
3. *Setup Backup and Journalling in Cache/Ensemble.
 

Latest revision as of 01:34, 9 July 2014

RPMS Installation Instructions

Written by Sam Habiel. I want to acknowledge Rick Pullen and Nancy Anthracite, who helped me put this together.

For development use; consult a Vista Cache expert for production system set-up. Optional steps marked with *.

  1. Install Cache or Ensemble (lastest versions); answer no to the question that asks whether to put the key in now if you have the key as a file.
  2. In the Mgr directory, copy the key and make sure it's named cache.key
  3. In the C:\Intersystems\[Cache or Ensemble]\mgr directory, make a subdirectory (let's call it rpms) for you database and place your RPMS cache.dat into that [rpms] directory.
  4. Log into the System Mangement Portal. Right-click on notification icon, choose that option, and if you set a password, log in
  5. Home > Configuration > Advanced Settings (newer Cache, different places, as below)
    1. IO (Configuration > Compatibility Settings)
      • Filemode = True
      • Openmode = 1 for Read/Write
    2. Memory (Can't find in newest version of Cache, 2010)
      • GenericHeapSize = 10000. More may be needed for shadowed systems.
      • ZFHEAP = 125000 (minimum). May require more depending on software running and OS platform.
    3. Miscellaneous (Configuration > Startup Settings)
      • WebServerPort = 57772 (default) This can be changed and is the port number that the System Management Portal uses.
    4. ObjectScript (Configuration > Compatibility Settings)
      • Set ZEOF = True
    5. Telnet (Configuration > Device Settings > Telnet Settings)
      • DNSLookup = True (if DNS server is available). Set to False if no DNS server available. Only affects Windows OS.
    6. *Home > Configuration > Memory and Startup
      • Routine Cache: Min 50MB
      • Database Cache (8 KB): Min 1500MB. Leave 2 KB Cache at 0.
  6. Create your database
    1. Configuration > Local Databases > Create New Database
    2. Give it the same name you gave the mgr subdirectory (perhaps rpms) earlier in the process and choose that directory. When you click next, Cache or Ensemble should find the Cache,dat you placed in the mgr subdirectory you creaated. Accept using it. The database size will be set automatically.
    3. Jounal: No
  7. Create a namespace
    1. Configuration > Namespaces > Create New Namespace
    2. Give it the same name as your DB created in #4
    3. Map it to your DB
    4. Don't copy any mappings
  8. Create the mappings (Namespaces, Global Mappings and Routine Mappings)
    1. Globals: (%Z*, %z*) to your namespace; (UTILITY, TMP, TEMP, XTMP) to CACHETEMP
    2. Routines: %DT*, %HOSTCMD, %INET, %RCR, %Serenj*, %XB*, %XU*, %ZI*, %ZO*, %ZT*, %ZU*, %ZV*, %ZDEBUG
  9. *Home > Security Management > Users
    1. Add accounts. Copy from SuperUser. Add Password. Set Namespace. If this is intended for general use, set the routine to be ^ZU, otherwise, leave it blank.
  10. *Home > Security Management > CSP Applications > Edit /csp/sys (this portal). Uncheck unauthenticed and check password to allow only authenticated users to use the system management portal.
  11. *Home > Security Management > Services > Edit %Service_Telnet. Enable it and choose appropriate authentication.
  12. *Home > Security Management > Resources > Edit %Development and enable it (only for systems on which development will be performed).
  13. *For databases migrated from Cache 5.0.x, recompile the routines and update database objects.
    • Enter Programmer Mode
    • Go to your namespace
    • Execute the following:
      • D ^%RCOMPIL
      • Routine(s): %*
      • Routine(s): **
      • ZN "%SYS"
      • W $System.OBJ.UpgradeAll()
    • Go back to your namespace
      • D RebuildIndex^%R("","",1)
  14. In Programmer mode, D ^ZTMGRSET, choose OpenM for OS, and type your namespace on the three quetions, and rename fileman routines.
  15. Correct the Volume Set and Primary HFS Directory fields in the Kernel Systems Parameters file
  16. Correct the Volume in Volume Set file
  17. Taskman Site Parameters need to be XXX:CACHE or XXX:ENSEMBLE or XXX:<INSTANCE NAME>
  18. Check the Mailman Site Params file for the correct entry in the below field: CPU (UCI,VOL) FOR FILER TO RUN: XXX,XXX
  19. Before you proceed, fix the volume set field for devices |TRM| and |TNT| or otherwise you won't be able to use FileMan features.
  20. In Option Scheduling file, correct Volume field for tasks by stuffing the right one
  21. In Device File, correct Volume Set field also by stuffing
  22. Kill ^%ZTSK and ^%ZTSCH. Reindex the Option Scheduling file (all indices)
  23. Fix the RPMS Site file. Set OS to DOS
  24. In CIA LISTENER file, correct UCI.
  25. In XUP, go to CIANB MAIN MENU, edit the CIA broker package parameters and remove old UCI and put new one.
  26. Start the listener.
  27. In BMXMENU, edit all the ports to have a correct namespace, and then start all of them.
  28. In the portal, go to system services and enable telnet.
  29. Go to XUP, and add yourself as a user.
  30. Find your DUZ
  31. Give yourself the "@"
  32. Assign yourself all the keys in the universe by D ^AKMOSUSR
  33. Make a folder where your ehr client will reside. Share that folder with read access to all users.
  34. Find lastest major version of EHR (currently 1.1) and double click on the exe and extract the files to folder you just created.
  35. In the resulting dialog, put the UNC path of the shared folder in the first box; in the last box, add /trace to enable tracing by default (for developers).
  36. Install EHR 1.1 patch 1
  37. Install EHR 1.1 patch 4. It contains the last license (the permanent one).
  38. Edit the VueCentric Framework defaults. In XUP, choose CIAV MANAGER
    • Choose site parameter edit
    • Object source path is the UNC to your lib folder
    • You may choose to change the default VueCentric Template now or later

Stuff to do later... There is so much set-up you can work on. Here are some things that are needed:

  1. *Add Mailman Domain; Christen; have Kernel point to it.
  2. *Add Institution; Set-up Medical Center Division to point to it; have Kernel point to default division.
  3. *Setup Backup and Journalling in Cache/Ensemble.