Infor SunSystems Standalone Installation Guide

Infor SunSystems StandaloneInstallation Guide

Release 6.4.0

Copyright © 2021 Infor

Important Notices

The material contained in this publication (including any supplementary information) constitutes andcontains confidential and proprietary information of Infor.

By gaining access to the attached, you acknowledge and agree that the material (including anymodification, translation or adaptation of the material) and all copyright, trade secrets and all otherright, title and interest therein, are the sole property of Infor and that you shall not gain right, title orinterest in the material (including any modification, translation or adaptation of the material) by virtueof your review thereof other than the non-exclusive right to use the material solely in connection withand the furtherance of your license and use of software made available to your company from Inforpursuant to a separate agreement, the terms of which separate agreement shall govern your use ofthis material and all supplemental related materials ("Purpose").

In addition, by accessing the enclosed material, you acknowledge and agree that you are required tomaintain such material in strict confidence and that your use of such material is limited to the Purposedescribed above. Although Infor has taken due care to ensure that the material included in this publicationis accurate and complete, Infor cannot warrant that the information contained in this publication iscomplete, does not contain typographical or other errors, or will meet your specific requirements. Assuch, Infor does not assume and hereby disclaims all liability, consequential or otherwise, for any lossor damage to any person or entity which is caused by or relates to errors or omissions in this publication(including any supplementary information), whether such errors or omissions result from negligence,accident or any other cause.

Without limitation, U.S. export control laws and other applicable export and import laws govern youruse of this material and you will neither export or re-export, directly or indirectly, this material nor anyrelated materials or supplemental information in violation of such laws, or use such materials for anypurpose prohibited by such laws.

Trademark Acknowledgements

The word and design marks set forth herein are trademarks and/or registered trademarks of Infor and/orrelated affiliates and subsidiaries. All rights reserved. All other company, product, trade or servicenames referenced may be registered trademarks or trademarks of their respective owners.

Publication Information

Release: Infor SunSystems 6.4.0Publication Date: November 1, 2021Document code: ss_6.4.0_standalone_install__en-us

Contents

About this guide.................................................................................................................................5

Related documents...........................................................................................................................5

Contacting Infor.................................................................................................................................7

Chapter 1: Installing SunSystems in a stand-alone environment..................................................8

Installing SunSystems for the first time.............................................................................................8

Windows service packs.....................................................................................................................9

Installation checklist..........................................................................................................................9

Chapter 2: Prerequisite tasks..........................................................................................................10

Operating system requirements......................................................................................................11

Creating users and groups..............................................................................................................11

Installing Microsoft .NET.................................................................................................................12

Adding Microsoft .NET features...................................................................................................13

Microsoft SQL Server and Reporting Services...............................................................................13

Installing Microsoft SQL Server...................................................................................................14

Installing Microsoft Reporting Services........................................................................................14

Adding Internet Information Services...........................................................................................17

Disabling the default website.......................................................................................................17

Installing or updating Oracle OpenJDK...........................................................................................18

Installing or updating Apache Tomcat.............................................................................................18

Installing SQL Server ODBC driver.................................................................................................19

Installing IIS Application Request Routing (ARR)...........................................................................19

Adobe Acrobat Reader....................................................................................................................19

Supported web browsers.................................................................................................................20

Chapter 3: Installing SunSystems...................................................................................................21

Installation checklist........................................................................................................................21

Downloading the installer................................................................................................................21

Infor SunSystems Standalone Installation Guide | 3

Contents

Running the installer........................................................................................................................21

Chapter 4: Post-installation tasks...................................................................................................23

Serializing SunSystems...................................................................................................................23

Installing patch sets.........................................................................................................................23

Chapter 5: Configuring SunSystems..............................................................................................24

Adding SunSystems Reporting Service Group membership..........................................................24

Configuring SunSystems Data Models in Report Models...............................................................25

Chapter 6: Uninstalling SunSystems..............................................................................................26

Chapter 7: Glossary..........................................................................................................................27

Chapter 8: Troubleshooting.............................................................................................................29

Contacting Infor Technical Support.................................................................................................29

Troubleshooting hints.......................................................................................................................29

Support Knowledgebase on the Infor Support Portal...................................................................30

General installation problems.......................................................................................................30

Common problems.......................................................................................................................31

Serialization error in a working SunSystems...............................................................................31

Reports fail to load after applying a patch set..............................................................................31


Contents

About this guide

Version 64A

This guide describes how to install SunSystems in a stand-alone environment. It provides details ofprerequisites including mandatory checks, the installation process and post-installation tasks.

Note: This guide does not cover the installation of languages, nor the setup of local help files in astand-alone environment.

Intended audience

This document is intended for system administrators, SunSystems consultants and channel partnerconsultants involved in deploying and maintaining SunSystems. Due to the numerous implementationoptions for SunSystems, only experienced consultants should perform the installation process.

Related documentsSunSystems documentation consists of user guides, such as the installation and upgrade guides, andonline application help.

User guides are in PDF format and are available from the Infor Support Portal. To access documentationon the Infor Support Portal, select Search > Browse Documentation. We recommend that you checkthis portal periodically for updated documentation.

Release NotesDetails information relevant to this release that is not included elsewhere in the SunSystemsdocumentation.

What's NewHighlights significant changes or enhancements in the release.

Resolved IssuesDescribes issues resolved in the latest release.

Infor SunSystems Architecture and Planning GuideProvides an architectural overview of the software. Refer to this guide when planning the deploymentof SunSystems.


About this guide

Infor SunSystems Installation GuideDescribes installing SunSystems in multiple deployment scenarios.Note: Review the installation guides before making any changes to your SunSystems environment.

Infor SunSystems Standalone Installation GuideDescribes installing SunSystems on a single machine. No other environment is described.

Infor SunSystems Upgrade GuideDescribes upgrading SunSystems from an existing deployment.

Guide to Migrating Data from SunSystems 4Describes migrating data from an existing SunSystems v4 installation, into SunSystems v6.

SunSystems online help

Provides details of day-to-day operational tasks and is displayed while you are using SunSystems.The help files can be accessed from the cloud at https://docs.infor.com/en-us/sunsystems/6.4.x. SeeKB1859777 for instructions on how to download online help to a local server in your environment. SeeConfiguration Manager in the online help for more information.

Read the Administrator Help after successful installation of SunSystems. There are specific tasks thatmust be carried out before the installation can be used and the Administrator Help provides details ofsetup and maintenance. The tasks are those that are normally expected of an application consultantor a systems administrator.

Tasks in the Administrator Help are broken into four areas:

• Tasks that are appropriate to SunSystems modules• Generic tasks appropriate to all installations of SunSystems• Financial tasks that are relevant only if the Financials modules are installed• Order Fulfilment tasks that are relevant only if the Order Fulfilment modules are installed.

These topic modules are included in the online help.

• System Basics• Modules

• Financials• Order Fulfilment• SunSystems Connect

• SSC Technical Reference

• Transfer Desk• Transfer Desk Web• Enterprise Data Management

• Administration• Administrator Help• User Manager• Security Console• Configuration Manager• Integration Configuration• Financials Administration


About this guide

https://docs.infor.com/en-us/sunsystems/6.4.x

• Order Fulfilment Administration• Customization

• User Group Menu Designer• Form Designer• Filter Designer• Formula Designer• Drill Association Designer• Data Description Editor

• Reporting• Report Designer• Report Manager.

Contacting InforIf you have questions about Infor products, go to Infor Concierge at https://concierge.infor.com/ andcreate a support incident.

The latest documentation is available from docs.infor.com or from the Infor Support Portal. To accessdocumentation on the Infor Support Portal, select Search > Browse Documentation. We recommendthat you check this portal periodically for updated documentation.

If you have comments about Infor documentation, contact [email protected].


About this guide

https://concierge.infor.com/

https://docs.infor.com/

mailto:[email protected]

Chapter 1: Installing SunSystems in a stand-aloneenvironment

This installation guide describes a stand-alone installation of SunSystems 6.4.

If you are installing SunSystems over multiple tiers, then refer to the SunSystems 6.4 Multitier InstallationGuide.

If you are upgrading SunSystems 6.2 or 6.3, then refer to the SunSystems 6.4 Upgrade Guide.

Note: If you are upgrading SunSystems 6.4 to the latest patch set, then refer to the SunSystems 6.4Patch Set Installation Note. This is available with the patch set. The Installation Note contains importantinstructions which are not included in this Installation Guide.Note: The SunSystems 6.4 installer is English language only. Use the Language Deployer to addlanguages to, or to remove languages from a SunSystems installation.

Installing SunSystems for the first timeIf you are installing SunSystems for the first time, note that the servers on which Infor applications areinstalled should be member servers in a domain. They should be dedicated to the Infor applications.If not, then performance may be affected. The servers should not be:

• a primary or back-up domain controller, running Active Directory• a mail server running Exchange or other mail• a file or print server other than for SunSystems• a virtualization host server running Hyper-V, VMware, ESXi, or Citrix XenServer• an Intranet or Internet server, running Internet Information Server, Apache or similar, other than

for SunSystems• a Microsoft Small Business Server.

Note: If deploying on Microsoft Small Business Server, Infor software must be installed in dedicatedvirtual images and not on the host operating system. This is subject to the supporting softwareenvironment meeting the minimum software requirements. If performance issues arise, separationonto dedicated hardware may be necessary.

If a SunSystems component is installed on a computer (physical or virtual) included in the list, theinstallation cannot be supported. If you are unsure, check with your local support region for furtherclarification before deploying the configuration.


Installing SunSystems in a stand-alone environment

Caution: Computer names should follow Microsoft naming conventions. In addition, you should notinclude the ‘_’ underscore character in computer names as this causes problems for Tomcat and Javacomponents.

Windows service packsThe latest service pack should be applied to your Windows operating system before installingSunSystems components.

Installation checklistThis table shows the installation tasks to be completed:

ReferencesTask✔

Uninstalling SunSystems onpage 26

Uninstall any previous SunSystems installation

Prerequisite tasks on page 10Ensure you have completed every item on the prerequisiteschecklist

Downloading the installer onpage 21

Acquire the SunSystems ISO and make available on yourserver

Running the installer on page21

Install SunSystems

Post-installation tasks on page23

Complete the post-installation checklist

Configuring SunSystems onpage 24

Complete the configuration tasks

Troubleshooting on page 29Refer to the Troubleshooting section in the event of an error

Note: This guide does not cover the installation of languages, nor the setup of local help files, in astand-alone environment.


Installing SunSystems in a stand-alone environment

Chapter 2: Prerequisite tasks

You must complete the prerequisites checklist before installing SunSystems:

ReferencesTask✔

Operating system requirementson page 11

Ensure server complies with the hardware requirements

Creating users and groups onpage 11

Create these groups:

• SunSystemsServices• SunSystemsClients

Create this user:

• SunSystemsReporting

Assign the Log on as a service user right to theSunSystemsReporting user.

Installing Microsoft .NET onpage 12

Install Microsoft .NET

Adding Internet InformationServices on page 17

Add Internet Information Services

Disabling the default website onpage 17

Disable the default website in IIS Manager

Microsoft SQL Server and Re-porting Services on page 13

Install and configure Microsoft SQL Server and MicrosoftReporting Services

Microsoft SQL Server and Re-porting Services on page 13

Assign the SunSystemsReporting user as the reportingservice account

Adding file extensions to SQLServer Reporting Services onpage 15

For SQL Server 2019 installations, additional file type ex-tensions are required for SSRS

Installing or updating OracleOpenJDK on page 18

Install Oracle OpenJDK

Installing or updating ApacheTomcat on page 18

Install Apache Tomcat core zip

Installing SQL Server ODBCdriver on page 19

Install SQL Server ODBC driver


Prerequisite tasks

ReferencesTask✔

Installing IIS Application Re-quest Routing (ARR) on page19

Install IIS Application Request Routing (ARR)

Adobe Acrobat Reader on page19

Download and install the latest version of Adobe AcrobatReader from the Adobe website.

Supported web browsers onpage 20

Ensure you are using a supported web browser

Installing patch sets on page 23Download patch sets for SunSystems in readiness to applyafter installation

Ensure you have a valid SunSystems serialization fileavailable.

Operating system requirementsEntry level recommendationOperating systems (64-bit only)

Dual Core 3Ghz 8GB RAMWindows 2022 Standard Edition and DataCenterEdition

Dual Core 3Ghz 8GB RAMWindows 2019 Standard Edition or above

Dual Core 3Ghz 8GB RAMWindows 2016 Standard Edition or above

Dual Core 3Ghz 8GB RAMWindows 2012 R2 Standard Edition or above

Dual Core 3Ghz 8GB RAMWindows 10

(Client)Windows 8.1

Creating users and groupsNote: Windows for Workgroups is not supported. You must be connected to a Windows Domain whenyou install SunSystems

You must create two Windows groups, SunSystemsServices and SunSystemsClients.

During installation, db_owner rights to the SunSystems databases is assigned to theSunSystemsServices group.

You must create an account for the SunSystems Reporting service, for exampleSunSystemsReporting, and add it to the SunSystemsServices group. The SunSystems databases


Prerequisite tasks

are accessed by Reporting Services. You must give Log on as a service rights to theSunSystemsReporting user.

Note: SunSystemsServices, SunSystemsClients and SunSystemsReporting are examplenames.Note: You must be logged into your stand-alone computer as a user that is a member of the localWindows Administrator group.

1 Select Control Panel > Administrative Tools > Computer Management > Local Users andGroups > Groups. Or, run lusrmgr.msc from the Windows Command prompt.

2 Create a group for SunSystems services, for example, SunSystemsServices.

3 Create a group for SunSystems clients, for example, SunSystemsClients.

4 Create a local user account for the SunSystems Reporting service, for example,SunSystemsReporting. Specify the password as Infortemp01. Select Password neverexpires.

Note: To install SunSystems in a stand-alone environment, you can select the Express option inthe installer. The password Infortemp01 is the default password for the Express option.

5 Add the SunSystemsReporting user to the SunSystemsServices group.

6 Run secpol.msc to launch Local Security Policy.

7 Select Local Policies > User Rights Assignment.8 Expand the list, select Log on as a service and right-click Properties.

9 Click Add User or Group.

10 Specify this information:

Enter the object names to selectSpecify the SunSystemsReporting. Click Check Names to ensure it is recognized.

11 Click OK.

Installing Microsoft .NETYou must install the latest version of Microsoft .NET. You can download .NET from the Microsoftwebsite. Ensure you comply with the prerequisite Internet Security settings.

To install Microsoft .NET:

1 Apply the required settings in Internet Security Settings:

Note: This step must be completed before downloading .NET.

a Open Windows Control Panel and select Internet Options > Security > Custom Level. Or,run inetcpl.cpl from the Windows Command prompt.

b Scroll to Downloads and select Enable in File Download.c Select Enable Enable .NET Framework setup.d Click OK.

2 Download and install .NET 4.8.


Prerequisite tasks

3 Restart the server.

Adding Microsoft .NET featuresThese features must be added for Microsoft .NET:

1 Open Windows Control Panel and go to Programs and Features. Or, run appwiz.cpl from theWindows command prompt.

2 Select Turn Windows features on or off.3 Select .NET Framework 4.8 Advanced Services.

4 Select these features:

• ASP.NET 4.8• WCF Services

• HTTP Activation• Message Queuing (MSMQ) Activation• Named Pipe Activation• TCP Port Sharing

5 Click OK.

Microsoft SQL Server and Reporting ServicesMicrosoft SQL Server must be installed with features including the SQL Server Database Engine,Management Tools and Reporting Services.

You must assign the SunSystemsReporting user as the reporting service account to enable accessfor Reporting Services to the SunSystems databases.

Note: SQL Server 2016 and SQL Server 2017 do not give the sysadmin role to NT AUTHORITY\SYSTEM(local system). For a stand-alone installation, this role must be added to the SYSTEM login in MicrosoftSQL Server.

NotesSoftware

SQL Server Reporting Services and ManagementTools are both separate installations.

Note: Additional file type extensions are requiredfor SSRS

Microsoft SQL Server 2019 (Standard edition orabove)

SQL Server Reporting Services and ManagementTools are both separate installations.



Prerequisite tasks

NotesSoftware

Include features:

Database Server, Reporting Services (Native)

Optional: SQL Server Management Studio(SSMS) is a separate install.


Installing Microsoft SQL ServerEnsure you are using Microsoft SQL Server 2019, 2017 or 2016.

Use the Installation menu to install a new SQL Server stand-alone installation, SQL Server ReportingServices and SQL Server Management Tools:

1 Run the Microsoft SQL Server installer.

2 Select Installation > New SQL Server stand-alone installation or add features to an existinginstallation

3 Select Perform a new installation of SQL Server.4 In the Instance Features dialog, select the Database Engine Services.

5 Select Instance Configuration > Default Instance to install a default instance of Microsoft SQLServer.

6 Click Install.

Enabling TCP/IP in SQL Server Configuration ManagerTCP/IP must be enabled for serialization tool to complete successfully.

1 Open SQL Server Configuration Manager.

2 Select SQL Server Network Configuration > Protocols for MSSQLSERVER.

3 Specify enable in the TCP/IP field.

Installing Microsoft Reporting Services1 Run the Microsoft SQL Server installer.

2 From the Installation menu, select Install SQL Server Reporting Services.

3 When the setup is complete, select Configure Report Server.4 To create the Report Server database, select Change Database > Create a new report server

database and click Next > Next.5 Specify this information:

Service AccountSpecify the local localmachinename\SunSystemsReporting account as this user.


Prerequisite tasks

PasswordSpecify the password.

6 Backup the encryption key.

7 Specify the Web Services URL and Web Portal URL.

8 Check that the web browsers open without error:

a Click the Web Services URL to ensure that the browser opens without error.b Click the Web Portal URL to ensure that the browser opens without error.

You can also access this through Reporting Services Configuration Manager.

Note: If the Web Services URL and Web Portal URL browsers open with error, you may need todelete encrypted content. Before doing so, you must make sure that SQL Server Reporting Servicesis not used by any other application that might use the encrypted content.

9 Check that TCP/IP is an enabled protocol for SQL Server Network Configuration in SQL ServerConfiguration Manager by running the correct version of Configuration Manager:

Configuration ManagerSQL Server version

SQLServerManager15.mscSQL Server 2019



a Open Microsoft SQL Server Configuration Manager.b Expand the SQL Server Network Configuration.c Click Protocols for MSSQLSERVER to ensure TCP/IP is enabled.

Installing SQL Server Management StudioTo install SQL Server Management Studio:

1 Run the Microsoft SQL Server Installer2 Select Installation > Install SQL Server Management Tools.3 Complete the installation.Note: You will be prompted by the installer if you are required to restart.

Adding file extensions to SQL Server Reporting ServicesIn Microsoft SQL Server 2019, specific file type extensions are required to import the example reports.These are included in the AllowedResourceExtensionsForUpload and TrustedFileFormat systemproperties in SSRS.

You must ensure that all necessary file type extensions are added before the example reports areimported.


Prerequisite tasks

Note: If the SSRS databases are recreated, then the file type extensions for both system propertiesrevert to their default values.

Complete these steps:

1 Open SQL Server Management Studio.

2 In Object Explorer, select Connect > Reporting Services.

3 Right-click the report server name and select Properties > Advanced.

Note: If the Properties option is unavailable, then you must add your SSMS login as a systemadministrator in SSRS.

4 Check that these file extensions are included in the list for AllowedResourceExtensionsForUpload:

• *.log• *.mhtml• *.csv• *.xlsx

If one of the values is missing then you must add it to the list.

5 Check that these file extensions are included in the list for TrustedFileFormat:• txt• log• xsl• doc• docx• tif• tiff• xml• csv• xlsx• mhtml• emf

If one of the values is missing then you must add it to the list.

6 Restart the SQL Server Reporting Services.

Adding the sysadmin role to the SYSTEM loginThe sysadmin role must be added to the SYSTEM login in Microsoft SQL Server for a stand-aloneinstallation:

1 Run the Microsoft SQL Server Management Studio.

2 Connect to your server.

3 Select Security > Logins > NT Authority\SYSTEM > Properties > Server Roles > ..4 Select sysadmin.

5 Click OK.


Prerequisite tasks

Adding Internet Information ServicesAdd these features to the IIS installation:

1 Open Windows Control Panel and go to Programs and Features. Or, run appwiz.cpl from theWindows command prompt.

2 Select Turn Windows features on or off.3 Select Internet Information Services and expand the features.

4 Select Web Management Tools. Expand the features and select:

• IIS Management Console

5 Select World Wide Web Services and expand the features.

6 Select Application Development Features. Expand the features and select:

• .Net Extensibility 4.5 (or later)• ASP.NET 4.5 (or later)• ISAPI Extensions• ISAPI Filters.

7 Select Common HTTP Features. Expand the features and select:

• Default Document• Directory Browsing• HTTP Errors• HTTP Redirection• Static Content.

8 Select Health and Diagnostics. Expand the features and select:

• Custom Logging• HTTP Logging• Logging Tools• Request Monitor• Tracing

9 Select Performance Features. Expand the features and select:

• Static Content Compression.

10 Select Security. Expand the features and select:

• Basic Authentication• Digest Authentication• Request Filtering• Windows Authentication.

Disabling the default websiteNote: You can specify a different port for SunSystems during installation, if required.


Prerequisite tasks

Port 80 is used by SunSystems, by default. To enable this, you must disable the default website inInternet Information Services (IIS) before installing SunSystems.

1 Open IIS Manager.

2 Expand the connections.

3 Right-click Default Web Site.

4 Select Manage Website > Stop.

Installing or updating Oracle OpenJDKOracle OpenJDK and Tomcat are prerequisites for SunSystems and must be maintained with the latestperformance and security enhancements. Windows environment variables are used by SunSystemsto establish the location of these local installations.

You must use the latest version to ensure your environment has the most recent security updates forOracle Java Development Kit:

1 Download the zip file for Windows/x64 from https://jdk.java.net/17/

2 Unzip the file into C:\JavaPlatform or an equivalent folder and update the SUNSYS_JAVA_HOME64 environment variable with this location.

Note: • If you are updating Java on an existing installation, then you must run Restart Services after

updating the Java environment variable.• If you are installing SunSystems, then SUNSYS_JAVA_HOME64 is set during the installation

process.

Installing or updating Apache TomcatUse the latest version of Apache Tomcat 9 to ensure your environment has the most recent securityupdates.

Note: Apache Tomcat 10 is not supported.

To install or update Apache Tomcat, complete these steps:

1 If you are updating an existing SunSystems installation, all SunSystems users must be logged outand all SunSystems services must be stopped.

2 Open https://tomcat.apache.org/download-90.cgi.

3 Browse to Core under Binary Distributions, and click zip. This downloads the Apache Tomcatfile, for example, apache-tomcat-9.0.45.zip.

Note: You must use the core zip, not the Windows zip.

4 Unzip and save the files to C:\JavaPlatform or an equivalent folder.


Prerequisite tasks

https://jdk.java.net/17/

5 If you are updating java on an existing SunSystems installation, then you must specify the installationdirectory in the SUNSYS_TOMCAT_HOME environment variable and run Restart Services. If you areinstalling a new version of SunSystems, then SUNSYS_TOMCAT_HOME is set during the installationprocess.

6 If required, run Restart Services.

Installing SQL Server ODBC driverNote: This step is not be required for a stand-alone installation because the ODBC driver is installedas part of the SQL Server installation.

Download Microsoft ODBC Driver 13 for SQL Server for Windows x64, for example x64\msodbcsql.msi. We recommend that you install this version or higher to ensure that security protocol TLS 1.2 issupported. SunSystems DeployAgent detects the highest version of ODBC driver installed and configuresSunSystems to use it.

Note: TLS 1.2 is supported by SunSystems. For security reasons, it is your responsibility to disablesecurity protocols TLS 1.0 and TLS 1.1 and earlier.

1 Open https://www.microsoft.com/en-us/download/details.aspx?id=50420

2 Select x64\msodbcsql.msi and click Next.

The download should start automatically.

3 Run msodbcsql.msi

Installing IIS Application Request Routing (ARR)Install IIS Application Request Routing 3.0 (x64) from the Microsoft website:

1 Open https://www.iis.net/downloads/microsoft/application-request-routing .

2 Click Install this extension.

3 Click Products on the Web Platform Installer 5.0 dialog.

Ensure that Application Request Routing 3.0 and URL Rewrite 2.0 are installed.

4 Close the Web Platform Installer 5.0 dialog.

Adobe Acrobat ReaderYou must download and install the latest version of Adobe Acrobat Reader from the Adobe website.


Prerequisite tasks

https://www.microsoft.com/en-us/download/details.aspx?id=50420

https://www.iis.net/downloads/microsoft/application-request-routing

Supported web browsersThese web browsers are supported:

• Microsoft Chromium Edge• Chrome• Safari 13 or later.Note: To access SunSystems online help using Safari, you must allow pop-up windows. Select Safari> Preferences, click Security and clear Block pop-up windows.


Prerequisite tasks

Chapter 3: Installing SunSystems

You must complete the installation checklist to ensure a successful installation of SunSystems.

Installation checklistTo install SunSystems, complete these tasks:

ReferencesTask✔

Downloading the installer onpage 21

Download and run the SunSystems SunSystems ISO

Running the installer on page21

Run the SunSystems installer.

Downloading the installerThe SunSystems ISO can be downloaded from the Infor download centre: https://infor.subscribenet.com

Note: You can run a product search for Infor SunSystems 6.4 and download SunSystems64.isoonto your server.

Running the installerInstallation of SunSystems in a stand-alone environment, including the installation of SunSystemsReporting, is completed in a single step.

Note: • If the installer does not load, open Task Manager. If the process mshta.exe is running, close it.• You must be connected to a Windows Domain when you install SunSystems.


Installing SunSystems

https://infor.subscribenet.com

https://infor.subscribenet.com

1 Execute setup.hta to run the SunSystems installer.

2 Click Install SunSystems Software > Next.3 Select Setup Type.

• Select Express to run a full stand-alone install, using predefined default settings. As part ofthis install option, you can update SQLExpress.xml with the locations of JDK, Apache Tomcatand other non-default settings.

• Select Complete to install all program features.

4 Click Next > Next > Install.5 Accept all default settings including the options to create the Security database.

6 Specify the SunSystems Java information:

JDK LocationBrowse to the location of your Java JDK installation. For example, C:\JavaPlatform\java\jdk-17

Apache Tomcat LocationBrowse to the location of your Tomcat installation, for example, C:\JavaPlatform\apache-tomcat-9.0.45\

7 Specify details for the service account.

Note: Using the Local System as the service account is not recommended for normal stand-aloneenvironments. If it must be used, it should be used in a test environment or for demonstrationpurposes. We recommend that a single tier environment is configured using local, or domain,accounts for secure access.

Note: We do not recommend that Local System is used as the service account for productiondeployments. Instead, we recommend that you use local or domain accounts for secure access.There are limitations as to how Local System can be added to groups so you must disable trustedgroup membership. The special **UNPROTECTED** string is specified instead of a group name.This enables any process to act like a trusted SunSystems service. It exposes the possibility thata user with network access could change data using the identity and permissions of another user.Therefore, production systems must never be deployed this way. Local System must only be usedto test an installation, or for demonstration purposes.

8 Accept the default settings for SunSystems Application Tier Ports.

9 Specify the SunSystems Reporting Account:

DomainSpecify your server

User nameSpecify SunSystemsReporting or your equivalent.

PasswordSpecify the password you entered when you created this user. The default is Infortemp01.

10 Accept all remaining default settings.

11 Click Install to complete the installation.


Installing SunSystems

Chapter 4: Post-installation tasks

You must complete these steps after a successful stand-alone installation of SunSystems:

ReferencesTask✔

Serializing SunSystems onpage 23

Serialize SunSystems.

Installing patch sets on page 23Install patch sets for SunSystems 6.4

Serializing SunSystemsTo serialize SunSystems, go to Windows File Explorer on your stand-alone server, and run theserialization file.

Installing patch setsThe latest patch sets must be applied to your SunSystems installation.

These are available from the Infor Support Portal.


Post-installation tasks

https://support.infor.com/allogin/allogin.aspx

Chapter 5: Configuring SunSystems

Complete these configuration tasks:

ReferencesTask✔

Adding SunSystems ReportingService Group membership onpage 24

Give SunSystems Reporting Service Group membershipto users

Configuring SunSystems DataModels in Report Models onpage 25

Configure SunSystems Data Models in Report Models

Adding SunSystems Reporting Service GroupmembershipSRS group membership is only required by SunSystems Reporting Service administrators. NormalSunSystems users do not require this membership to run ordinary reports:

1 Log in to User Manager as admin.

2 Select the Groups tab and edit group PK1.

3 Select Function Permissions > Select All and click Apply.

4 Select the Users tab.

5 Select a user that requires SRS group membership, for example, PK1. Right-click the user andselect Edit User.

6 Click Change. Expand SunSystems Reporting Users and select the SunSystems Reportingfunctions required for this user.

Note: Make a note of which users have been given the SunSystems Data Access Managers roleand the Report Manager role. These roles are required later.

7 Click OK to submit the amended group membership.


Configuring SunSystems

Configuring SunSystems Data Models in ReportModelsBefore using any reporting functions, you must use Report Models (RMD) to synchronize data models:

1 Log in to SunSystems as user ZZZ.

2 Click OK to create a menu.

3 Open Report Models using the shortcut RMD.

4 Select a business unit group and click Synchronize.

5 Wait until the status changes from Synchronizing to Synchronized.

Note: Before switching off standard authentication, you must have at least one SunSystems userwith access to User Manager. This user must be a Windows authenticated user with an administratorrole. If you switch off standard authentication in User Manager without this user, then refer to thechapter Administrative Access Recovery in the SunSystems 6.4 Multitier Installation Guide.


Configuring SunSystems

Chapter 6: Uninstalling SunSystems

You must use Programs and Features for a clean uninstallation.

Note: You may need to reboot the server as part of the uninstallation process.

1 Ensure all users have logged off, that all sessions are closed and all work has been saved.

2 Use the Language Deployer to uninstall all languages, apart from English.

Note: This step must be completed before uninstalling SunSystems.

3 Select Control Panel > Programs and Features. Or, run appwiz.cpl from the WindowsCommand prompt.

4 Select SunSystems 6.4.0 and click Uninstall.


Uninstalling SunSystems

Chapter 7: Glossary

A glossary of terms.

DefinitionTerm

Consists of all software elements that are in-stalled on the designated application server,namely the application layer.

application server component

A collection of SunSystems business units thatare stored in a single SunSystems database. Inother words, a SunSystems database is a busi-ness unit group. Business units must be unique;for example, you cannot have Business Unit AAApresent in more than one business unit group.

business unit group

A directory on SunSystems application serverand client machine, which contains all the logfiles that are generated by SunSystems. Files arecreated in relevant folders under the central logsrepository. For example: ProgramData\Infor\SunSystems\logs

central logs repository

Consists of all software elements that are in-stalled on the client PC. Security client, SunSys-tems client, and Reporting client are included inthe SunSystems client install.

client component

A collective term for the character set, code page,and sort order that is used for languages. Forexample, Latin1_General_Bin is the WesternEuropean default.

collation

The server hosting the RDBMS.database server component

An independent database in the SunSystemsdomain; a central repository that contains infor-mation to facilitate connections to multiple Sun-Systems databases of different code pagesthrough a single application server or applicationserver farm.

domain database


Glossary

DefinitionTerm

A protective channel through which all traffic be-tween a secured network and an unsecured net-work must pass.

firewall

A blanket term that covers the services, applica-tions, and features that control access to SunSys-tems programs and data.

SunSystems security

A collective term for the one-to-many applicationserver and SunSystems database installations,accessible through a client installation and man-aged through a central repository (domaindatabase). For example, a three-tier installation,or variations including an application server farmand access to multiple SunSystems databases.

SunSystems domain

An open SunSystems window. You can open upto nine sessions at a time.

SunSystems session


Glossary

Chapter 8: Troubleshooting

This section will assist system administrators in resolving problems that are encountered during theinstallation process, or when attempting to start SunSystems.

If the problem you are experiencing is not detailed below, you can contact technical support. Beforerequesting technical assistance, collate the information as described in Contacting Technical Support.

You can search for known issues in the Support Knowledgebase on the Infor Support Portal. Often asolution can be found here before contacting Support.

Contacting Infor Technical SupportIf you continue to experience problems, contact your designated Support Centre as outlined in yourSoftware Maintenance Agreement. If you are supported by Infor, go to the Infor Support Portal at https://concierge.infor.com and create a support incident.

You can search for known issues in the Support Knowledgebase on Infor Support Portal. Often asolution can be found here before contacting Infor Support.

When contacting Infor Support, you must provide:

• the SunSystems serial number and version number, which are displayed in SunSystems Help• the platform operating system version and service pack or patch level• the database and version• a brief description of the circumstances relating to the problem• details of the steps to replicate the problem• any saved error message files, as appropriate.

Troubleshooting hintsThere are several troubleshooting hints that will assist you when analyzing a problem:

• Take copies of error messages. They contain important information and technical support staff willrequire details.


Troubleshooting

https://concierge.infor.com

https://concierge.infor.com

• Do not assume too much about the possible cause of the problem, or you might overlook anyevidence.

• Work carefully through the problem and ensure that you can duplicate it. Assemble the evidencein readiness to pass it on to a member of the technical support staff.

• Confirm if the problem happens in other applications, on other user’s machines, or only on onemachine.

• Do not assume anything; check plugs, connections and cables.

Support Knowledgebase on the Infor Support PortalThis knowledgebase is maintained by Infor Technical Support and contains helpful information regardingproblems that may be encountered by customers implementing SunSystems. It is important to searchby the SunSystems version number.

General installation problemsAn error message or unexpected software behaviour are indicators of an installation problem. Themost likely causes are:

• Insufficient user credentials• Prerequisites not complete or correctly installed• Incorrect installation settings• Incorrect access control such as network settings or folder permissions• Incorrectly set IP address• Changes made to the registry settings that are used by SunSystems• Insufficient account permissions for database access• Insufficient service account where the Log on as a service role is not set.

About the setup program

Background settings are specified by the user and validated by the setup program, during installation.Changing a setting after installation will cause errors and unexpected behaviour in SunSystems.

The condition of an error, or unexpected response to a request, is described in an error message. Tosave the error message text to a file, click Save As. A member of technical support can then analyzethee contents of the file.

After saving an error message, you are given the option to continue working in SunSystems, or toabort. If you choose to continue, SunSystems operates normally as far as possible; if the error is toosevere, it aborts automatically.


Troubleshooting

Common problemsSpecific problems can be identified by a symptom, or error message. The most common problems arelisted in this section and include a description of possible causes and solutions.

Missing prerequisites

Where possible, the SunSystems installer checks and notifies the user if there are any missingprerequisites. In the event of an installation problem, check that all the prerequisites have been correctlyinstalled. Refer to the Prerequisite tasks on page 10.

Serialization error in a working SunSystemsStand-alone: what to do if you get an error in serialization and SunSystems appears to be working OK.Check TCPIP is activated in SQL Server Configuration Manager, or reboot.

Problem

An error occurs during serialization yet SunSystems seems to be working correctly.

Solution

Open Microsoft SQL Server Configuration Manager, and ensure TCP/IP is activated.

Alternatively, restart SunSystems.

Reports fail to load after applying a patch set

Problem

After applying a patch set, an error message appears stating that the reports failed to load and thatthey must be loaded manually.

Solution

1 Open the file InstallLog.log on completion of the patch set.2 Find the VisionImport command and take a copy of it.3 Run the VisionImport command from an administrator command prompt, using your administrator

password. For example: "C:\Program Files\Infor\SunSystems\VisionImport.exe"/U:admin /P:"******" /T:"/" /D:"C:\ProgramData\Infor\SunSystems\Reporting\Example Reports" /V:1 /O:YESNote: You must replace "******" with your administrator password that you use to log into UserManager.


Troubleshooting

Infor SunSystems Standalone Installation Guide

Documents

Transcript of Infor SunSystems Standalone Installation Guide