Installation-related FAQs
                                                                 
                                                            
General
 What security is in place regarding the downloadable files?
What security is in place regarding the downloadable files?
                                                                        Each installation file has a corresponding XML file which provides a security checksum that is validated against the install.
If the checksum doesn’t match, the install will not continue until it has been resolved.
In addition, every installation has been digitally signed by SYSPRO from EXEs to MSIs. Therefore, the digital signature is broken as soon as a file is edited and re-saved in any way.
 How do I enable logging for debugging purposes?
How do I enable logging for debugging purposes?
                                                                        If you want to enable output logging to the debug viewer you need to add a registry entry TraceOn, with a value of true.
You can then retrieve debug logs of what the SYSPRO Installer application is doing, as well as the service, provided they are on the same machine.
If SYSPRO Deployment Server errors are generated, the log file is created in the %temp% folder.
 Where is the SYSPRO software published?
Where is the SYSPRO software published?
                                                                        SYSPRO Software is published to the Azure Content Delivery Network (CDN). Downloading software is optimized to obtain software based on point-of-presence (POP).
Benefits include:
- 
                                                                                    Software is always current. 
- 
                                                                                    Local downloads result in faster speed and higher performance. 
- 
                                                                                    Large file support. 
- 
                                                                                    Available 24/7. If one region should fail for any reason, the software is then sourced from another POP. 
- 
                                                                                    No more DVD installs. 
 Why are existing web views not appearing in SYSPRO after updating to the latest release?
Why are existing web views not appearing in SYSPRO after updating to the latest release?
                                                                        From SYSPRO 8 2019 R1 onwards you must explicitly state whether a web view is targeted for SYSPRO or SYSPRO Avanti.
Because any pre-existing web view is assumed to be for SYSPRO Avanti, if you want existing SYSPRO web views to appear in later versions of SYSPRO, you must rename the .JSON file to include a _SYSPRO extension (e.g. UX_OperatorCode_ProgramLZ_SYSPRO.JSON).
The .JSON file resides in your \Base\Settings folder (or the Role_xxx folder if the user interface is configured by role).
You can also rename the file using the Save as function from within the Visual Designer. You will be prompted to indicate the type of web view you want to save (i.e. Avanti or SYSPRO Client).
Upgrading
 What is the difference between upgrading and updating?
What is the difference between upgrading and updating?
                                                                        Upgrading is when you move from one version of SYSPRO software to another (e.g. from SYSPRO 7 Update 1 to SYSPRO 8).
Updating is when you move from one release of the current software to a later release (e.g. from SYSPRO 8 2018 R2 to SYSPRO 8 2019 R1)
 What happens to my legacy files when upgrading to SYSPRO 8?
What happens to my legacy files when upgrading to SYSPRO 8?
                                                                        When you upgrade from SYSPRO 7 Update 1 to SYSPRO 8 (using the SYSPRO Installer app) the process is as follows:
- 
                                                                                    SYSPRO 7 Update 1 installation files are removed. There may be some files left behind after this process because of new files added through ports, or third party developer files.
- 
                                                                                    The SYSPRO 8 installation process checks whether there are any remaining legacy files. If any are found, they are moved to a newly-created archived folder (Archived_SYSPRO7Files). 
- 
                                                                                    The following folders are added to the archived folder in the SYSPRO 8 install location: - \Programs
- \Screens
- \Base\Bin
- \Base\UI
 
SQL Server
 What SQL Server users are required?
What SQL Server users are required?
                                                                        The following SQL Server users must exist prior to using the SYSPRO Installer application, with the appropriate permissions enabled:
| User type | Rules | 
|---|---|
| Administration SQL user | 
 | 
| Standard SQL user | 
 
 | 
 How do I reset SQL Server credentials when logging into SYSPRO?
How do I reset SQL Server credentials when logging into SYSPRO?
                                                                        Possible scenarios for requiring a reset of your SQL Server credentials include:
- You can't log into SYSPRO because of a SQL Server credential error (e.g. password expired).
- You are in a support environment and have been supplied with a database that you cannot access, possibly due to not having the SQL password.
From SYSPRO 8, you can reset your SQL Server credentials:
- Open IMPACT.INI (located in the WORK folder) using an editor application such as Notepad.
- 
                                                                                    Change the SQLADM entry to SQLADM=[reset] or change the SQLSTD entry to SQLSTD=[reset] Changing either entry enables you to reset the password for both accounts. The word 'reset' is not case sensitive. 
- 
                                                                                    Save the file and log into SYSPRO. You will be prompted to enter a new SQL Server user name and password for both the administrative and standard logins. 
 Can I use SQL Express with SYSPRO 8?
Can I use SQL Express with SYSPRO 8?
                                                                        Yes, you can.
The only difference is during your SQL Configuration when running the SYSPRO Installer app for the first time.
At the SQL Server Name field, ensure that you enter the full instance name (e.g. INSTANCENAME\SQLEXPRESS).
You can check this entry if you run SQL Server Management Studio and view the instance to which you are logging in.
Install-related
 Is there a way to speed up the installation process?
Is there a way to speed up the installation process?
                                                                        You can speed up the installation process by copying previously downloaded installation files to a folder that the SYSPRO Installer app can use.
Copy the latest files C:\SYSPRO Deployment\SYSPRO Release\* from a computer which has already downloaded the installs, to the target computer folder with the same name.
 Where do I install the SYSPRO Deployment Service?
Where do I install the SYSPRO Deployment Service?
                                                                        SYSPRO ERP needs access to the SYSPRO Deployment Service and the SYSPRO Deployment Service needs access to the internet 24/7 and Microsoft SQL Server.
You don't have to install the deployment service on the SYSPRO application server, but it must be on a machine that is visible to all the SYSPRO machines involved.
Ideally, the machine should have permanent internet access to communicate with Azure.
 Why can't I see the SYSPRO 8 runtime installed under Programs and Features?
Why can't I see the SYSPRO 8 runtime installed under Programs and Features?
                                                                        The SYSPRO 8 runtime uses Micro Focus installation software and is therefore listed as Micro Focus COBOL Server within the Program and Features function of your Windows Control Panel application.
 Can the SYSPRO 8 Client Component be installed on a 32-bit server?
Can the SYSPRO 8 Client Component be installed on a 32-bit server?
                                                                        SYSPRO 8 was developed to be installed exclusively on 64-bit client and server operating systems. In addition, the SYSPRO 8 installation application is also only available to run on a 64-bit operating system.
However, there is limited support for SYSPRO 8 Clients running 32-bit operating systems. The 32-bit client can only be installed using the export function in the SYSPRO 8 installation application.
The SYSPRO 8 and 32-bit Client Operating Systems guide covers the steps to be taken to install the SYSPRO 8 Client component on a 32-bit operating system (available from the Install Guides page of the Resources section).
 Where do I get the Customer Code and Customer Pin Code?
Where do I get the Customer Code and Customer Pin Code?
                                                                        When you request a SYSPRO 8 license, you will receive an email containing the XML license file attachment.
Both of these codes are contained in the license file.
 What if I change the machine name on which the app is installed?
What if I change the machine name on which the app is installed?
                                                                        If the SYSPRO Installer app detects that the machine on which it is setup is renamed, it will attempt to self-heal with an automatic reconfiguration process, in order to update the deployment details.
 Why must SYSPRO 8 be installed on a 64-bit server?
Why must SYSPRO 8 be installed on a 64-bit server?
                                                                        SYSPRO 8 must be installed on a 64-bit server (all the SYSPRO services are now 64-bit).
 What can I do to resolve a 163 Error?
What can I do to resolve a 163 Error?
                                                                        Ensure that you add or set the COBSW variable to -F on your client and server machine where the SYSPRO runtime is deployed.
Hotfixes
 How many hotfixes can be installed per release?
How many hotfixes can be installed per release?
                                                                        A maximum of 127 hotfixes can be installed per release (Microsoft limitation). Therefore, ensure that you only install hotfixes that you require. Alternatively, install a consolidated hotfix.
 What are Hotfix Knowledge Base Articles
What are Hotfix Knowledge Base Articles
                                                                        A hotfix KB article contains information about the software included in the hotfix, as well as a summary of the problems addressed.
You can access these by selecting the More button against the hotfix on the Hotfix selection screen of the SYSPRO Installer application.
 How do I search for Hotfixes
How do I search for Hotfixes
                                                                        Within the Hotfix Selection screen of the SYSPRO Installer, you can search for a specific hotfix by any of the following:
- Enter the full KB number (e.g. KB8000006)
- Enter the last digits (e.g. 06) into the search box
- Enter any full text related to the hotfix (e.g. Ledger Query)
This will show Mandatory Hotfixes and Optional Hotfixes.
There could be a large number of hotfixes available - many of which are not relevant to your site or how you use the software. Therefore, only use this function if you have received an Optional/Customer-specific Hotfix to install, or if you suspect a problem with your current SYSPRO software and want to establish whether an applicable hotfix is available.
 Why is the HOTFIXES button displayed without any Mandatory or Optional Hotfixes?
Why is the HOTFIXES button displayed without any Mandatory or Optional Hotfixes?
                                                                        If there is no Mandatory Hotfix/Optional/Customer-specific Hotfix available for your customer code, but the HOTFIXES button is still displayed on the deployment group home page, then the application has detected that there are additional Optional Hotfixes available for you to view and optionally select.
 Can I uninstall a hotfix?
Can I uninstall a hotfix?
                                                                        Yes, in the unlikely event that a deployed hotfix contains a flaw that may result in more damage than it was trying to repair, you can uninstall the hotfix.
The system is able to revert affected programs to a state prior to the deployment of the faulty hotfix.
 Who can access the hotfix notification button on the SYSPRO Ribbon bar?
Who can access the hotfix notification button on the SYSPRO Ribbon bar?
                                                                        Although the hotfix notification button is visible to all users, it is only enabled for operators belonging to a group with system administrator privileges.
 What does the hotfix notification button on the SYSPRO Ribbon bar do?
What does the hotfix notification button on the SYSPRO Ribbon bar do?
                                                                        This button shows the Mandatory or Optional Hotfixes recorded against your customer code, which have not yet been installed.
 What happens when I have multiple application servers for one site and need to update software or deploy hotfixes?
What happens when I have multiple application servers for one site and need to update software or deploy hotfixes?
                                                                        If you have multiple application servers for the same site, you have to run the SYSPRO Installer on each machine that has the Application Server installed. This is because hotfixes must be applied directly to the Application Server.
 How can I identify a consolidated hotfix?
How can I identify a consolidated hotfix?
                                                                        When using the SYSPRO Installer application, a consolidated hotfix is clearly indicated with the following phrase appended to its name: ** Consolidated **.
The synopsis will explain the hotfixes that have been included and summarizes how this roll-up and install works.
 What happens if I uninstall a Consolidated Hotfix?
What happens if I uninstall a Consolidated Hotfix?
                                                                        One of the best things about the hotfix technology in SYSPRO 8 is that if, for any reason, you wish to uninstall a hotfix, the software is restored back to what it was prior to the hotfix being installed.
The same happens if you were to uninstall a consolidated hotfix. The software will revert to just the previously installed hotfixes.
Firewalls and Proxy Servers
 What if I have additional Firewall software (other than the standard Windows Firewall)?
What if I have additional Firewall software (other than the standard Windows Firewall)?
                                                                        When the SYSPRO Deployment Service is installed, ports 30250 (Endpoint port) and 3702 (Endpoint discovery) are enabled on the Windows firewall.
If you have additional firewall software, you need to open these ports within the software to enable the SYSPRO Installer app to function.
 What URLs must be open for sites with proxy servers?
What URLs must be open for sites with proxy servers?
                                                                        For sites with proxy servers, the following URLs must be open for the SYSPRO Deployment Service to retrieve software and communicate with the SYSPRO Azure service:
- SYSPRO 8 downloads (from Microsoft Azure CDN): https://syspro8install.azureedge.net/*
- Azure service calls: https://sysprodeploymentazlive.azurewebsites.net/*
- InfoZone : https://izauthservicedev.syspro.com/*
 What ports should be enabled for discovery to work?
What ports should be enabled for discovery to work?
                                                                        The SYSPRO Deployment Service provides support to be discoverable at runtime. Therefore, for WCF Discovery to work correctly, all NICs (Network Interface Controller) should only have one IP address.
Ports that must be open:
- 
                                                                                    UDP discovery: Port 3702 
- 
                                                                                    Default listening endpoint: Port 30250 This is the port to which the service responds. You can always manually enter the endpoint if discovery is not enabled.
Client Roll-out
 How do I roll-out SYSPRO software for client machines?
How do I roll-out SYSPRO software for client machines?
                                                                        You have one of two options:
- 
                                                                                    Run the SYSPRO Installer app on each client machine to install the SYSPRO client. 
- 
                                                                                    Use the Export function of the app. Once you have completed your export, all items exported are downloaded from Azure to the SYSPRO Deployment Shared folder and a text file is created which you can then use for rolling out to your clients. 
Developer considerations
 Why can't I make direct calls to Encore.dll?
Why can't I make direct calls to Encore.dll?
                                                                        | Removed: | Direct calls to Encore.dll are no longer available. | 
| Reason: | Directly referencing Encore.dll using COM/DCOM limits applications to 32-bit as well as SYSPRO's future expandability. In addition, any third party applications referencing the SYSPRO DLL's directly make it difficult for SYSPRO to easily enhance the system without requiring each third party application to also be changed. Web Services are still supported, so developers who have previously used Web Services will work unchanged. | 
| Replaced by: | Using the SYSPRO 8 e.net Communications Load Balancer service de-couples applications from the e.net 64-bit library and provides excellent scalability and performance. Additional benefits: 
 | 
Language Translation
 Where is the language pack deployed?
Where is the language pack deployed?
                                                                        When you select to install a language pack, the language file is deployed to the same folder where the SYSPRO.EXE resides (\Base).
 Can I install more than 1 language pack?
Can I install more than 1 language pack?
                                                                        You can install as many of the available language packs as you require.
