2c8 Modeling Tool Server (Windows/SQLServer) Innehållsförteckning Ny installation...2 Översikt...2 Filer som behövs...2 Installera SQL Server Express (om det behövs)...3 Skapa en databas i SQL Server...8 GlassFish...9 Installera...9 Databaskoppling...9 Användare/säkerhet...11 Sätt upp kommunikationsvägar...11 Övriga inställningar...12 ORB...12 JMS Host...13 Brandvägg...13 Installera komponenten...13 Från klienten...14 Uppdatering från tidigare version...15
Ny installation Översikt 2c8 Modeling Tools serverdel är en komponent som körs i en applikationsserver som heter GlassFish. GlassFish, som tidigare kallades Sun Java System Application Server, är byggt på öppen källkod och kommer från Sun Microsystems. Klienten kommunicerar med applikationsservern via CORBA protokollet på port 3700. Data lagras i Microsoft SQL Server 2005. Om en databas inte finns installerad kan Microsoft SQL Server Express användas. Filer som behövs Följande filer behövs under installationen. SQL Server 2005 Express och SQL Server Management Studio Express Detta behövs endast om det inte redan finns en databas tillgänglig. http://www.microsoft.com/download/en/details.aspx?id=21844 GlassFish and SDK: JavaEE + JDK http://download.oracle.com/otn-pub/java/java_ee_sdk/5_04-b//java_ee_sdk-5_04- windows.exe jtds SQL Server JDBC Driver http://sourceforge.net/project/downloading.php?group_id=33291&filename=jtds-1.2.2- dist.zip&a=22875623 Databasscript: 2c8_mssql_3.3.sql Serverkomponent: MTServer-EAR-3.3.ear
Installera SQL Server Express (om det behövs) Om det inte finns en databas tillgänglig kan Microsoft SQL Server Express användas. Det är en nedtrimmad variant av Microsoft SQL Server som är fritt tillgänglig. Microsoft SQL Server Express är dock begränsad till fyra gigabyte per databas, en processor och en gigabyte med RAM. 1. Starta installationsprogrammet till Microsoft SQL Server Express 2005. 2. Välj Mixed Mode och fyll i ett lösenord för systemadministratören (sa). 3. Installera SQL Server Management Studio Express. 4. Starta SQL Server Management Studio Express från startmenyn. 5. Klicka på knappen Connect i den första dialogrutan som dyker upp för att ansluta till databasen. 6. Högerklicka på Databases i trädet till vänster och välj New Database 7. På sidan General fyll i ett databasnamn, förslagsvis BMTServer 8. På sidan Options välj Collation Finnish_Swedish_CI_AS.
9. Klicka på OK för att stänga dialogen. 10. Från menyn välj File» Open» File 11. Öppna databasscriptet 2c8_mssql_3.1.sql 12. Se till att databasen du skapade är vald i comboboxen. 13. Klicka på knappen Execute. 14. Klicka på plusset framför Security i trädet och högerklicka på Login. Välj New Login från popup menyn. 15. På sidan General ange ett Login name, i det här exemplet använder vi conciliate. 16. Klicka i SQL Server authentication och ange ett lösenord, i det här exemplet använder vi conciliate. 17. Välj databasen som Default database.
18. På sidan User Mapping klicka i db_owner för användaren. 19. Klicka på OK för att stänga dialogen.
20. Starta programmet SQL Server Configuration Manager. Det finns på startmenyn under Microsoft SQL Server 2005» Configuration Tools» SQL Server Configuration Manager. 21. Klicka på Protocols for SQLEXPRESS i trädet till vänster. 22. Högerklicka på TCP/IP och välj Enable från popupmenyn. 23. Högerklicka på TCP/IP igen och välj den här gången Properties från popupmenyn. 24. Under IPAll välj TCP Port och fyll i 1433. 25. Klicka på OK för att stänga dialogen. 26. Klicka på SQL Server 2005 Services i trädet till vänster.
27. Högerklicka på SQL Server (SQLEXPRESS) och välj Restart från popupmenyn.
Skapa en databas i SQL Server Om SQL Server Express installerades i det föregående steget behöver det här inte göras. 1. För att applikationsservern ska kunna ansluta till databasen måste SQL Server Authentication vara tillgängligt. I exemplet använder vi portnummer 1433 för att ansluta från applikationsservern till databasen. För att verifiera att det här är korrekt inställt går det att köra telnet på port 1433 från den dator applikationsservern kör på till den dator som databasen körs på. Om en anslutning är möjligt är inställningarna korrekta. 2. Skapa ett databaslogin till applikationsservern. Här i exemplet har vi använt användare conciliate och lösenord conciliate. 3. Skapa en databas, förslagsvis med namnet BMTServer. 4. Sätt applikationsserverns login som db owner på databasen. 5. Kör SQL-scriptet 2c8_mssql_3.3.sql mot databasen.
GlassFish Installera 1. Starta installationsprogrammet till applikationsservern GlassFish. 2. Välj en installationskatalog. I det här exemplet använder vi C:\Sun\SDK. 3. Välj ett lösenord till Admin Console för användaren admin och välj vilka portar som skall användas. Admin Port är den port som det webbaserade Admin Console verktyget kommer att använda. HTTP Port och HTTPS Port nyttjas för tillfället inte av 2c8 Modeling Tool. 4. Klicka i Create Windows Service om applikationsservern ska startas automatiskt när datorn startas. 5. Avsluta installationsprogrammet. 6. Packa upp zip-filen jtds-1.2.2-dist.zip. 7. Kopiera filen jtds-1.2.2.jar till GlassFish lib-katalog (C:\Sun\SDK\lib). 8. Starta om Glassfish genom att välja Stop Default Server och sedan Start Default Server från startmenyn, eller från Services i Windows. Databaskoppling 1. Starta Admin Console. Detta hittas i startmanyn under Sun Microsystems» Java EE 5 SDK» Admin Console. 2. Logga in som användaren admin med lösenordet som angavs tidigare. 3. Välj Resources» JDBC» Connection Pools från trädet till vänster. 4. Klicka på knappen New för att skapa en ny Connection Pool. 5. Fyll i följande: Name: MTServerPool Resource type: javax.sql.datasource Database vendor: Microsoft SQL Server 6. Klicka på Next och fyll i:
a. General Settings Datasource Classname: net.sourceforge.jtds.jdbcx.jtdsdatasource b. Connection Validation Connection Validation: Validation Method: Table Name: c. Transaction Transaction Isolation: Required table version read-committed d. Additional Properties 1 databasename: BMTServer 2 user: conciliate 3 password: conciliate 4 servername: localhost 5 portnumber: 1433 6 selectmethod: cursor 7. Klicka på finish. 8. Välj Resources» JDBC» Connection Pools» MTServerPool från trädet. 9. Klicka på knappen Ping. Det ska nu komma upp ett meddelande Ping Succeeded om applikationsservern kunde komma åt databasen. 10. Välj Resources» JDBC» JDBC Resources från trädet. 11. Klicka på knappen New för att skapa en ny JDBC Resource. 1 Om ett attribut inte redan finns i listan klicka på Add Property för att lägga till det. 2 Namnet på databasen som skapades tidigare. 3 Användarnamnet på databasanvändaren. 4 Lösenordet till databasanvändaren. 5 Adressen till databasservern. 6 Portnummret till databasservern.
12. Fyll i följande: JNDI Name: Pool Name: jdbc/bmtserver MTServerPool 13. Se till att Enabled är ikryssad. 14. Klicka på Ok. 15. Expandera noden Configuration och klicka på Java Message Service a. Till höger finns nu en drop-down som kallas Type. Se till att den är inställd på LOCAL. Standardvärdet är EMBEDDED (vilket det alltså inte ska vara).
Användare/säkerhet 1. I Admin Console välj Configuration» Security» Realms från trädet. 2. Klicka på knappen New för att skapa en ny realm. 3. Fyll i följande: Name: conciliate Class name (välj i listan): com.sun.enterprise.security.auth.realm.jdbc.jdbcrealm JNDI: jdbc/bmtserver User table: users User name column: user_id Password column: password Group table: realm_groups Group name column: group_id Assign group: user Database user: conciliate 7 Database password: conciliate 8 Digest algorithm: MD5 Encoding: hex Charset: UTF-8 4. Klicka på OK. 5. Välj Configuration» Security från trädet och klicka i: Default Realm: conciliate 6. Klicka på Save. Sätt upp kommunikationsvägar För att användare av 2c8 Modeling Tool ska kunna kommunicera med varandra behöver servern förberedas för detta. Kommunikation mellan klienterna är nödvändig för att klienterna ska fungera korrekt. 1. I Admin Console välj Resources»JMS Resources» Connection Factories från trädet. 7 Användarnamnet på databasanvändaren 8 Lösenordet till databasanvändaren
2. Klicka på knappen New i den nya vyn som visas. (Vyn ska ha titeln JMS Connection Factories.) 3. Fyll i följande värden: a. JNDI Name: jms/usermessagefactory b. Resource Type: javax.jms.topicconnectionfactory c. Maximum Pool size: Fyll i det största antalet användare som systemet kan ha samtidigt här. För de flesta kommer standardvärdet (32) att räcka, men om fler klienter behöver ansluta till servern samtidigt så öka detta värde. 4. Kontrollera att kryssrutan Enabled är ikryssad. 5. Klicka OK för att spara. 6. Välj Configuration» Java Message Service» Physical Destinations från trädet. 7. I den vyn som nu visas (Physical Destinations), klicka på knappen New 8. Här anges nu följande: a. Name: PhysicalTopic b. Type: javax.jms.topic 9. Klicka på OK för att spara. 10. Välj Resources»JMS Resources» Destination Resources från trädet. 11. Klicka på knappen New 12. Fyll här i följande: a. JNDI Name: jms/usermessagetopic b. Physical Destination Name: PhysicalTopic Om fältet Physical Destination Name inte finns, klicka då istället på knappen Add property och fyll i följande: i.name: Name
ii.value: PhysicalTopic c. Resource Type: javax.jms.topic d. Verifiera att kryssrutan Enabled är ikryssad. 13. Klicka OK för att spara. Övriga inställningar ORB HTTP 1. I Admin Console välj Configuration» ORB» IIOP Listeners» orb-listener-1 från trädet. 2. Ställ in Network Adress till den ip-adress eller det värdnamn som servern ska bindas mot. 1. I Admin Console välj Configuration» HTTP Service» HTTP Listeners» http-listener-1 från trädet. 2. Ställ in Network Adress till den ip-adress eller det värdnamn som servern ska bindas mot. JMS Host 1. I Admin Console välj Configuration» Java Message Service» JMS Hosts» default_jms_host från trädet. 2. Ställ in Host till den ip-adress eller det värdnamn som servern ska bindas mot. Brandvägg För att klienter skall kunna ansluta till serverapplikationen så måste ett antal portar vara öppna, har servern en brandvägg aktiverad så måste den konfigureras att släppa igenom trafik på dessa portar. Har servern ingen brandvägg aktiverad så kan du hoppa över den här delen. Först måste vi konfigurera Glassfish så att en av tjänsterna som klienterna använder körs på en statisk port istället för en dynamisk, slumpmässig port. 1. I Admin Console välj Configuration» Java Message Service från trädet.
2. I fältet för Start arguments skriv: -Dimq.jms.tcp.port=44234 (portnumret är valfritt så länge det inte används av någon annan tjänst på datorn) Portnumren som behöver öppnas (för TCP-trafik) är nu: 3700, 7676, 8080 och 44234 (om inte dessa har ändrats från sina standardvärden). Installera komponenten 1. I Admin Console välj Applications» Enterprise Applications från trädet. 2. Klicka på Deploy 3. Välj Enterprise Applications (.ear) i fältet Type och klicka i Packaged file to be uploaded to the server. Klicka sedan på Browse och välj filen MTServer-EAR-3.3.ear. 4. Klicka på OK. 5. Starta om applikationsservern.
Från klienten 1. Starta 2c8 Modeling Tool. 2. Välj Tools» Settings» Server från menyn. 3. Ställ in servernamn och portar (default 3700 och 8080). 4. Klicka på OK. 5. Logga in med ditt användarnamn och lösenord. I en ny installation finns en användare admin med lösenord 2c8.
Uppdatering från tidigare version Om en tidigare version av 2c8 Modeling Tool Server finns installerad, följ dessa anvisningar. Observera att när den nya installationen av servern är slutförd måste även klienterna vara av samma version för att kunna ansluta till servern. 1. Gör en backup på databasen innan uppdateringen påbörjas. 2. Kör den medföljande patch-filen mot databasen. Filerna heter 2c8_mssql_<från version>-<till version>.sql, t.ex. 2c8_mssql_2.4-3.1.sql för att uppgradera från 2.4 till 3.1. Hitta den patch-fil som överensstämmer med din nuvarande version som ska uppgraderas från. Det är inte säkert att några patch-filer behöver köras vid en uppdatering. 3. Logga in i administrations-gränssnittet för applikations-servern. 4. Om du uppgraderar från version 3.0: a. Expandera noden Configuration och klicka på Java Message Service b. Till höger finns nu en drop-down som kallas Type. Se till att den är inställd på LOCAL. Standardvärdet är EMBEDDED (vilket det alltså inte ska vara). 5. Klicka på Applications» Enterprise Applications i trädet. 6. Kryssa för den tidigare installerade modulen och klicka på Undeploy. 7. Klicka på Deploy 8. Välj Packaged file to be uploaded to the server och peka ut MTServer- EAR-3.3.ear. 9. Se till att Enabled är ikryssad vid Status. 10. Klicka på Ok. 11. Läs igenom och följ anvisningarna under Övriga Inställningar för att se till att nätverks-interface och portar är korrekt konfigurerade.
12. Om uppdateringen sker från version 2.2 eller tidigare så måste stegen under Sätt upp kommunikationsvägar följas. 13. Anslut som vanligt med de nya klienterna.