CONVERTING FROM NETKEEPER ISAM v6.32 to NETKEEPER SQL

Transcription

1 Download and install the NetKeeper ISAM to SQL converter program. To download the Converter program go to: Scroll down the page until you find a link that says: Start download NetKeeper HD Captain 6.32 to NK HD SQL 7 Click on the link to download the NKCNV632.EXE setup and installation file to your computer. Record the folder where you placed the downloaded file. Run and install the conversion program. Open Windows Explorer and double click on the NKCNV632.EXE downloaded file to install the converter program. The NetKeeper ISAM programs are NetKeeper programs that use files served from a file server. This is the source data for the conversion. The ISAM files will be converted into SQL tables on your Microsoft SQL Server database. The conversion program works with any version of Microsoft SQL 7 or higher. Always scan for viruses any file downloaded from the Internet, even from safe sites. Install the converter program to its own folder, do not install in an existing folder. The NKCNV632.EXE setup file will install CONVERT.EXE and several SQL script files. Check that your NetKeeper Help Desk Captain database is version v6.32 or higher. Upgrade if necessary. Check that your NetKeeper database is not damaged and does not include duplicate records. Run the CSRT utility on your main tables if necessary. To run CSRT: Open a DOS window Navigate to the NetKeeper directory At the prompt type: CSRT <tablename> Where <tablename> is the name of the table Example: CSRT SCMNK The CSRT utility should complete without errors. NetKeeper is a Registered Trademark of Multima Corporation -- Page 1

2 Start the MS SQL Enterprise Manager program. Enterprise Manager is the main administrative tool in MS SQL Server. Use your MS SQL CD to install the MS SQL Enterprise Manager utility. Create the NetKeeper database on your Microsoft SQL server. (NetKeeper requires MS SQL server v 7.0 or above) Start with a fresh database created just for this purpose. Do not use a test database that you may have created previously. Using an existing database may result in an incorrect database layout. To Create the database: Right mouse click on the DATABASE object in Enterprise Manager. Click New Database NetKeeper is a Registered Trademark of Multima Corporation -- Page 2

3 Name the new database NetKeeper You can name your database any name you want but we suggest that you use NetKeeper Accept all the other defaults that MS SQL suggests in the Database Properties dialog. Click OK to create the new database. The new NetKeeper database is now displayed in the Enterprise Manager DATABASE tree. Click on the + to expand the database tree if necessary. The new NetKeeper database is ready for use. Delete and recreate the NetKeeper database if something does not look right or the database is damaged during the conversion. Backup your existing ISAM NetKeeper Help Desk Program and data. This is a precaution; you just can t have too many backups! In any case, you will be working with a COPY of your working data. NetKeeper is a Registered Trademark of Multima Corporation -- Page 3

4 Make a temporary copy of your NetKeeper Help Desk Captain directory. Use the Windows Explorer to make a copy of the entire NetKeeper directory that holds your existing program and data. Use the COPY as the source directory for the conversion program to avoid any problems with your original data. Start the Microsoft SQL Server Query Analyzer and select NetKeeper as the database in the DB window. The Microsoft SQL Server Query Analyzer will be used to run a series of commands (a SQL script) that will create the database layout and settings required by NetKeeper. Experienced SQL users can modify the scripts to suit special needs but normally the scripts are used without modifications. NetKeeper is a Registered Trademark of Multima Corporation -- Page 4

5 Click on the Load SQL Script button and load the nkdct2.sql script from the Converter folder. The Converter folder is the folder where you installed the CONVERT.EXE program from the file downloaded from the Internet. Double check that you are using the nkdct2.sql script from the Converter folder and not from any other folder. Using the wrong version of nkdct2.sql may results in errors in later steps of the data conversion. Double check that the NetKeeper database is selected as the default database in the DB box. Running a script on the wrong database can erase or damage existing databases! Damaging someone else s data is a good way to ruin a friendship. Click the EXECUTE QUERY button to run the SQL script. The nkdct2.sql script will create the basic table layouts in the NetKeeper Database. The SQL script should complete without errors. NetKeeper is a Registered Trademark of Multima Corporation -- Page 5

6 Click on the Load SQL Script button and load the guidtrig.sql script from the Converter folder. Click the EXECUTE QUERY button to run the SQL script. Run the CONVERT.EXE program to convert your existing data into the SQL database. To run the CONVERT.EXE program: Run Windows Explorer and find the CONVERT.EXE program. Double check that you are using the guidtrig.sql script from the Converter Folder and not from any other folder. The SQL script should complete without errors. The error CREATE UNIQUE ERROR terminated because a duplicate key was found usually indicates that the GUID field is blank or filled with blanks. The field should on contain a NULL before running the script. This condition is usually due to a nonempty database. Delete and recreate the NetKeeper database to correct this problem. The CONVERT.EXE program was installed in a previous step using the file downloaded from the Internet. NetKeeper is a Registered Trademark of Multima Corporation -- Page 6

7 Double click on the CONVERT.EXE program to run the program. Press the SPACE bar to deselect / reselect a file to convert. This is useful if a source file is damaged and will not convert. You can re-run the CONVERT.EXE program and convert just one file but you must first make sure that the matching table is empty in your SQL database. Use the SQL TRUNCATE TABLE command to empty a SQL table. TRUNCATE TABLE (T-SQL) Click Select All Files to convert all files. This is the default. Removes all rows from a table without logging the individual row deletes. Syntax TRUNCATE TABLE name Arguments name Is the name of the table to truncate or remove all rows from. Click Start the conversion to initiate the data conversion. Confirm that you did backup your datafiles (and your program files) to proceed. Do not interrupt the conversion process. Delete and re-create the NetKeeper database, then redo the conversion if the conversion process is interrupted. NetKeeper is a Registered Trademark of Multima Corporation -- Page 7

8 Select the NetKeeper Captain data source directory (folder) The Captain data source is the directory (folder) containing the COPY of your original NetKeeper data. Login to SQL server The conversion will not work if you don t have the correct rights into the MS SQL Server database. Login with administrator rights to insure that the conversion process can create and modify database objects. Wait until the CONVERT.EXE program ends The CONVERT.EXE will convert file by file and populate the SQL database tables. The top of the dialog indicates which file is being converted. Once CONVERT.EXE is done your data is now in the SQL database. All that remains to be done is bring the SQL database to the current release layout. NetKeeper is a Registered Trademark of Multima Corporation -- Page 8

9 Create a full-text catalog server for your database. The NetKeeper database is fully text indexed. A text server must be created in SQL Server to maintain the text index. To create thefull-text catalog: Open MS SQL Enterprise Manager Expand the DATABASE object until you can see the NETKEEPER database The full-text catalog server is a separate service that also needs to be defined before it is available for use. Right mouse click on the Full-Text Catalog object in the NetKeeper database object. Right click on an object always displays the available actions for the object. NetKeeper is a Registered Trademark of Multima Corporation -- Page 9

10 Click NEW FULL-TEXT CATALOG to create a new Full-Text catalog. Name the new Full-Text Catalog NetKeeper_Text You can also define when and how the Full-Text Catalog will be populated. The Full-Text Catalog will be empty until you build the catalog, this is not an automatic process and needs to be repeated periodically of the Full-Text Catalog will be empty or out-of-date. Click OK to create the Full-Text Catalog Click on the Load SQL Script button and load the nkcvt702.sql script from the Converter folder. MAKE SURE THAT THE NETKEEPER DATABASE IS SELECTED IN THE DB BOX Click the EXECUTE QUERY button to run the SQL script. Double check that you are using the nkcvt702.sql script from the Converter Folder and not from any other folder. Double check that the NetKeeper database is selected as the default database in the DB box. Running a script on the wrong database can erase or damage existing databases! Damaging someone else s data is a good way to ruin a friendship. The script should complete without errors. The database is now ready for use and at revision level 7.02 Backup your new database. Always a good idea to backup your converted SQL database. NetKeeper is a Registered Trademark of Multima Corporation -- Page 10

11 Install your new NetKeeper Help Desk or NetKeeper CRM software and run the NetKeeper Console program. Optional: Convert to a level above v7.02 The conversion program and the conversion scripts will convert your ISAM NetKeeper Help Desk data to SQL NetKeeper Help Desk version You need to run additional scripts if your new NetKeeper Help Desk or NetKeeper CRM program s version is higher than 7.02 See the Installation section of the software and the readme.txt file for additional upgrade information. Don t run the database creation scripts per the installation instructions since you have already created the database. The database layout must match the data requirements of the program or the program will return error 47 Mismatched database. You don t have to run other scripts if your NetKeeper software version is 7.02 To convert to a higher level run the SQL conversion scripts supplied with your version of NetKeeper Software. The scripts will be located in the SQLscrpt folder of the NetKeeper SQL software folder. NetKeeper is a Registered Trademark of Multima Corporation -- Page 11