Layton ServiceDesk - Procedures - General - Sending your Database to Support
m (Minor formatting changes) |
(Added SQL Server script) |
||
Line 36: | Line 36: | ||
==Optional: Database Without End-User and Analyst Details== | ==Optional: Database Without End-User and Analyst Details== | ||
− | + | Support may indicate that it may be necessary to test with End-User and/or Analyst user names, but you don't want to send personal details like phone numbers, email address and physical address. This SQL Server script will strip these out prior to backing up. Do this on a copy of the database. | |
+ | |||
+ | UPDATE euser | ||
+ | SET sys_phone = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_fax = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_email = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_euserpwd = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_cont_startdate = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_cont_enddate = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_mobile = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_addstreet1 = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_addstreet2 = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_addsuburb = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_addstate = NULL | ||
+ | |||
+ | UPDATE euser | ||
+ | SET sys_addpostcode = NULL | ||
+ | |||
+ | UPDATE [user] | ||
+ | SET sys_email = NULL | ||
+ | |||
+ | UPDATE [user] | ||
+ | SET sys_escalate1email = NULL | ||
+ | |||
+ | UPDATE [user] | ||
+ | SET sys_escalate2email = NULL | ||
+ | |||
+ | UPDATE [user] | ||
+ | SET sys_escalate3email = NULL | ||
+ | |||
+ | UPDATE [user] | ||
+ | SET sys_resolveemail = NULL | ||
+ | |||
+ | UPDATE [user] | ||
+ | SET sys_respondemail = NULL | ||
+ | |||
+ | UPDATE [user] | ||
+ | SET sys_userpwd = NULL | ||
=Prepare File for Upload= | =Prepare File for Upload= |
Revision as of 00:26, 3 December 2020
Contents |
Overview
On occasion, Support may need to examine your database to understand the cause of an issue or to repair your database. There is a preparatory procedure, and two different procedures depending on whether you will be sending the whole database or the database without Requests.
Preparatory Steps
Gather Information About the Database
Collect the following information for later use:
- The application version of your installation of Layton ServiceDesk.
- The version of SQL Server you are using.
- The password for the built-in admin account. If you have security concerns about sending the database with the admin password, change it prior to backup and sending.
Create Database Backup
- Use SQL Server Management Studio (SSMS) to back up the SQL database to a .bak file. Note the following settings:
Preparing the Database for Sending
Complete Database
In most instances, you will be sending the complete database. In this case, you can skip to step Prepare File for Upload.
Optional: Database Without Requests
If there is a security concern regarding the contents of the database, you can strip out all the Requests prior to sending.
1. In Management Studio, restore the database backup you just made, with a different name, in order to produce a copy.
2. In Management Studio, on the database copy, run this query to set the status of every Request to Closed:
UPDATE request SET sys_requeststatus = 0
3. Preferably, in your test Layton ServiceDesk installation, or if you don't have one, your live installation (this will be disruptive to anyone using the system, so do it when users are offline), launch DBTool to Connect to Existing Database. This will connect Layton ServiceDesk to the database copy.
4. Launch Layton ServiceDesk and purge all closed Requests per this procedure.
5. In Layton ServiceDesk, check that there are no Requests. If you want to do this in Management Studio, use this query. The result should be 0:
SELECT COUNT(sys_request_id) FROM request
Optional: Database Without End-User and Analyst Details
Support may indicate that it may be necessary to test with End-User and/or Analyst user names, but you don't want to send personal details like phone numbers, email address and physical address. This SQL Server script will strip these out prior to backing up. Do this on a copy of the database.
UPDATE euser SET sys_phone = NULL UPDATE euser SET sys_fax = NULL UPDATE euser SET sys_email = NULL UPDATE euser SET sys_euserpwd = NULL UPDATE euser SET sys_cont_startdate = NULL UPDATE euser SET sys_cont_enddate = NULL UPDATE euser SET sys_mobile = NULL UPDATE euser SET sys_addstreet1 = NULL UPDATE euser SET sys_addstreet2 = NULL UPDATE euser SET sys_addsuburb = NULL UPDATE euser SET sys_addstate = NULL UPDATE euser SET sys_addpostcode = NULL
UPDATE [user] SET sys_email = NULL UPDATE [user] SET sys_escalate1email = NULL UPDATE [user] SET sys_escalate2email = NULL UPDATE [user] SET sys_escalate3email = NULL UPDATE [user] SET sys_resolveemail = NULL UPDATE [user] SET sys_respondemail = NULL UPDATE [user] SET sys_userpwd = NULL
Prepare File for Upload
Rename the Backup File
Please use this naming convention for the backup file:
lsd_VERSION_sqlVERSION_YEARMONTHDAY.bak
For example, if you were backing up a version 6.6.8 database running on SQL Server 2008 R2 on 23 Mar. 2017, the resultant filename would be:
lsd_668_sql2008r2_20170323.bak
Optional: Encrypt the Backup File
If you are concerned about the security of the backup file, encrypt it in a zip file using a tool like 7-Zip and send the password via direct email to Support
Zip the Backup File
Important! You must zip the file before sending to greatly reduce its size.
Send the Database
Send the .zip file to Support via our secure upload service.