Perceptive Process Enterprise - UNIX-installatie

Perceptive Process Enterprise - UNIX-installatie

Datum: maart 2014 Versie: 3.1 2014 Perceptive Software. Alle rechten voorbehouden. Perceptive Software is een gedeponeerd handelsmerk van Lexmark International Technology S.A. in de VS en andere landen. Alle overige merken en productnamen in dit document zijn handelsmerken of gedeponeerde handelsmerken van de respectieve eigenaren. Niets uit dit document mag worden verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand of openbaar worden gemaakt, in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, door fotokopieën, opnamen of op enige andere wijze die nu of in de toekomst kan worden gebruikt, zonder voorafgaande schriftelijke toestemming van Lexmark.

Inhoudsopgave 1 Perceptive Process... Enterprise installeren op UNIX 4 1.1 Voordat u begint met... installeren 4 1.2 Perceptive Process... Enterprise installeren 6 1.3 Perceptive Process... Enterprise configureren 9 1.4 Documentatie installeren... 12 2 Additionele componenten... en demo-cases installeren 14 2.1 Additionele componenten... en demo-cases installeren 15... 15 2.1.1 CHIP hulpprogramma's voor de commandoregel installeren... 15 2.1.2 JAVA SDK installeren... 16 2.1.3 Demo-cases installeren 2.2 Additionele componenten... verwijderen 18 2.3 Demo-cases verwijderen... 19 Inhoudsopgave

1 Perceptive Process Enterprise installeren op UNIX 1.1 Voordat u begint met installeren Installatie van Perceptive Process Enterprise op Unix U staat op het punt om Perceptive Process Enterprise te installeren op een computer met een Unixbesturingssysteem dat wordt ondersteund door Perceptive Process. Installatie starten Start het installatieprogramma vanuit een terminal of een terminal emulator. Installatie afbreken U kunt de installatie op elk gewenst moment afbreken door middel van CTRL + C. De onderdelen die al zijn geïnstalleerd op het moment van afbrek en, worden hierdoor niet automatisch verwijderd. Wilt u de installatie opnieuw uitvoeren, verwijder dan eerst de al geïnstalleerde bestanden. Help tijdens het installeren Tijdens de installatie kunt u hulp opvragen door een vraagteken (?) in te typen op de invoerregel. Nadat u de help-informatie hebt opgevraagd kunt u de gewenste gegevens invoeren om de installatie te vervolgen. Voorwaarden vóór installatie De volgende voorwaarden zijn van belang voor het correct verlopen van de installatie. Controleer deze voorwaarden vóór dat u gaat installeren. Raadpleeg eventueel uw systeembeheerder. Voorwaarde De bestanden van Perceptive Process Enterprise moeten zich op één server bevinden en mogen niet zijn verdeeld over meerdere servers. Het is mogelijk Perceptive Process Enterprise op een SAN te installeren. Een aantal TCP/IP-poorten wordt door Perceptive Process Enterprise gebruikt. Het betreft de poorten: 4949 (Client Port; gebruikt door de client). 4994 (Master Port; gebruikt door de server). 5000 (HTTP Port; gebruikt door de webserver). Wanneer deze poorten door andere toepassingen op uw systeem worden gebruikt, kan dit leiden tot conflicten. Perceptive Process Enterprise installeren op UNIX 4

De poorten zijn tijdens de installatie nog niet van belang, maar voor het configureren (First Time Use) wel. Het poortnummer van de masterpoort is vastgelegd in de Perceptive Process Enterprise licentie. Als u een ander poortnummer voor de masterpoort wilt, moet u dit doorgeven bij het aanvragen van een (eventueel nieuwe) licentie. Iedere Unix-gebruiker kan de installatie van Perceptive Process Enterprise uitvoeren. Er zijn geen specifieke rechten voor nodig. Het is wel aan te raden de installatie te laten uitvoeren door de Unixgebruiker die ook Perceptive Process Enterprise beheerder wordt. De Oracle-database moet vóór de configuratiefase gemaakt zijn. Dit kunt u eventueel doen door bij de setup te kiezen voor optie 8. Create a minimal DB for Perceptive Process. Hierbij wordt een Oracle-database gecreëerd met de minimale eisen die worden gesteld voor het werken met Perceptive Process. Wanneer u de setup hiervoor niet gebruikt, raadpleeg dan de documentatie bij de DBMS-software. Perceptive Process Enterprise installeren op UNIX 5

1.2 Perceptive Process Enterprise installeren Perceptive Process Enterprise installeren Voer de volgende stappen uit om de installatie van Perceptive Process Enterprise te starten. Raadpleeg bij problemen de logbestanden die worden aangemaak t tijdens de installatie (in de log directory van de Perceptive Process service). Als u na een probleem de installatie wilt hervatten, adviseren wij om iht opnieuw te starten (door op de commandoregel /<bpm-directory>/bin/bpmctl restart te typen). 1 Download het installatiebestand van Perceptive Process Enterprise van het Klantenportaal. 2 Start het installatiescript. Een overzicht van de installatiestappen verschijnt. De volgende stappen verlopen automatisch: Extract package Check version Check install user 3 Doe het volgende bij de vraag Do you want to install as yourself [user name]?: Druk op ENTER als u de huidige gebruiker wilt accepteren, of geef een andere gebruiker op. 4 Beantwoord de vragen die verschijnen bij de laatste de stap, Generic questions. 5 Als Enter Perceptive Process program installation directory verschijnt: Druk op ENTER als u de programmabestanden in de standaardlocatie wilt installeren, of geef de gewenste locatie op. 6 Als Enter Perceptive Process data directory verschijnt: Druk op ENTER als u de gegevensbestanden in de standaardlocatie wilt installeren, of geef de gewenste locatie op. 7 Als Enter the UNIX group owner for all files verschijnt: Druk op ENTER als u de standaard wilt gebruiken, of geef de naam van een geldige Unix user group. Dit is dezelfde groep als waarvan de administratieve gebruik er lid is. 8 Als Enter the port for HTTP/WEB configuration verschijnt: Perceptive Process Enterprise installeren op UNIX 6

Druk op ENTER als u de standaard wilt gebruiken, of kies een andere poort. 9 Als Enter password used for HTTP/WEB configuration verschijnt: Druk op ENTER als u de standaard wilt gebruiken, of kies een ander wachtwoord. Het standaard wachtwoord is 'admin'. De volgende stappen verlopen automatisch: install create initial configuration start "first time use" server Het installatiegedeelte is nu afgerond en bij de laatste stap wordt het vervolg gestart: het configuratieproces (iht). Deze configuratiefase heet First Time Use. U configureert Perceptive Process Enterprise in een browser via het adres: http://<naam server>:5000. Als u het configuratieproces First Time Use nu niet uitvoert, kunt u dit proces later starten door op de opdrachtregel /<bpm-directory>/bin/bpmctl -s restart in te voeren. Configuratiewachtwoord wijzigen Tijdens het installeren wordt een combinatie van gebruikersnaam en wachtwoord aangemaakt, die standaard beiden de waarde 'admin' hebben. Deze gebruikersnaam en het wachtwoord worden alleen gebruikt tijdens de First Time Use configuratiefase. Hierna wordt deze combinatie niet meer gebruikt. Wanneer u niet direct met de configuratiefase start, kunt u uit veiligheidsoverwegingen direct na installatiefase het wachtwoord voor deze gebruiker veranderen. Voer de volgende stappen uit om het configuratiewachtwoord te wijzigen. 1 Open het bestand <program data>/etc/confpass in een text-only editor (een editor voor platte tekst). 2 Vervang het wachtwoord 'admin' door het wachtwoord van uw keuze, en sla het bestand op. Padvariabele aanpassen Als u na de installatie gebruik wilt maken van bijvoorbeeld het installeren van case types (demo cases) of Perceptive Process Enterprise installeren op UNIX 7

andere administratieve handelingen wilt uitvoeren vanaf de command line (werken met econf), dan kunt u de PATH variabele in uw shell profile aanpassen door het pad toe te voegen naar de /bin directory vanaf de locatie waar u Perceptive Process hebt geinstalleerd. Bijvoorbeeld: PATH=$PATH:/usr/local/bpm/bin Perceptive Process Enterprise installeren op UNIX 8

1.3 Perceptive Process Enterprise configureren Perceptive Process instellen voor het eerste gebruik Het configureren van Perceptive Process gebeurt in een aantal stappen vanuit de internetbrowser en heet First Time Use. Voer de volgende stappen uit om First Time Use te starten. U ziet de Perceptive Process Portal met in het menu System Control de optie First time use geopend. Dit venster toont de stappen die u moet uitvoeren om Perceptive Process gebruiksklaar te maken. De actuele stap wordt aangegeven door het pictogram. 1 To start First Time Use, complete the following steps. 1 Typ bij Name: admin 2 Typ bij Password: admin 3 Klik op Sign In 2 Voer de volgende stappen uit om het licentiebestand te uploaden. 1 Klik op Browse... en navigeer naar het licentiebestand. 2 Selecteer het licentiebestand en klik op Open. 3 Klik op Continue om verder te gaan. 3 Voer de volgende stap uit om het DBMS-type te selecteren. 1 Onder Please choose your type of DBMS and enter the configuration settings geeft u aan welk type DBMS u gaat gebruiken, voor Unix is dit Oracle. Perceptive Process Enterprise installeren op UNIX 9

Raadpleeg eventueel het document Ondersteunde platformen voor ondersteunde databasetypen en -versies. 4 Voer de volgende stap uit om de database te configureren. 1 Voor het configureren van de Oracle-database: raadpleeg de paragraaf Oracle database configureren. Wanneer u een Oracle-database gebruik t, k unt u alleen een reeds bestaande database gebruik en. Deze database moet aangemaak t zijn voordat u Perceptive Process gaat installeren. 5 Voer de volgende stappen uit om een database aan te maken of een bestaande database te gebruiken. 1 Wanneer de database gevuld is wordt u de mogelijkheid gegeven om die te legen. 2 De database wordt gevuld, ofwel gecontroleerd en in gebruik genomen. 6 Voer de volgende stappen uit om Perceptive Process Server in te stellen. 1 Kies bij Language de taal die de server hanteert. Dit is de taal die betrekking heeft op teksten tussen de server en Perceptive Process toepassingen worden uitgewisseld, zoals bijvoorbeeld logbestanden. 2 Vul bij Master Port eventueel een ander poortnummer in, bijvoorbeeld wanneer de standaard poort al in gebruik is. 3 Vul bij Client Port eventueel een ander poortnummer in, bijvoorbeeld wanneer de standaard poort al in gebruik is. 4 Klik op Continue. 7 Voer de volgende stappen uit om de Perceptive Process service te configureren. 1 Typ bij Name of the top context desgewenst een andere naam. Dit is het hoogste niveau van de organisatiestructuur die binnen Perceptive Process wordt opgezet. Hier wordt standaard de naam van de organisatie ingevuld. Perceptive Process Enterprise installeren op UNIX 10

Achter User name ziet u de gebruikersnaam van de gebruiker die in Perceptive Process wordt toegevoegd als eerste administratieve gebruiker (contextbeheerder). 2 Typ bij Full name de volledige naam van de gebruiker. 3 Typ bij Password het wachtwoord waarmee de gebruiker zich aanmeldt in Perceptive Process. 4 Typ bij Confirm password nogmaals het wachtwoord. Negeer de optie Use the LocalSystem account to start the Perceptive Process service. 5 Klik op Continue. 6 Als u Perceptive Process meteen wilt gebruiken: klik op Continue. Perceptive Process Portal wordt gestart. Als u Perceptive Process niet meteen wilt gebruiken: deselecteer de optie Open Perceptive Process Portal automatically en klik vervolgens op Continue. First time use wordt afgesloten. U k unt Perceptive Process ook vanuit uw internetbrowser starten. Voer de volgende stappen uit om dit te doen. Start uw internetbrowser Typ http://<computernaam>:5000 in de adresbalk. Perceptive Process Enterprise installeren op UNIX 11

1.4 Documentatie installeren Documentatie in andere talen dan Engels installeren Standaard bevatten installaties van Perceptive Process in andere talen dan Engels (Verenigde Staten) geen gebruikersdocumentatie. Om gebruikersdocumentatie te installeren in een van de andere ondersteunde talen, moet u de documentatiebestanden voor die taal downloaden. In Perceptive Process kan de gebruiker dan in het menu Opties de taal selecteren en vervolgens in het menu Help de documentatie in de geselecteerde taal openen. U kunt de documentatie in meer dan een taal installeren. Voer de volgende stappen uit om de documentatie in een taal te installeren. 1 Download de volgende bestanden van het Klantenportaal: Perceptive Process Enterprise 3.1 - doc_userguide_web_manual_pdf_[language code].zip Perceptive Process Enterprise 3.1 - doc_serverguide_web_manual_pdf_[language code].zip Perceptive Process Design 3.1 - doc_designuserguide_web_manual_pdf_[language code].zip Perceptive Process Enterprise 3.1 - doc_htmluserguide_web_manual_html_[language code]. zip en sla de bestanden op in een tijdelijke locatie op uw computer. De 'taalcode' is de code van de taal van de documentatie die u wilt installeren in Perceptive Process. 2 Maak een directorystructuur voor de documentatie. In alle volgende stappen is 'taalcode' de code van de bestanden die u hebt gedownload bij 1, bijvoorbeeld de-de. 1 Ga naar de datadirectory. Standaard is dit: /web/manual 2 Selecteer de directory manual en maak de volgende subdirectory's: pdf html 3 Selecteer de directory pdf en maak de volgende subdirectory: Perceptive Process Enterprise installeren op UNIX 12

[taalcode] 4 Selecteer de directory html en maak de volgende subdirectory: [taalcode] 3 Voer de volgende stappen uit om de documentatie als PDF-bestanden te installeren. 1 Kopieer de volgende bestanden: Perceptive Process Enterprise 3.1 - doc_userguide_web_manual_pdf_[language code].zip Perceptive Process Enterprise 3.1 - doc_serverguide_web_manual_pdf_[language code].zip Perceptive Process Design 3.1 - doc_designuserguide_web_manual_pdf_[language code].zip vanuit de tijdelijke locatie naar de volgende directory: /web/manual/pdf/[taalcode] 2 Pak de bestanden uit in de directory /web/manual/pdf/[language code]. 3 Verwijder de.zip-bestanden. 4 Voer de volgende stappen uit om de documentatie als online Help te installeren. 1 Kopieer het bestand: Perceptive Process Enterprise 3.1 - doc_htmluserguide_web_manual_html_ [language code].zip vanuit de tijdelijke locatie naar de volgende directory: /web/manual/html/[language code] 2 Pak het bestand uit in de directory /web/manual/html/[language code]. 3 Verwijder het.zip-bestand. Perceptive Process Enterprise installeren op UNIX 13

2 Additionele componenten en demo-cases installeren Inleiding Perceptive Process is een webbased servertoepassing. U installeert Perceptive Process op een server, waarna u via een webbrowser op elke willekeurige computer de toepassing kunt benaderen. Met additionele componenten en demo-cases kunt u functionaliteit toevoegen aan Perceptive Process. U kunt deze componenten downloaden van het Klantenportaal van Perceptive Software. Additionele componenten De volgende componenten zijn op beschikbaar voor installatie op een Perceptive Process client computer: Client Tools: command line tools waarmee het mogelijk is om vanuit de command line bepaalde Perceptive Process client-bewerkingen uit te voeren. Client Tools k unt u met name gebruik en bij integratie met andere systemen, zoals web-integratie of mail-integratie. Als u hier geen gebruik van maak t is het niet nodig deze te installeren. Client Tools bestaan uit: CHIP hulpprogramma's voor de commandoregel. JAVA SDK (Perceptive Process Software Development Kit) - een platformonafhankelijke component waarmee het mogelijk is toepassingen te integreren met Perceptive Process. Demo-cases Demo-cases zijn kant en klare cases die kunnen worden gebruikt in Perceptive Process voor trainingen of demo's. Er zijn drie demo-cases: Motor claim Form demo Format constructor Voor meer informatie over de op aanvraag beschikbare componenten kunt u contact opnemen met Perceptive Software Product Support. Additionele componenten en demo-cases installeren 14

2.1 Additionele componenten en demo-cases installeren Onderwerpen in dit gedeelte Dit zijn de onderwerpen die in dit gedeelte van de documentatie aan de orde komen: Notificatie van nieuw werk installeren CHIP hulpprogramma's voor de commandoregel installeren COM integratiecomponent installeren JAVA SDK installeren Demo-cases installeren 2.1.1 CHIP hulpprogramma's voor de commandoregel installeren CHIP hulpprogramma's voor de commandoregel installeren Voer de volgende stappen uit om de CHIP hulpprogramma's voor de commandoregel te installeren. 1 Download het bestand Perceptive Process Enterprise 3.1 - SDK and tools.zip van het Klantenportaal en sla het op in een tijdelijke locatie op uw computer. 2 Pak het zip-bestand uit in een willekeurige directory. Deze directory wordt aangeduid als [installatielocatie]. De CHIP hulpprogramma's voor de commandoregel bevinden zich in de directory [installatielocatie]/clienttools/ [besturingssysteem]/chp/bin. Selecteer de juiste directory [besturingssysteem] voor het besturingssysteem dat u gebruikt. 3 U kunt de directory [installatielocatie]/clienttools/windows_nt directory verwijderen. Deze directory is niet van toepassing op uw besturingssysteem. U kunt daarnaast, afhankelijk van uw besturingssysteem, de directory [installatielocatie]/clienttools/aix of de directory [installatielocatie]/clienttools/linux verwijderen. 2.1.2 JAVA SDK installeren Voorwaarde De JAVA SDK heeft de bestanden flowchip.jar en flowchipux.jar nodig. Deze bestanden zijn aanwezig in een serverinstallatie van Perceptive Process en bevinden zich in de installatiedirectory van Additionele componenten en demo-cases installeren 15

Perceptive Process in de subdirectory /server/web/client/jar. JAVA SDK installeren Voer de volgende stappen uit om de JAVA SDK (Software Development Kit) te installeren. Step Action 1 Download het bestand Perceptive Process Enterprise 3.1 - SDK and tools for Java.zip van het Klantenportaal en sla het op in een tijdelijke locatie op uw computer. 2 Pak het zip-bestand uit in een willekeurige directory. Deze directory wordt aangeduid als [installatielocatie]. De JAVA SDK bevindt zich in de directory [installatielocatie]. 3 Lokaliseer de bestanden flowchip.jar en flowchipux.jar en kopieer beide bestanden naar de directory [installatielocatie]. De documentatie van de JAVA SDK bevindt zich in de directory [install location]/javadoc. 2.1.3 Demo-cases installeren Demo-cases installeren Voer de volgende stappen uit om de demo-cases te installeren. De demo-cases die worden geïnstalleerd zijn: FormatConstructor, FormDemo and MotorClaim. Daarnaast worden de modules: FormDemo, frmt and modmotor geïnstalleerd. Deze modules ondersteunen de geïnstalleerde demo-cases. 1 Download het bestand Perceptive Process Enterprise 3.1 - Demo Case Types.zip van het Klantenportaal en sla het op in een tijdelijke locatie op uw computer. 2 In het Perceptive Process Portal menu, klik op Beheer en vervolgens op Casetype vrijgeven. 3 Klik op de knop Choose file en selecteer het bestand Perceptive Process Enterprise 3.1 - Demo Case Types.zip. Additionele componenten en demo-cases installeren 16

4 Klik op de knop Vrijgeven. 5 Wacht totdat in het venster een lijst met berichten verschijnt. 6 Open of ververs de Verkenner om de geïnstalleerde casetypen en modules te zien. Additionele componenten en demo-cases installeren 17

2.2 Additionele componenten verwijderen CHIP hulpprogramma's voor de commandoregel verwijderen Voer de volgende stappen uit om de CHIP hulpprogramma's voor de commandoregel te verwijderen. 1 Ga naar de [installatielocatie]. Zie CHIP hulpprogramma's voor de commandoregel installeren. 2 Ga naar de directory [installatielocatie]/clienttools/ [besturingssysteem]. Selecteer de juiste directory [besturingssysteem] voor het besturingssysteem dat u gebruikt. 3 Verwijder de directory [installatielocatie]/clienttools/ [besturingssysteem]/chp, inclusief alle subdirectory's. JAVA SDK verwijderen Voer de volgende stappen uit om JAVA SDK te verwijderen. 1 Ga naar de [installatielocatie]. Zie JAVA SDK installeren. 2 Verwijder de directory's [install location]/javadoc en [install location]/nl. 3 Verwijder de bestanden flowchip.jar en flowchipux.jar. Additionele componenten en demo-cases installeren 18

2.3 Demo-cases verwijderen Demo-cases verwijderen Voer de volgende stap uit om de demo-cases te verwijderen. De demo-cases die worden verwijderd zijn: FormatConstructor, FormDemo and MotorClaim. De modules die deel uitmak en van de geïnstalleerde demo-cases: FormDemo, frmt and modmotor, k unnen niet worden verwijderd. 1 Verwijder de casetypen van de demo-cases in de Verkenner. Additionele componenten en demo-cases installeren 19