Aktualisierungsinstruktionen von R2.x auf R3.0 SSK / BSV eahv/iv Version: 1.0 Publication Date: 08. April 2011
Akutalisierung Instruktionen für 3.0 Draft Version COPYRIGHT Copyright - 2011 Cambridge Technology Partners. All Rights Reserved. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system or translated into any language in any form by any means without the written permission of Cambridge Technology Partners SA. While every precaution has been taken in the preparation of this document, Cambridge Technology Partners assumes no responsibility for errors, omissions, or for damages resulting from the use of the information herein. Products or corporate names may be trademarks or registered trademarks of other companies and are used only for the explanation and to the owner's benefit, without intent to infringe. Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 2 / 11
Draft Version Akutalisierung Instruktionen für 3.0 INHALTSVERZEICHNIS 1 FÜR R3.X... 5 1.1 ZWECK DES DOKUMENTS... 5 1.2 ÜBERSICHT... 5 1.3 AKTUALISIERUNG... 5 2 MYSQL... 7 2.1 AUSFÜHRUNG... 7 2.2 SQL SKRIPT... 7 3 ORACLE... 8 3.1 AUSFÜHRUNG... 8 3.2 SQL SKRIPT... 8 4 MICROSOFT SQL SERVER... 9 4.1 AUSFÜHRUNG... 9 4.2 SQL SKRIPT... 9 Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 3 / 11
Akutalisierung Instruktionen für 3.0 Draft Version DOKUMENTENVERWALTUNG Historie Version Geändert Beschreibung Datum Validator 1.0 Sylvain Berthouzoz 25.01.2011 SM 1.1 Andreas Doebeli Updated SQL Scripts 09.05.2011 Referenzen ID Name Version Dokument 01 Installations-Handbuch V2.0 Installations-Handbuch_sM-Client_2.0.pdf Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 4 / 11
FÜR R3.x 1 FÜR R3.X 1.1 Zweck des Dokuments Das nachfolgende Dokument beschreibt sämtliche notwendigen Installationsschritte und Konfigurationen, um den sm-client von R2.x auf R3.0 (Release 2011 April) zu aktualisieren. Sollten Sie eine ältere Version des sm-client verwenden, müssen sie zuerst auf die Version 2.x aktualisieren. Im Release 3.0 sind die wichtigsten Neuheiten: die Einführung der Multi-Domainfähigkeit der Selbstversand. Die Möglichkeit, ein Skript auszuführen für jede empfangene Meldungen. Die Multi-Domainfähigkeit erlaubt den sm-client verschiedene Prozesse zu unterstützen. Im Release 3.0 wurden als erste zusätzliche Domain die eschkg Meldungen implementiert. 1.2 Übersicht Die Aktualisierung des sm-clients erfordert verschiedene Installationsschritte. Es werden Windows-, Linux- und Unix-Betriebssysteme unterstützt. Es sind folgende Teile zu aktualisieren: sm-client WAR-File (Optional) config.properties sm-client Datenbank 1.3 Aktualisierung 1) JBoss oder Tomcat stoppen 2) Datenbank mittels Ausführung des Skript aktualisieren. Siehe dafür den Kapiten entsprechend ihre Datenbank (MySQL, Oracle oder MS SQL Server) 3) Optional. Skript konfigurieren, Siehe Installationshandbuch v.1.8 Kap 4.2.2.6 4) Optional. Konfiguration von eschkg Meldungen Siehe Installationshandbuch v.1.8 Kap 4.6 5) Optional. Konfigurieren Sie den Property print.message.smaller in Ihrem config.properties. Standardwert ist 2048 (in KB). Meldungen, wo den message.xml grösser als diesen Wert ist, werden nicht gedruckt. (Siehe Installationshandbuch v.1.8 Kap 4.2.2.1) 6) Überprüfen Sie die Konfiguration des Arbeitsspeichers. Es muss mindestens -Xms512m Xmx1024m -XX:MaxPermSize=512m. (Siehe Installationshandbuch v.1.8 Kap.4.1.2) Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 5 / 11
FÜR R3.x 7) WAR-Datei ersetzen a. alte Version von smclient.war löschen von JBOSS_HOME/Server/default/deploy oder TOMCAT_HOME/webapps b. neue Version herunterladen. (smclient-r3.0.0.war for mysql) c. WAR-File ins Verzeichnis JBOSS_HOME/Server/default/deploy kopieren oder im TOMCAT_HOME/webapps und im smclient.war umbenennen für Tomcat 8) JBoss oder Tomcatstarten Bitte beachten Sie, dass bei einem Download mittels Internet Explorer, die File-Extension von.war auf.zip geändert werden kann. In diesem Falle ist nach erfolgtem Download einfach die Endung wieder in.war zu ändern. Das heruntergeladene File darf nicht mittels Win-Zip (oder ähnlichen Programmen) ausgepackt werden. Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 6 / 11
MySQL 2 MYSQL Das MySQL Skript update-smclient-2.x_3.0-mysql.sql muss mittels den mysql Client ausgeführt werden. Datei update-smclient-2.x_3.0-mysql.sql öffnen und editieren. 1) Wenn die Datenbank nicht smclient heisst, editieren Sie die folgende Zeile: use smclient; 2.1 Ausführung Eine Kommando-Fenster an der Stelle öffnen, wo das Skript liegt und dann das mysql-programm ausführen (Ändern Sie den Benutzername, falls nötig): mysql u smclientuser -p Skript ausführen mysql> source update-smclient-2.x_3.0-mysql.sql 2.2 SQL Skript -- update-smclient-2.x_3.0-mysql.sql -- Syntax is for mysql query with mysql program use smclient; CREATE TABLE `domain` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `name` varchar(255) NOT NULL, PRIMARY KEY (`id`), UNIQUE KEY `name` (`name`)); insert into domain (name) values ('smclient'); ALTER TABLE configuration ADD `domain_id` BIGINT(20) NOT NULL DEFAULT '0'; update configuration set domain_id = (select id from domain where name like 'smclient') where domain_id is null or domain_id = 0; ALTER TABLE configuration DROP PRIMARY KEY; ALTER TABLE configuration ADD PRIMARY key(`sedexid`, `keycolumn`, `domain_id`); alter table ProcessMapping add processname varchar(25) not null default ''; update ProcessMapping PM, JBPM_PROCESSDEFINITION PD, JBPM_PROCESSINSTANCE PI set processname = NAME_ where PM.processId = PI.ID_ AND PI.PROCESSDEFINITION_ = PD.ID_ and (processname is null or processname like ''); UPDATE JBPM_PROCESSDEFINITION SET NAME_ = 'receive-process' WHERE NAME_ LIKE 'receive'; -- Uncomment the next line if the underlying mysql don't use auto_commit -- commit; Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 7 / 11
Oracle 3 ORACLE Das sqlplus Skript update-smclient-2.x_3.0-oracle muss mittels des sqlplus Client ausgeführt werden. 3.1 Ausführung Eine Kommando-Fenster an der Stelle öffnen, wo das Skript liegt und dann das sqlplus-programm ausführen (Ändern Sie den Benutzernamen, wenn nötig): sqlplus Dann Benutzername und Passwort eingeben Benutzernamen eingeben: smclient Kennwort eingeben: SQL Skript ausführen SQL> @update-smclient-2.x_3.0-oracle.sql 3.2 SQL Skript -smclient-2.x_3.0-oracle.sql -- Syntax is for SQLPLUS query CREATE TABLE domain ( id NUMBER(19,0) NOT NULL PRIMARY KEY, name VARCHAR2(255 CHAR) NOT NULL, UNIQUE (name) ); insert into domain (id,name) values (1,'smclient'); ALTER TABLE configuration ADD domain_id NUMBER(19,0) DEFAULT 0; UPDATE configuration SET domain_id = (SELECT id FROM domain WHERE name LIKE 'smclient') WHERE domain_id IS NULL OR domain_id = 0; ALTER TABLE configuration DROP PRIMARY KEY; ALTER TABLE configuration ADD PRIMARY key(sedexid, keycolumn, domain_id); ALTER TABLE processmapping ADD processname VARCHAR2(25 CHAR) DEFAULT 'default' not null; UPDATE processmapping t SET processname = (SELECT NAME_ FROM JBPM_PROCESSDEFINITION PD, JBPM_PROCESSINSTANCE PI, processmapping PM WHERE PM.processId = PI.ID_ AND PI.PROCESSDEFINITION_ = PD.ID_ AND t.processid = PM.processId) where processname is null or processname like 'default'; UPDATE JBPM_PROCESSDEFINITION SET NAME_ = 'receive-process' WHERE NAME_ LIKE 'receive'; commit; Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 8 / 11
Microsoft SQL Server 4 MICROSOFT SQL SERVER Das SQL Skript update-smclient-2.x_3.0-mssql muss mit dem Mircrosoft SQL Query Tool (Microsoft SQL Server Management Studio für die 2008 Version) geöffnet werden. Die Datei update-smclient-2.x_3.0-mssql öffnen, Benutzername, Kennwort und Datenbank eingeben. 4.1 Ausführung Klicken sie auf den Execute Button (dies ist F5 in der Version 2008) 4.2 SQL Skript -smclient-2.x_3.0-mssql.sql -- Syntax is for SQL Server begin transaction CREATE TABLE domain ( id BIGINT NOT NULL IDENTITY(1,1), name VARCHAR(255) NOT NULL, PRIMARY KEY (id), UNIQUE (NAME) ); insert into domain (name) values ('smclient'); DECLARE @executestring nvarchar(max); SET @executestring = 'ALTER TABLE CONFIGURATION ADD DOMAIN_ID BIGINT NOT NULL DEFAULT ''0'';'; SET @executestring = 'update configuration set domain_id = (select id from domain where name like ''smclient'') where domain_id is null or domain_id = 0;'; DECLARE @pkname varchar(max); SET @pkname = (SELECT [name] FROM sysobjects WHERE [xtype] = 'PK' AND [parent_obj] = OBJECT_ID(N'[dbo].[' + 'configuration' + ']')); SET @executestring = 'alter table configuration drop constraint [' + @pkname + '];'; SET @executestring = 'ALTER TABLE configuration ADD CONSTRAINT PK_configuration PRIMARY KEY (sedexid, keycolumn, domain_id);'; SET @executestring = 'ALTER TABLE PROCESSMAPPING ADD processname VARCHAR(25) DEFAULT '''' not null;'; Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 9 / 11
Microsoft SQL Server SET @executestring = 'UPDATE PROCESSMAPPING SET processname = (SELECT NAME_ FROM JBPM_PROCESSDEFINITION PD, JBPM_PROCESSINSTANCE PI, PROCESSMAPPING PM WHERE PM.PROCESSID = PI.ID_ AND PI.PROCESSDEFINITION_ = PD.ID_ AND PROCESSMAPPING.PROCESSID = PM.PROCESSID) where processname is null or processname like '''';'; UPDATE JBPM_PROCESSDEFINITION SET NAME_ = 'receive-process' WHERE NAME_ LIKE 'receive'; commit; Erstellt: 25. Januar 2011 von Cambridge Technology Partners 2011 10 / 11
Cambridge Technology Partners (Switzerland) S.A. Nyon 27 Ch. de Précossy CH-1260 Nyon Tel: +41 (0)22 306 4646 Fax: +41 (0)22 306 4647 Zurich Imperial 4th floor Leutschenbachstrasse 41 8050 Zürich Tel: +41 (0)43 456 2300 Fax: +41 (0)43 456 2301 Basel Barfüsserplatz 3 CH-4051 Basel Tel: +41 (0) 61 271 9140