Updating Microsoft Dynamics SL To Microsoft Dynamics SL 2018 Cumulative Update 2
Updating Microsoft Dynamics SL To Microsoft Dynamics SL 2018 Cumulative Update 2
Microsoft Dynamics SL to
Microsoft Dynamics SL 2018
Cumulative Update 2
Disclaimer
This document is provided “as-is”. Information and views expressed in this document, including URL and other Internet Web site references, may change
without notice. You bear the risk of using it.
Some examples are for illustration only and are fictitious. No real association is intended or inferred.
This document does not provide you with any legal rights to any intellectual property in any Microsoft product. You may copy and use this document for your
internal, reference purposes only.
Sample Code Warranty disclaimer
Microsoft Corporation disclaims any warranty regarding the sample code contained in this documentation, including the warranties of merchantability and
fitness for a particular purpose.
License agreement
Use of this software is covered by a license agreement provided with it. If you have any questions, please call the Customer Assistance Department at 800-
456-0025 (in the United States or Canada) or +1-701-281-6500.
Copyright
© 2019 Microsoft Corporation. All rights reserved.
Publication Date
April 2019
1 of 27
Contents
Purpose 3
Before You Begin 3
About This Cumulative Update ....................................................................................................... 3
Technical Details 27
Registered Files ............................................................................................................................. 27
Global Assembly Cache ................................................................................................................. 27
Silent Mode Installation Option .................................................................................................... 27
2 of 27
Purpose
The purpose of this document is to inform system administrators and implementers about Microsoft
Dynamics® SL 2018 Cumulative Update 2 and to guide them through the installation.
Back up all Microsoft Dynamics SL databases before you continue. For more information, see “Backing Up
Databases” in the System Manager Help or user’s guide.
Note: The procedure to update clients differs from service packs before Microsoft Dynamics SL 2015. Make
sure that you read “Updating Client Workstations” on page 25 carefully before you continue. If the server has a
client installed on it, the installation process updates the server’s client automatically.
3 of 27
• Make sure that you have the installation package available if you have to install Microsoft Dynamics SL
2018 CU1, and printed copies of the Microsoft Dynamics SL Installation Guide Release 2018 CU1 and
instructions for any supporting products that you plan to install.
• When you install Microsoft Dynamics SL 2018 CU2 over an existing installation, files overwrite the
corresponding Microsoft Dynamics SL 2018 CU1 version of the files. For example, the Microsoft Dynamics
SL 2018 CU2 version of 0101000.exe overwrites the existing version of 0101000.exe.
• This cumulative update affects the following features:
Accounts Payable
Advanced Payroll
Flexible Billings
General Ledger
Payroll
Project Controller
Quick Query
Requisitions
Service Contracts
• If you add a new Microsoft Dynamics SL client to your system after you install Microsoft Dynamics SL 2018
CU2 on the server, you will also have to install the cumulative update on the client computer. When you
installed Microsoft Dynamics SL 2018 CU2 on the server, the workstation components on the server were
updated.
4 of 27
Creating a New Installation
Before you install this cumulative update, you must first install the Microsoft Dynamics SL 2018 Cumulative
Update 1 (CU1) application files, and then install the Microsoft Dynamics SL 2018 Cumulative Update 2 (CU2)
application files. After you have installed all the software, you then create new application and system
databases as described in later sections in this document.
2. Install Microsoft Dynamics SL 2018 CU1. Follow the steps in the “Installing Microsoft Dynamics SL”
section of the Microsoft Dynamics SL Installation Guide Release 2018 CU1.
Note:
• If you plan to install Crystal Reports or Microsoft Dynamics SL SharePoint Web Service, also follow the
instructions in the “Installing Supporting Applications” section of the Installation Guide 2018 CU1.
Supporting applications can be installed later, after you have created your application and system
databases.
• If you plan to install the Microsoft Dynamics SL Software Development Kit, you do not have to install
the Microsoft Dynamics SL 2018 CU1 version of these files. The Microsoft Dynamics SL 2018 CU2
has a complete installation package. To install the Software Development Kit, open the SDKSetup.msi
available in the Microsoft Dynamics SL 2018 CU2 installation package. For more information about
the installation process see “Microsoft Dynamics SL Software Development Kit (SDK)” in the Microsoft
Dynamics SL Installation Guide Release 2018 CU1.
3. Restart the computer after you run Setup for Microsoft Dynamics SL 2018 CU1 and before you install
Microsoft Dynamics SL 2018 CU2.
5 of 27
Installing Microsoft Dynamics SL 2018 Cumulative Update 2
1. After you restart, extract the cumulative update .zip file into a temporary folder under the existing Microsoft
Dynamics SL 2018 CU1 installation (for example, Program Files (x86)\Microsoft
Dynamics\SL\Applications\2018CU2) on the server or workstation where Microsoft Dynamics SL 2018
CU1 is currently installed.
2. Stop all programs that are currently running on the file server. This includes those programs displayed as
task buttons in the notification area on the right side of the Windows taskbar, except for virus protection
software.
3. Browse to the temporary folder that you created in step 1, and then open SL2018_CU2.exe.
4. Microsoft Dynamics SL 2018 CU2 appears.
5. Carefully read the software license agreement. To continue, select I accept the terms of the license
agreement, and then click OK.
The OK button will not start the install if you do not select I accept the terms of the license agreement.
Click Cancel to end the installation.
6 of 27
If you accept the License Agreement terms and click OK, Microsoft Dynamics SL Server Setup appears.
6. Click Next. Click Cancel if you decide you do not want to proceed.
7. Click Update to start the installation. If you do not want to install the software, click Cancel.
Note: If you try to install Microsoft Dynamics SL 2018 CU2 on a client workstation where Microsoft
Dynamics SL 2018 CU1 is not already installed, Setup displays the warning message, “The Upgrade patch
cannot be installed by the Windows Installer service because the program to be upgraded may be missing,
or the upgrade patch may update a different version of the program. Verify that the program to be
upgraded exists on your computer and that you have the correct upgrade patch.”
8. The install displays your progress. When the server install is completed the Microsoft Dynamics SL Server
Setup displays a message that the installation is completed.
7 of 27
9. Click Finish to close the Microsoft Dynamics SL 2018 CU1 Server Setup window. Microsoft Dynamics SL
2018 CU1 Client Setup window appears.
10. Click Next. If you do not want to install the software, click Cancel.
8 of 27
11. Click Update, the status of the install appears. When the client install is completed the Microsoft Dynamics
SL Client appears with a message that the installation is completed.
12. Click Finish to close the Microsoft Dynamics SL 2018 CU1 Client Setup window.
13. Restart the computer.
This finishes the first phase of the installation process.
9 of 27
Creating New Databases
A Microsoft Dynamics SL application database contains all the accounting data for a single financial entity or
group of related financial entities. A system database contains shared, site-specific data such as database
field attributes, edit characteristics, product registrations, customizations, and screen-level security.
You must set up a working application database (also known as a production or empty database) and a system
database before you can start to enter business data.
In Database Maintenance (98.290.00), you can create databases based on the following scenarios:
• Empty Databases — Use this scenario to create a new system database and a new application database.
• Demo – Business Ready Editions — Use this scenario to create system and application databases for
demonstrating the Business Ready Edition features based on the software package that you chose—either
Business Essentials or Advanced Management—when you installed Microsoft Dynamics SL. For more
information, see the “Which Microsoft Dynamics SL edition should I install?” topic in the Microsoft
Dynamics SL Installation Guide Release 2018 CU1.
• Demo – Professional Edition — Use this scenario to create a database for demonstrating the Professional
Edition features. This scenario includes demonstration data for the Financial Management, Inventory and
Order Processing, Manufacturing, Field Service Management, and Project Management and Accounting
modules. It also includes Multi-Company support.
• Demo – Standard Edition — Use this scenario to create a single-company database for demonstrating the
Standard Edition features. This scenario contains only Financial Management data.
• Additional Empty Application Database — Use this scenario to create an additional application database for
use with an existing system database.
To create databases:
These procedures must be performed by a Microsoft Dynamics SL system administrator.
Before you start the following steps, make sure that the Authentication Mode for SQL Server is set to Mixed
Mode on the database server. For more information, see the MSDN topic “Change Server Authentication
Mode”.
1. Confirm that the SQL Server service is running. Restart it if it is necessary. For more information about
starting SQL Server services, see the following MSDN topic:
“Start, Stop, Pause, Resume, Restart the Database Engine, SQL Server Agent, or SQL Server Browser
Service”.
http://msdn.microsoft.com/en-us/library/32660a02-e5a1-411a-9e57-7066ca459df6
10 of 27
2. Open Database Maintenance (98.290.00) by going to Start | Control Panel | Administrative Tools, and
then click Microsoft Dynamics SL Database Maintenance. Database Maintenance (98.290.00) appears.
3. On the Connect Server tab, type the Destination SQL Server Name.
4. Windows Authentication is selected as the default security mode to access the instance of SQL Server. It is
recommended for a Windows user who is running Database Maintenance (98.290.00) as a SQL Server
administrator.
Click SQL Server Authentication if you prefer to use it, and then type the SQL Server “sa” Login ID and
Password for the instance of SQL Server where the databases will be created.
5. Click Connect to connect to the instance of SQL Server. A message in the status bar appears that
indicates that you are connected.
6. Click the Create Databases tab.
7. To create databases, follow the setup instructions in Microsoft Dynamics SL Installation Guide Release
2018 CU1 for the kind of database that you are creating.
• “Creating an Empty Database”
11 of 27
• “Creating a Demo Database”
• “Creating an Additional Empty Application Database”
8. To complete preparing the database, follow the setup instructions for preparing the database. See
“Preparing the Demo System and Application Databases” in Microsoft Dynamics SL Installation Guide
Release 2018 CU1.
12 of 27
Installing Microsoft Dynamics SL on Workstations
Each client workstation must have certain resources loaded on its local hard disk in order to access and use
Microsoft Dynamics SL. Two workstation setup options are available:
• Run Microsoft Dynamics SL from a shared directory on the server
• Run Microsoft Dynamics SL from the local client workstation
You must complete one or the other of the workstation setup procedures at each workstation where access to
Microsoft Dynamics SL is required.
13 of 27
e) Carefully read the software license agreement. To continue, select I accept the terms of the license
agreement, and then click OK.
f) The OK button will not start the install if you do not select I accept the terms of the license agreement.
Click Cancel to end the installation.
g) If you selected OK, Microsoft Dynamics SL 2015 Client Setup window will appear.
h) Click Next. If you do not want to install the software, click Cancel.
14 of 27
i) Click Update, the status of the install will appear. When the client install is completed the Microsoft
Dynamics SL Server Client appears with a message that the installation is completed.
j) Click Finish to close the Microsoft Dynamics SL 2015 Client Setup window.
Note, all workstations will need to have both the Client install and Cumulative Update install run at
each of the workstations.
Microsoft.Dynamics.SL.OutlookAddin
Microsoft Dynamics SL screens work with email through Microsoft Visual Studio Tools for Office (VSTO). VSTO
lets Microsoft Dynamics SL screens to communicate with Microsoft Office Outlook through an add-in. This add-
in is named Microsoft.Dynamics.SL.OutlookAddin and is installed with the Microsoft Dynamics SL client. If you
have not installed the Microsoft.Dynamics.SL.OutlookAddin and would like to install at this time, review the
Microsoft Dynamics SL Installation Guide (InstallationGuide.pdf) for release 2018 CU1.
If you have installed the add-in with 2018 Cumulative Update 1 there is nothing to do for the Microsoft
Dynamics SL 2018 Cumulative Update 2 release.
15 of 27
Updating an Existing Installation
Installing Microsoft Dynamics SL 2018 Cumulative Update 2
All Microsoft Dynamics SL users must log off and remain out of applications and databases during the
Microsoft Dynamics SL 2018 Cumulative Update 2 installation and database update process. Failure to do this
may result in the error message “An error occurred during the move data process” and problems may occur
with your installation.
Microsoft Dynamics SL 2018 CU1 must already be installed on each server that will be upgraded to Microsoft
Dynamics SL 2018 CU2. If it is not installed on the destination computer, an error message will appear, and
Setup will automatically stop.
To verify that Microsoft Dynamics SL 2018 CU1 is installed:
1. In Microsoft Dynamics SL, select Help | About Microsoft Dynamics SL. About Microsoft Dynamics SL
appears.
2. For Microsoft Dynamics SL 2018 CU1, verify that 10.01.21108.00 or newer is listed.
3. Click OK.
4. Close Microsoft Dynamics SL.
To install Microsoft Dynamics SL 2018 CU2:
1. Extract the cumulative update .zip file into a temporary folder under the existing Microsoft Dynamics SL
2018 CU1 installation (for example, Program Files\Microsoft Dynamics\SL\Applications\2018CU2) on the
server or workstation where Microsoft Dynamics SL 2018 CU1 is currently installed.
2. Stop all programs that are currently running on the file server. This includes those displayed as task
buttons in the notification area on the right side of the Windows taskbar, except for virus protection
software.
3. Browse to the temporary folder that you created, and then open SL2018_CU2.exe.
4. Microsoft Dynamics SL 2018 CU2 appears.
16 of 27
5. Carefully read the software license agreement. To continue, select I accept the terms of the license
agreement, and then click OK.
The OK button will not start the install if you do not select I accept the terms of the license agreement.
Click Cancel to end the installation.
If you accept the License Agreement terms and click OK, Microsoft Dynamics SL Server Setup appears.
6. Click Next. Click Cancel if you decide you do not want to proceed.
7. Click Update to start the installation. If you do not want to install the software, click Cancel.
Note: If you try to install Microsoft Dynamics SL 2018 CU2 on a client workstation where Microsoft
Dynamics SL 2018 CU1 is not already installed, Setup displays the warning message, “The Upgrade patch
cannot be installed by the Windows Installer service because the program to be upgraded may be missing,
or the upgrade patch may update a different version of the program. Verify that the program to be
upgraded exists on your computer and that you have the correct upgrade patch.”
17 of 27
8. The install displays your progress. When the server install is completed the Microsoft Dynamics SL Server
Setup displays a message that the installation is completed.
9. Click Finish to close the Microsoft Dynamics SL 2018 CU1 Server Setup window. Microsoft Dynamics SL
2015 Client Setup window appears.
10. Click Next. If you do not want to install the software, click Cancel. A new window will appear. The install is
ready to update the Client.
11. Click Update, the status of the install will appear. When the client install is completed the Microsoft
Dynamics SL Client appears with a message that the installation is completed.
12. Click Finish to close the Microsoft Dynamics SL 2018 CU1 Client Setup window.
13. Restart the computer.
This finishes the installation phase of the process. You must now update your workstations, and databases
18 of 27
to correspond to Microsoft Dynamics SL 2018 CU2. If you want to change the authentication method that
is used to access the Microsoft Dynamics SL databases, see “Appendix B: Changing the Database
Authentication Mode” topic in Microsoft Dynamics SL Installation Guide Release 2018 CU1. Otherwise, see
“Using Database Maintenance” on page 20 to continue the process.
19 of 27
Using Database Maintenance
After you install the Microsoft Dynamics SL 2018 CU2 files, you must complete a Database Maintenance
scenario.
Important:
• Back up all Microsoft Dynamics SL system databases and application databases before you begin the
following procedure.
• Before upgrading your databases, export the Microsoft Dynamics SL customizations to a .cst file so that
you can import the file into the upgraded database. See the Customization Manager Help or user’s guide
for information about how to export and import .cst files. It is also a good idea to print the code associated
with the customization by using the Visual Basic for Applications integrated development environment
(IDE).
• All records that you added to the Messages, Screen, or PVRec tables remain intact. If changes were made
to the database schema, you must verify that these changes are still in place after the update to Microsoft
Dynamics SL 2018 CU2 is finished.
To upgrade Microsoft Dynamics SL databases:
1. Confirm that the SQL Server service is running. Restart it if it is necessary. For more information about
starting SQL Server services, see the following MSDN topic:
“Start, Stop, Pause, Resume, Restart the Database Engine, SQL Server Agent, or SQL Server Browser
Service”.
http://msdn.microsoft.com/en-us/library/32660a02-e5a1-411a-9e57-7066ca459df6
2. In SQL Server Management Studio, connect to the database server as an administrator (sa or a user who
is a member of the sysadmin server role).
3. Create backups of the system databases and application databases. For more information, see SQL Server
Books Online.
4. Open Database Maintenance (98.290.00) by going to Start | Control Panel | Administrative Tools, and
then clicking Microsoft Dynamics SL Database Maintenance. Database Maintenance (98.290.00)
appears.
5. On the Connect Server tab, type the Destination SQL Server Name.
20 of 27
6. Windows Authentication is the default security mode to access the instance of SQL Server. It is also the
recommended authentication mode. Click SQL Server Authentication if you prefer to use it, and then type
the SQL Server “sa” Login ID and Password for the instance of SQL Server where the databases are
located.
7. Click Connect to connect to the instance of SQL Server. When the status bar at the bottom of the screen
indicates that you have connected to the instance of SQL Server, click the Update Databases tab.
8. Select the system database name from the System Database Name list.
9. In Update Scenario, notice that the correct scenario was selected by default based on the system
database name that you selected.
10. In Databases, select one or more application databases associated with the system database specified in
step 8.
11. Click Update Database to apply the update to your databases. If your database is SQL authenticated,
Authentication appears. If your database is Windows authenticated, go to step 14.
12. Select an authentication method, and then click Ok. Windows authentication is recommended. You should
be aware that if you change authentication methods after you set up users and groups, you must redo your
user and group setup.
21 of 27
If you selected SQL Server Authentication, Security appears.
b.) Click Ok to accept the default Microsoft Dynamics SL administrator, or make changes as needed,
and then click Ok. The database update process starts.
A user who is defined as an administrator automatically has access to all screens within Microsoft Dynamics
SL and becomes a member of the SQL Server sysadmin server role if the Grant this user permission to create
SQL Server logins and users check box is selected.
22 of 27
c.) In the Password box, type the password that was created for the Master80 user when the
Microsoft Dynamics SL 2018 CU1 databases were generated, and then click OK.
d.) Click Ok. The database update process starts.
SYSADMIN Login appears.
e.) Follow the instructions to specify a default user password in the Password box. The password
must satisfy the strong password requirements that are listed in the dialog box.
For more information about strong passwords, see the Microsoft Dynamics SL Security Guide.
15. When the update is complete, the 9829000 message box appears.
23 of 27
Note: If the update was unsuccessful, you will not see this message. Otherwise, a database update failure
message will appear.
Note: Populating the Screen table and the RPTControl table occurs during database creation (databases are
created by using Database Maintenance (98.290.00)). The Screen.csv file and the rptcontrol.csv file are no
longer a part of Database Update (98.100.00).
24 of 27
Updating Client Workstations
Each client workstation must have certain resources loaded on its local hard disk in order to access and use
Microsoft Dynamics SL. Two workstation setup options are available:
• Run Microsoft Dynamics SL from a shared directory on the server
• Run Microsoft Dynamics SL from the local client workstation
You must complete one or the other of the workstation setup procedures at each workstation where access to
Microsoft Dynamics SL is required.
25 of 27
Updating Microsoft Dynamics SL on the Local Client Workstation
To update a full server and client version of Microsoft Dynamics SL on a local drive, follow the instructions in
“Installing Microsoft Dynamics SL 2018 Cumulative Update 2” starting on page 16.
26 of 27
Technical Details
Registered Files
Setup updates several registered files. Before the file copy process starts, Setup un-registers the Microsoft
Dynamics SL 2018 CU1 version of these files. After Setup copies the new Microsoft Dynamics SL 2018
Cumulative Update 2 files to the appropriate directories, Setup registers each new file.
27 of 27