SCI APPLICATIONS SERVER. Transaction Log (D:) Raid 5

Transcription

1 SCI APPLICATIONS Sci Applications Server The directory structure below shows the recommended setup of the server for each individual hospital. Each application/store server should be part of a domain to allow installation of SMS for remote access. The applications, database and transaction logs should be separated across three drives to increase fault tolerance and improve disk performance. SERVER Operating System Windows NT 4.0 Service Pack 6a (C:) Raid 1 Transaction Log (D:) Raid 5 Database (E:) Raid 5 BDE Installation C:\Program Files\NHS Scotland\BDE Installation SQL Server 7.0 (SP 2) C:\MSSQL7 SCI Servers C:\Program Files\NHS Scotland\SCI Server Letters C:\Program Files\NHS Scotland\Letters Encryption Module C:\Program Files\NHS Scotland\XPENCRYPT Sci C:\Program Files\NHS Scotland\Sci IMPORTANT!! Regional settings should be set to UK Software is installed as standard on each server as described Server Monitoring Windows NT The database and transaction log on the hard drive needs to be monitored regularly to ensure there is adequate disc capacity for growth of the database. NT Services - All standard NT services, SQL Server, and SQL Server Agent should be set to start automatically on startup. The Microsoft Distributed Transaction Co-ordinator (MSDTC) should not be started. 1

2 Configuration of SCI Server Broadcaster At The Sci Applications Server If the SCI Server Broadcaster requires to set up for a new database or to be refreshed after an upgrade follow the instructions below below: Stop the SCI Server Broadcaster Service. Change the start-up parameters, ticking allow Service to Interact with Desktop. Start the SCI Server Broadcaster Service. 1. Stop the Sci Server Broadcaster Service by click on start settings control panel services 2. Change the start-up parameter, ticking Allow service to Interact with Desktop 3. Start the Sci Broadcaster Service 4. Select the databases and versions you wish to broadcast. 5. Close the Broadcaster window, replying yes to the warning message. 2. Change the start-up parameters, un-ticking Allow Service to Interact with Desktop. 3. Start the SCI Server Broadcaster service again. Sci Broadcaster allows SCI clients to access a SCI OPMS Server database without having the clients BDE be configured to use that database directly. 2

3 SQL Server Configuration If SQL Server is running on a dual processor, SQL Server should be set to run on both processors, but not to use parallel queries, due to a bug in SQL Server. The System Administrator (sa) password should be changed from the default of blank. ANSI Nulls default and select into / bulk copy must be enabled in sci_live, sci_training, sci_testing and tempdb o To check Click on Start Programs Microsoft SQL Server 7.0 Enterprise Manager, Expand SQL Server Group, Expand Server Right Click on Sci_live and select properties and click on options tab and ensure the above options are enabled. Check that Sci_training and tempdb also have their options checked. The SCI Applications database will be scheduled to be backed up each night to the hard disc at installation (the time of the backup will be discussed with the IT department). The trust is responsible for ensuring that the daily backup is checked regularly and included in the system backup process to tape to enable recovery in event of failure. Disaster Recovery Procedures is the responsibility of individual trusts. The following jobs will be set up on the SCI Applications server and should be checked regularly (weekly) to ensure that they are running. Nightly Maintenance every night at 2 am Update instance counts every 5 minutes Truncate bulk moves every month 3

4 To View Jobs click on start programs Microsoft SQL Server 7.0 Enterprise manager Expand SQL Server Group SCI Applications Server Management SQL Server Agent and highlight jobs to view scheduled tasks set up Verifying a Job Highlight the Nightly Maintenance job and double-click on it to bring up the properties for the job, and then open the Schedules tab. This will indicate when the job is normally performed. If you want to view details to see if the Job has run, right click on the job e.g. Nightly Maintenance and click View Job History 4

5 SCI Store Server Monitoring The interfaces between SCI Outpatients and SCI Store should be checked daily on the SCI Store Server and restarted weekly to refresh data. Stop/Start the OPMS/Compas interface by double clicking on the ebiz opms interface shortcut located on the desktop The Interface allows updates of patient demographic information from Compas/Sci Store to the SCI Applications Database NOTE: If the SA password is changed on the SCI Applications server the Replicatepatient.ini located on the SCI Store server (C:\Program Files\ReplicatePatient ) will have to be edited to allow the interface to connect with SCI Applications Server 5

6 Client Configuration Operating system should be Windows NT Version 4.0 or Windows 2000 Regional settings must be set to UK (If not this will affect appointments) A default printer must be installed for printing letters. Microsoft word 97/2000 must be installed to allow letters to be attached to clinics. SQL Client Tools must be installed on a client machine that will perform the updates of ISD reference files. Installation of Sci Client should be located in C:\Program Files\NHS Scotland\Sci If the broadcaster service is not being used the BDE will require to be set up on individual machines to connect to the SCI_live, SCI_training and SCI_testing database 6

7 Setting Up the BDE On the Client machine click on start settings control panel BDE administrator Expand database and highlight SCI. Check that the correct DataBase Name, Server Name and User Name are entered as parameters Click the Blue arrow to apply and save changes 7

8 Applying the Alias Create a shortcut on the desktop to point to C:\Program files\nhs Scotland\Sci\Sci.exe Rename the shortcut SCI_live (or SCI_Training depending on the database) When the shortcut is created right click on SCI_live and select properties Click the shortcut tab and enter /a sci into the target field Click OK when finished and test logging onto the database SCI Outpatients Configuration Prior to use of SCI Applications users require logins/capabilities/groups/permissions set up via User Admin tools Clinic Templates require to be set up for individual clinics (This is Particularly important that this is done prior to data being migrated from Topas) The Reschedular rules need to be set up correctly. (See APPENDIX A) The pool should not be used as a store for appointments, but as a temporary holding place. It should be kept clear as far as possible Slots can be set to suppress letters. Users must be aware of these features. Letters should be set up and assigned to clinics 8

9 Troubleshooting and diagnostic aids VERSION IDENTIFICATION Selecting Help About menu in the SCI OPMS client will show the version of the database. This information is also visible in the title bar on the client. To access version information from the database run the query below: Select * from tbl_system_constants where constant_name = BuildNumber Right clicking on the SCI executable will provide the version number for the client. BUG REPORTS When an application error occurs information is captured that can help the support team fix the problem. These should be saved and mailed to support staff. For security reasons, not all users have the capability to see bug reports. To enable detailed capturing of information give the user See bug reports capability. ERROR MESSAGES Exception Unable to insert a NULL error If the application complains about this error it is a symptom of not being able to insert null values into temporary tables. Tempdb needs to be setup to accept ANSI NULLS. To do this, right mouse click on TempDB and select properties. In the options Tab, ensure that checkbox ANSI Nulls Default is checked. You must restart SQL Server for it to take effect. Exception UpdateText WITH NO LOG is not valid at this time? whilst trying to save letters This is a symptom of the main database having incorrect options set. Database should have Select into/bulk copy option set. 9

10 Exception Unable to find master..xp_encrypt / master..xp_decrypt whilst logging in You need to install the xp_encrypt.dll on the server that you are accessing. Refer to the installation instructions in this document. Make sure that the extended stored procedures are using the correct encryption library. The following script can check this. Use master sp_helptext xp_encrypt GO sp_helptext xp_decrypt GO The output should be the location of the encryption library (C:\program files\nhs Scotland\XPENCRYPT by default) Exception Cannot find table whilst loading or importing postcodes or running SMR reports You have created a new user role or are using SA in your BDE. You must use a user with membership of SCI_USER_ROLE. Tables are being renamed and user needs to be logged in correctly. Exception - Insufficient SQL rights for operation. EXECUTE permission denied on object 'spr_authenticate_user', database 'SCI', owner 'dbo'. Run spr_grant_permissions on the database that you are accessing. This needs to be rerun when stored procedures are (re) created. The user SCI_USER needs to be given access rights to the new stored proc. You have locked the admin user out of the application Log into the server using the SA user and run the command delete from tbl_failed_logins where user = admin and spr_logoff_user admin 10

11 User locked out of Application Already logged On If a user tries to logon to the SCI Application and they get an error messages telling them they are already logged on you can open an isql window (ensuring the correct database is selected and run spr_logoff_user admin The application complains that a date is not valid This is a run time problem. It is caused by the Regional Settings of the PC having a US date format. In Windows 2000, you can select the region to be United Kingdom but still have a US format. To change this, go to the Date tab and modify the explicit format to be dd/mm/yyyy. There are spurious slot change errors This is a result of not running the nightly maintenance job. Ensure all users are logged of the system and then run spr_nightly_maintenance from a query analyser window. 11

12 Rescheduler rules APPENDIX A Rescheduler Rule Parameter 1 Parameter 2 Parameter 3 Same Time Same Class Min Moves = 3 Same Time Same Class Min Moves = 2 Same Time Same Class Min Moves = 1 Same Time Same Class Min Moves = 0 Delta Time Same Class Minutes = 10 Letter = 0 Min Moves = 3 Delta Time Same Class Minutes = -10 Letter = 0 Min Moves = 3 Delta Time Same Class Minutes = 120 Letter = 1 Min Moves = 3 Delta Time Same Class Minutes = -120 Letter = 1 Min Moves = 3 Delta Time Same Class Minutes = 10 Letter = 0 Min Moves = 2 Delta Time Same Class Minutes = -10 Letter = 0 Min Moves = 2 Delta Time Same Class Minutes = 120 Letter = 1 Min Moves = 2 Delta Time Same Class Minutes = -120 Letter = 1 Min Moves = 2 Delta Time Same Class Minutes = 10 Letter = 0 Min Moves = 1 Delta Time Same Class Minutes = -10 Letter = 0 Min Moves = 1 Delta Time Same Class Minutes = 120 Letter = 1 Min Moves = 1 Delta Time Same Class Minutes = -120 Letter = 1 Min Moves = 1 Delta Time Same Class Minutes = 10 Letter = 0 Min Moves = 0 Delta Time Same Class Minutes = -10 Letter = 0 Min Moves = 0 Delta Time Same Class Minutes = 120 Letter = 1 Min Moves = 0 Delta Time Same Class Minutes = -120 Letter = 1 Min Moves = 0 Different Day Same Class Days = -8 Letter = 1 Min Moves = 3 Different Day Same Class Days = 7 Letter = 1 Min Moves = 3 Different Day Same Class Days = 14 Letter = 1 Min Moves = 3 Different Day Same Class Days = 21 Letter = 1 Min Moves = 3 Different Day Same Class Days = 28 Letter = 1 Min Moves = 3 Different Day Same Class Days = -8 Letter = 1 Min Moves = 2 Different Day Same Class Days = 7 Letter = 1 Min Moves = 2 Different Day Same Class Days = 14 Letter = 1 Min Moves = 2 Different Day Same Class Days = 21 Letter = 1 Min Moves = 2 Different Day Same Class Days = 28 Letter = 1 Min Moves = 2 Different Day Same Class Days = -8 Letter = 1 Min Moves = 1 Different Day Same Class Days = 7 Letter = 1 Min Moves = 1 Different Day Same Class Days = 14 Letter = 1 Min Moves = 1 Different Day Same Class Days = 21 Letter = 1 Min Moves = 1 Different Day Same Class Days = 28 Letter = 1 Min Moves = 1 Different Day Same Class Days = -8 Letter = 1 Min Moves = 0 Different Day Same Class Days = 7 Letter = 1 Min Moves = 0 Different Day Same Class Days = 14 Letter = 1 Min Moves = 0 Different Day Same Class Days = 21 Letter = 1 Min Moves = 0 Different Day Same Class Days = 28 Letter = 1 Min Moves = 0 12

13 APPENDIX 1 LETTER FIELDS Description Our Reference First Name Last Name CHI CRN NHS Title Sex Marital Status Date of Birth Address1 Address2 Address3 Postcode Consultant Name Slot Length Slot Date Clinic Code Clinic Location Start Time Premise Name Old Slot Length Old Slot Date Old Clinic Code Old Start Time Old Premise Name Field Code <#our ref#> <#First Name#> <#Last Name#> <#CHI#> <#CRN#> <#NHS#> <#Title#> <#Sex#> <#Marital Status#> <#Date of Birth#> <#address1#> <#address2#> <#address3#> <#postcode#> <#consultant name#> <#slot length#> <#Slot Date#> <#Clinic Code#> <#location#> <#Start Time#> <#Premise Name#> <#Old slot length#> <#Old Slot Date#> <#Old Clinic Code#> <#Old Start Time#> <#Old Premise Name#> 13