1 FaxCore Ev5 - Database Migration Guide :: Microsoft SQL 2008 Edition Version 1.0.0 FaxCore Ev5 Database Migration Guide :: Microsoft SQL 2008 Edition
2 FaxCore Ev5 - Database Migration Guide :: Microsoft SQL 2008 Edition Contents The Database Migration Guide - SQL 2008 Edition... 3 SQL Server Management Studio - Express Edition/Standard Edition... 3 Detaching The Database... 3 Attaching The Database... 4 Remapping The FaxCore Web Application... 5
3 FaxCore Ev5 - Database Migration Guide :: Microsoft SQL 2008 Edition The Database Migration Guide - SQL 2008 Edition This chapter describes the method available to migrate your production FaxCore database from the fax server to a Microsoft SQL server of your choice. SQL Server Management Studio - Express Edition/Standard Edition WARNING! Prior to carrying out the following migration exercise, please ensure that you have a full and recent backup of your FaxCore database. Note: Before attempting the following steps below, please contact FaxCore Support to obtain the required FaxCore database login credentials to facilitate the database restoring process and when migrating the FaxCore database to a server running a later version of Microsoft SQL, you will lose the ability to re-host the database on any other server running Microsoft SQL which is of an older version. Detaching The Database 1. Launch the Microsoft Services Management Console on the fax server and proceed to stop the following FaxCore services: FXC3.Dispatcher, FXC3.FaxAgent, FXC3.Gateway, FXC3.PrintService, FXC3.RenderAgent and FXC3.SMTPGateway. 2. Next, launch the Microsoft Command Prompt and execute the following command: iisreset /stop which stops all IIS related services on the fax server: IIS Admin Service, WWW Service, HTTP Service, FTP Service, SMTP Service and NNTP Service. 3. Launch the SQL Management Studio utility on your fax server and authenticate yourself by providing the required credentials to establish a connection to the FaxCore database server. 4. Upon successfully authenticating, expand the Databases folder from within the object explorer panel to display the list of hosted database. 5. Right click your FaxCore database and select Properties to view its configurable parameters and database file attributes. 6. Select the Files page and identify the location of each FaxCore database and log files as these would need to be copied to the SQL server that you intend to host the FaxCore database from. Once the location of the files have been identified, click Cancel to dismiss the database property window including any changes that you may have accidentally made. 7. Right click your FaxCore database and select Tasks > Detach to launch the Detach Database window and from there, select the General page and check the Drop Connection option followed by clicking OK to detach the database from the SQL service. Figure 1.0.0 - Database Properties Window Figure 2.0.0 - Detach Database Window
4 FaxCore Ev5 - Database Migration Guide :: Microsoft SQL 2008 Edition 8. Browse to the directory where your FaxCore database and log files reside and copy them to the Microsoft SQL server that will be hosting them from this point onwards. Attaching The Database 1. Launch the SQL Management Studio utility on your Microsoft SQL server and authenticate yourself by providing the required credentials to establish a connection to your Microsoft SQL database server. 2. Upon successfully authenticating, right click the Databases folder and select Attach to launch the Attach Database window and at the Databases To Attach subsection, click Add and browse to the directory where the FaxCore database files and logs are located and select the primary MDF file. 3. Once the primary file is selected, the Database Details subsection will be populated with the list of files and logs associated with the MDF file. Click OK to attach the files to your SQL server. 4. Next, from within your object explorer panel, expand the restored Faxcore database and browse the Security > Users subdirectory and proceed to delete the following user: fxc_admin 5. Next, from within you object explorer panel, right click the SQL instance s Security > Logins subdirectory and select New Login to display the Login - New window. Figure 3.0.0 - Attach Database Window Figure 4.0.0 - Login-New General Page Window 6. Select the General page to create an account utilizing the credentials obtained from FaxCore support. Ensure the Enforce Password Policy option is unchecked and Default Database option is mapped to the restored database. 7. Select the User Mapping page and map the user account to the restored FaxCore database. Ensure the Database Role Membership for the user account is as follow: public & db_owner and click OK to begin creating the user account. 8. Lastly, from within your object explorer panel, expand the restored FaxCore database and browse the Security > User subdirectory and proceed to double-click the following user: fxc_admin to display its account properties. 9. Select the General page and under the Database Role Membership option, ensure db_owner is checked and click OK to complete the database mapping process.
5 FaxCore Ev5 - Database Migration Guide :: Microsoft SQL 2008 Edition Figure 5.0.0 - Login-New User Mapping Window Figure 6.0.0 - Database Role Mapping Window Remapping The FaxCore Web Application 1. On the fax server, browse to the FaxCore installation directory and under the web directory; edit the web.config file with a text editor. 2. Locate the following line: <DbConnectionSetting provider="sqlserver" connectiontype="sqlserver" serveraddress="localhost\fxcdb" datasource="fxc" userid="fxc_admin" password="7t2lg5ykdgbogxmb6ypvlg+duiajgzjtizeuixzn/ixagrl1sw0geg=="></dbconnectionsetting> and revise the hostname and instance name to match that of the SQL server that now hosts your FaxCore database followed by providing the logon password for the account fxc_admin in encrypted form before saving the changes and closing the document. Example: <DbConnectionSetting provider="sqlserver" connectiontype="sqlserver" serveraddress="sqlfarm\fxcent" datasource="fxc" userid="fxc_admin" password="7t2lg5ykdgbogxmb6ypvlg+duiajgzjtizeuixzn/ixagrl1sw0geg=="></dbconnectionsetting> Note: To encrypt the password, point your browser to http://servername/_debug/encryptionpage.aspx 3. Launch the Microsoft Command Prompt and execute the following command: iisreset /start which starts all IIS related services on the fax server: IIS Admin Service, WWW Service, HTTP Service, FTP Service, SMTP Service and NNTP Service. 4. Next, launch the Microsoft Services Management Console and proceed to restart the following FaxCore services: FXC3.Dispatcher, FXC3.FaxAgent, FXC3.Gateway, FXC3.PrintService, FXC3.RenderAgent and FXC3.SMTPGateway.