Omnis Data Bridge The software this document describes is furnished under a license agreement. The software may be used or copied only in accordance with the terms of the agreement. Names of persons, corporations, or products used in the tutorials and examples of this manual are fictitious. No part of this publication may be reproduced, transmitted, stored in a retrieval system or translated into any language in any form by any means without the written permission of Raining Data. Raining Data Corporation, and its licensors 2005. All rights reserved. Portions Copyright Microsoft Corporation. Omnis is a registered trademark and Omnis Studio are trademarks of Tiger Logic Corporation. ADJob is a trademark of ADJob Nordic AB. Microsoft, MS, MS-DOS, Visual Basic, Windows, Windows 95, Win32, Win32s are registered trademarks, and Windows NT, Visual C++ are trademarks of Microsoft Corporation in the US and other countries. Apple, the Apple logo, AppleTalk, and Macintosh are registered trademarks and MacOS, Power Macintosh and PowerPC are trademarks of Apple Computer, Inc. IBM and AIX are registered trademarks of International Business Machines Corporation. UNIX is a registered trademark in the US and other countries exclusively licensed by X/Open Company Ltd. Sun, Sun Microsystems, the Sun Logo, Solaris, Java, and Catalyst are trademarks or registered trademarks of Sun Microsystems Inc. HP-UX is a trademark of Hewlett Packard. OSF/Motif is a trademark of the Open Software Foundation. Acrobat is a trademark of Adobe Systems, Inc. ORA- CLE is a registered trademark and SQL*NET is a trademark of Oracle Corporation. SYBASE, Net-Library, Open Client, DB-Library and CT-Library are registered trademarks of Sybase Inc. INFORMIX is a registered trademark of Informix Software, Inc. EDA/SQL is a registered trademark of Information Builders, Inc. CodeWarrior is a trademark of Metrowerks, Inc. Other products mentioned are trademarks or registered trademarks of their corporations.
ADJOB 4.6 3 Allmänt om ODB Vad är Omnis Data Bridge (ODB)?... 5 Fler användare samtidigt kräver ODB... 5 Fördelar med ODB... 5 Krav på servern... 5 Förbered ODB-servern Alt 1 Mac OS X 1. Kopiera datafilen till ODB-servern... 6 2. Installera Omnis Data Bridge på servern... 6 3. Ange sökvägen till din datafil i config.xml... 6 4. Starta Omnis Data Bridge via Terminalen... 7 5. Starta om Omnis Data Bridge vid ändringar... 7 6. Installera Autostart... 7 Förbered ODB-servern Alt 2 Windows 1. Kopiera datafilen till ODB-servern... 8 2. Installera Omnis Data Bridge på servern... 8 3. Ange sökvägen till din datafil i config.xml... 8 4. Aktivera tjänsten Omnis Data Bridge... 9 5. Starta och stoppa tjänsten ODB... 9 6. Starta om Omnis Data Bridge vid ändringar... 9 Förbered ADJob-klienterna 1. Lås sökvägen till Omnis Data Bridge... 10 2. Välj datafil... 10 Tips & Felsökning Får du kontakt med ODB?... 11 Får du kontakt med din datafil?... 11 Korrekt sökväg till datafilen på Mac för config.xml... 11
4 ADJOB 4.6
ADJOB 4.6 5 Allmänt om ODB Vad är Omnis Data Bridge (ODB)? ODB är en daemon eller tjänst som körs i bakgrunden på en server eller en vanlig Mac-dator eller Windows-dator. ODB använder TCP/IP protokollet för båda datormiljöerna och löser därför många problem med låsning och delning av ADJob datafiler. Fler användare samtidigt kräver ODB Data Bridge (ODB) gör det möjligt att ansluta till och dela ADJob datafiler i nätverk. Du ställer in ADJob-klienterna så att de anropar datafilen via serverns IP-nummer och portnummer. Klient (arbetsdator) ADJob Mac OS X ADJob TCP/IP TCP/IP ODB Server Datafil Mac OS X Windows Linux Windows Fördelar med ODB 1. Mac och Windows anropar via TCP/IP - inga protokollkonflikter. 2. TCP/IP är upp till fyra gånger snabbare än protokollet afp på Mac. 3. Mappen adjob_data ska inte vara utdelad - man kan inte slänga datafilen av misstag. 4. Säkerhetskopiering över natten kan göras även om klienterna inte stängs av. 5. ADJob låses till ett särskilt ip-nummer - man kan inte välja fel fil 6. Du kan lättare ansluta via VPN. 7. Låga kostnader, eftersom inga extra server-licenser behövs. 8. Relativt enkel att installera och konfigurera normalt mindre än en timme 9. Kräver relativt lite datorkapacitet en snabb hårddisk räcker. Krav på servern I princip kan du använda valfri dator som är 5 år eller nyare. Eftersom servern är på dygnet runt, bör du se till att den har tillräcklig kylning (t ex inbyggd fläkt). Det bör finnas tillräckligt med internminne för att täcka samtliga tjänster på servern. Macintosh: Mac OS X 10.5 / 10.6 / 10.7 /10.8 eller motsvarande server-version. Windows: Vista/Windows 7/Windows 8 eller motsvarande server-version Linux: Eftersom det finns flera olika distributioner lämnar vi bara allmän support.
6 ADJOB 4.6 Förbered ODB-servern Alt 1 Mac OS X 1. Kopiera datafilen till ODB-servern Skapa en mapp direkt på hårddisken som heter adjob_data. Lägg din datafil direkt i denna mapp. Denna mapp ska inte vara utdelad utan bara kunna nås via servern. 2. Installera Omnis Data Bridge på servern Sätt in ADJob CD och öppna Macintosh-mappen i ODB eller ladda ner från vår hemsida. Starta installationen genom att dubbelklicka på OmnisDataBridge.pkg. 3. Ange sökvägen till din datafil i config.xml Eftersom du kommer att ange sökvägen från din dator till ODB på servern, måste sökvägen till datafilen skrivas in så att ODB hittar den. Du kan ändra config.xml med Xcode eller vanlig textredigering typ TextEdit.app. Använd inte MS Word som lägger till onödiga skräptecken i config-filen. 1. Beskrivning i klartext för att lättare identifieradatafilen. 2. Internt namn på datafilen. Du kan använda t ex data 3. Skriv in sökvägen till datafilen. Se tips på sidan 11. 4. Port nummer 5913 är förvald och är normalt öppen på Mac OS X. Du kan ange valfri port här. Observera att du måste då ändra det förvalda portnumret på klienterna.
ADJOB 4.6 7 4. Starta Omnis Data Bridge via Terminalen ODB måste alltid vara igång för att du ska kunna nå din datafil. Starta Terminalen och skriv in följande kommandon. Alla kommandon måste skrivas in EXAKT som nedan. Peka på ODB (change directory = cd /Applications/OmnisDataBridge (retur-tangent)). Du bör dock dra och släppa hela mappen OmnisDataBridge direkt i terminalfönstret efter cd(mellanslag) för att få sökvägen korrekt: Starta ODB (./odb start (retur-tangent)): För att kontrollera att ODB har startat, öppnar du messages.txt. Så här ska meddelandet ungefär se ut om allt är OK. Nu väntar ODB på anrop från klienterna. 5. Starta om Omnis Data Bridge vid ändringar Om du gör ändringar i config.xml måste du stänga av och starta om ODB. För att stänga av använder du kommandot./odb shutdown. Glöm inte att peka på ODB-mappen med cd som tidigare. Tänk på att det tar en liten stund för ODB att stängas av. Vänta gärna en liten stund innan du startar ODB igen. 6. Installera Autostart Vid ström avbrott startar inte ODB automatiskt. Därför behövs ett litet skript som gör detta. Skript och instruktioner finns på nedladdningssidan.
8 ADJOB 4.6 Förbered ODB-servern Alt 2 Windows 1. Kopiera datafilen till ODB-servern Skapa en mapp direkt på C: som heter adjob_data. Lägg din datafil direkt i denna mapp. Denna mapp ska inte vara utdelad utan bara kunna nås via servern. 2. Installera Omnis Data Bridge på servern Ladda ner ODB från vår hemsida. Starta installationen genom att dubbelklicka på OmnisDataBridge.exe. 3. Ange sökvägen till din datafil i config.xml Eftersom du kommer att ange sökvägen från din dator till ODB på servern, måste sökvägen till datafilen skrivas in så att ODB hittar den. 1. Sökväg till config.xml 2. För att ändra config.xml högerklickar du och väljer Redigera. Beskrivning i klartext för att lättare identifiera datafilen. Undvik å ä ö i företagsnamnet om du har blandad miljö (Mac + PC). Internt namn på datafilen. Du kan använda t ex data Skriv in sökvägen till datafilen. Port nummer 5913 är förvald och kan vara stängd i Windows. Du kan ange valfri port här. Observera att du måste då ändra det förvalda portnumret på klienterna.
ADJOB 4.6 9 4. Aktivera tjänsten Omnis Data Bridge Dubbelklicka på ODBService.exe för att starta servicen. Det kan ta från någon sekund till någon minut, beroende på hur snabb datorn är. 5. Starta och stoppa tjänsten ODB Du använder funktionen Tjänster i Administrationsverktyg (Kontrollpanelen). Hur det ser ut beror på vilken version av Windows du har. Funktionen är dock densamma. Markera Omnis Data Bridge och starta respektive stäng av tjänsten. Ange även att tjänsten ska starta om Automatiskt vid t ex strömavbrott. För att kontrollera att ODB har startat, öppnar du messages.txt. Så här ska meddelandet se ut om allt är OK. Nu väntar ODB på anrop från klienterna. 6. Starta om Omnis Data Bridge vid ändringar Om du gör ändringar i config.xml måste du stänga av och starta om ODB.
10 ADJOB 4.6 Förbered ADJob-klienterna 1. Lås sökvägen till Omnis Data Bridge Huvudmeny > (Alternativ...) Inställningar... Det du normalt behöver ange är serverns IP-nummer. Har du valt en annan port, behöver du ange även detta nummer. Inställningarna är identiska på Mac och PC. 2. Välj datafil När du sparar sökvägen, får du en fråga om du vill öppna en datafil. Har du konfigurerat ODB korrekt, visas ett fönster med företagsnamnet i klartext. Logga in med signatur och lösenord som vanligt.
ADJOB 4.6 11 Tips & Felsökning Får du kontakt med ODB? Visas dialogrutan nedan har du kontakt med ODB. Om inte, är antingen sökvägen fel eller har du inte startat ODB. Det finns också möjlighet att port 5913 inte är öppen. Kontrollera då serverns inställningar för brandvägg. Får du kontakt med din datafil? Visas dialogrutan nedan har du kontakt med din datafil. Allt är OK. Om inte, är förmodligen sökvägen felaktig i config.xml Korrekt sökväg till datafilen på Mac för config.xml Ett litet trick som ger dig korrekt sökväg till datafilen automatiskt. Dra och släpp datafilen direkt i xml-skriptet för sökvägen. Du bör använda de gamla DOS-Reglerna när du döper datafil och mappar. Det vill säga att du undviker mellanslag (använd understreck istället) och främmande tecken som å ä ö och liknande. Kontakta ADJob Nordic AB för support om du har några frågor.
ADJob Nordic AB Häggelundsvägen 17 SE-523 38 Ulricehamn Tel 0321-261 20 www.adjob.se support@adjob.se