/sicsdocs/technical/desktop/installation_guide/ Recent content in SICS Installation Guide on Hugo -- gohugo.io /sicsdocs/technical/desktop/installation_guide/introduction/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/introduction/ Welcome to this SICS version! # This document describes the steps that must be followed in order to install SICS in your environment. On a high level, the installation procedure involves three main activities: SICS Software Installation This involves installing the SICS software (including documentation and various other system files), and Business Objects Reporting Universes after downloading from the SICS software delivery site. The installation of the SICS reporting tool (Business Objects) itself, is covered in a different document. /sicsdocs/technical/desktop/installation_guide/sics_software_installation/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/sics_software_installation/ Installation Overview # The installation of the SICS software is in three stages: Installation of the DBMS. Installation of the SICS System Administration Utility. Installation of each SICS client. This chapter describes only the installation of the software prior to setting up all of the database components. For subsequent configuration details see the relevant “Database Preparation” chapter for your database. In this document it is assumed that the SICS software is installed to the folder: /sicsdocs/technical/desktop/installation_guide/database_structure/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/database_structure/ The format of the SICS database has been designed to be as flexible as possible. Its structure has only been enforced where necessary, allowing for multiple configuration possibilities. The configuration at your site should be determined in advance by your DBA, based on your requirements and the specification of your Database Management System (DBMS). Note: Terminology in this chapter relates to Oracle. SQL Server does not have the concept of Instances, but the following text still applies. /sicsdocs/technical/desktop/installation_guide/database_prep/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/database_prep/ MS SQL Server # Please see Database Preparation for SQL Server. Oracle # Please see Database Preparation for Oracle. PostgreSQL # Please see Database Preparation for PostgreSQL. /sicsdocs/technical/desktop/installation_guide/co_existence_of_pc_life/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/co_existence_of_pc_life/ Sharing tables and data # Please see the System Administrator Guide for details. Installing a Combined P&C and Life Database # In order to prepare the database to be used by both products, the following procedure MUST be followed: Install both SICS P&C and SICS Life on the same (or two different) PCs Create tables and base data from the SICS Life System Administration Utility (as described in this document) Start the SICS P&C System Administration Utility and execute the following: Update Security Update Reference Data Update EDI Base Data Note that step 2 will create all tables for both the Life system and the P&C system. /sicsdocs/technical/desktop/installation_guide/appendix_a/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_a/ Using Unsupported Database Systems # The document Hardware and Software Requirements lists the kind of RDBMS (database systems) that are officially supported with SICS. DXC does not provide any assistance on installation, nor any bugfixing for unsupported database systems. /sicsdocs/technical/desktop/installation_guide/appendix_b/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_b/ Client Configuration # Configuration Files # SICS has several configuration files: Command line parameters Ini file settings Resource registry settings Log configuration Class loader configuration Command Line Parameters # See Appendix C - Command line parameters Ini File Settings # NOTE: This information does not apply to SICS API Server. Please see separate installation documentation for SICS API Server. The ini file settings serve to configure one or more login properties. /sicsdocs/technical/desktop/installation_guide/appendix_c/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_c/ Command Line Parameters # SICS Command Line Parameters # NOTE: This information does not apply to SICS API Server. Please see separate installation documentation for SICS API Server. This appendix describes the command line parameters that can be specified in the shortcut that starts the SICS system. SICS command lines follow this template with 6 elements: <Path to JRE><JRE arguments><Main class><Target type><Product><SICS application command line arguments> Element Description <Path to JRE> Path to the Java runtime. /sicsdocs/technical/desktop/installation_guide/appendix_d/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_d/ Logging of SQL Statements # SICS reads and modifies database information using SQL statements via the JDBC standard interface. For debugging and performance measurement purposes, it may be of interest to review all SQL statements issued by SICS against the database. To do so, one must activate SQL logging. There are two options available: Global activation. This is done in the configuration file log4j2.xml (see Log Configuration above) and will affect all users running SICS from this installation location. /sicsdocs/technical/desktop/installation_guide/appendix_e/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_e/ Password Handling in Oracle # When using SICS with an Oracle database the user can change his or her password when logging into SICS, assuming the password is not already expired. This feature can be used in combination with user account settings in Oracle such as password lifetime and password validation. Any error message issued by Oracle during login will be presented to the SICS user. The relevant Oracle error messages are: /sicsdocs/technical/desktop/installation_guide/appendix_f/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_f/ Password Encryption # The database connection password may be encrypted. In the SICS installation folder, there is a file named encrypt.bat. This bat file takes a plain-text string (the password) as input, calls a SICS utility program and outputs an encrypted version of the string. This encrypted value will always be prefixed with % so as to later recognize it as an encrypted value. The encrypted password can be provided in the command line password field and/or the ini file settings password field, see above. /sicsdocs/technical/desktop/installation_guide/appendix_g/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_g/ Running SICS Scheduler as a Windows Service # SICS Scheduler may be run as a Windows service using the wrapper functionality provided by Apache commons daemon. This applies only when starting the scheduler in unattended mode (using one of the -b options, see Appendix C - Command line parameters). Initial Installation # The SICS System Administration Utility must be installed in a local drive on the computer. The System Administration Utility must be configured to use only resources on local drives on the computer. /sicsdocs/technical/desktop/installation_guide/appendix_h/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_h/ Splash Screen Branding # The SICS splash screen is graphic shown while SICS loads. This graphic contains a background image and the DXC logo. During the loading process, the SICS version and build information is painted on this graphic to inform the user which version of SICS is loading. The background graphic image changes annually and as part of creating the new graphic, the position of the DXC logo and the SICS version information may change. /sicsdocs/technical/desktop/installation_guide/appendix_i/ Mon, 01 Jan 0001 00:00:00 +0000 /sicsdocs/technical/desktop/installation_guide/appendix_i/ Setting Additional Database Connection Properties # JDBC Connection parameters can be added to configure different aspects of the connection to the database. Configuration properties are platform specific and not common across DB platforms. For some DB platforms, JDBC connection properties can be provided as part of the connection URL (configured with the <dataSource> tag in sics-database-sources.xml). It is also possible - for all DB platforms - to configure JDBC connection properties on the command line and/or with the <additionalJdbcConnectionProperties> tag in sics-database-sources.