1. INF 123: Software Architectures, Distributed Systems, and Interoperability Discussion Session Week 1 - Spring 2008 Instructor: Prof. Richard N. Taylor TA: Rosalva Gallardo

2. Overview Introduction Goals Contact Information Policies Card Game Assignment 1 Tools Eclipse Subclipse ArchStudio Myx.fw Application Lunar Lander

3. Overview Installation and Configuration to Run LL 1. Install Eclipse 2. Install Subclipse Plug-in 3. Install ArchStudio Plug-in 4. Install ArchStudio and Myx Source Code 5. Install Lunar Lander 6. Install OpenGL Libraries 7. Run ArchStudio 8. In the new Eclipse Instance: 1.Install Myx Source Code 2.Install Lunar Lander 9. Run Lunar Lander

4. Goals Present tools Discuss details about the assignments Review assignments

5. Contact Information Rosalva Gallardo Email: rgallard@uci.edurgallard@uci.edu Office: DBH 5051 Office hours: Tuesday 10am - 10:50am in DBH5051 Please email me if you plan to drop by

6. Policies Discussion Turn off your cell phone. Ask questions about assignments. Assignments No late assignments. Bring questions about the assignment to the discussion session. Please do not wait until the last minute to ask questions about the assignments. Questions sent in the last 12 hours before an assignment’s deadline will not receive answers from the teaching staff. Submit them using Checkmate

7. Policies Questions Noteboard, Email (if it is something personal), office hours. If the TA considers that an emails’ reply is beneficial for the class, she will post it in the Noteboard. An answer will be provided within 24 hours. Grading Always check your partial grades. If you have questions, please talk to the TA first, then with the instructor. Re-grade Double check before you bring it. Within 1 week, accompanied by a clear explanation of what needs to be reconsidered and why. Your whole assignment will be re graded.

8. Card Game I want to know about YOU Write the following information in the card: Your Name Underline how you want to be called Your expectation for the discussion session

9. Assignment 1

10. Eclipse Eclipse is an IDE (Integrated Development Environment) It’s an open source project http://www.eclipse.org Consortium of companies, including IBM Launched in November 2001 It’s a framework for software tools (“plug-ins” in Eclipse terminology) Main component is the workbench Ships with two plug-ins JDT (Java Development Tools) and PDE (Plug-in Development Environment)

11. Eclipse Concepts Resources Perspectives Views

12. Organizing Resources project folder file Workbench Workspace It is possible to drag and drop resources directly between Workbench and the directory structure

13. Workbench Components Workbench contains perspectives Perspective contains views and editors views editor perspective

14. Subclipse It is an Eclipse plug-in It aims to provide all Subversion functionality to the Eclipse development environment. It is an open source project: http://subclipse.tigris.org/

15. ArchStudio 4 Developed by the Institute for Software Research at UCI Environment of integrated tools for Modeling Visualizing Analyzing Implementing software and systems architectures. Based on Eclipse open development platform It is an open-source software and systems architecture development environment: http://www.isr.uci.edu/projects/archstudio/ http://www.isr.uci.edu/projects/archstudio/

16. Myx Framework Myx Framework (Myx.fw) can be used to implement Myx applications in Java. Myx.fw provides Java libraries that contain the constraints of the Myx Style. The Myx Architectural Style: It was used to build ArchStudio 4. It is a set of rules for composing the components and connectors of an application like ArchStudio. More Information: http://www.isr.uci.edu/projects/archstudio/myx.h tml http://www.isr.uci.edu/projects/archstudio/myx.h tml

17. Lunar Lander It is the classic Lunar Lander game with a 3D interface Developed by undergraduate and graduate classes in ICS Developed in Java using Myx.fw It uses OpenGL libraries to support the 3D graphs

18. 1. Install Eclipse Download Eclipse Classic 3.3.2: http://www.eclipse.org/downloads/ Unzip it and run eclipse.exe Useful Links: Eclipse Glossary: http://www.eclipse.org/glossary.html http://www.eclipse.org/glossary.html List of Plug-ins: http://www.eclipseplugincentral.com/

19. 2. Install Subeclipse Follow the instructions here: http://subclipse.tigris.org/install.html See the considerations in the next slide, before installing it.

20. 2. Install Subeclipse - Considerations Update site: http://subclipse.tigris.org/update_1.2.x In the Select features to install, only select Subclipse Plugin:

21. 2. Install Subeclipse - Verification To see the Subeclipse Perspective: go to Window->Open Perspective->Others- >SVN Repository Exploring

22. 3. Install ArchStudio Plug-in Go to this url and follow the instructions in the “Video Tutorial showing how to install ArchStudio 4” http://www.isr.uci.edu/projects/archstudio/ setup-easy.html Following these instructions you will install ArchStudio 4 as an Eclipse Plug-in. Before installing see the considerations in the next slide.

23. 3. Install ArchStudio - Considerations Update site: http://www.isr.uci.edu/projects/archstudio-update/ Please, select all the components during the installation:

24. 3. Install ArchStudio - Verification To see the ArchStudio Perspective: go to Window->Open Perspective->Others- >ArchStudio

25. 4. Install ArchStudio and Myx Source Code Go to this url and follow the instructions in the “Checking Out for the First Time” section. http://www.isr.uci.edu/projects/archstudio/ setup-fromsource.html Before installing see the considerations in the next slide.

26. 4. Install ArchStudio and Myx Source Code - Consideration You only need to download the “ArchStudio 4 Project Set File” and follow the steps in the website for this file.

27. 4. Install ArchStudio and Myx Source Code - Verification The installation will take some time. At the end of it, you should have these projects in your Package Explorer

28. 5. Install Lunar Lander Download the source code from the class website and extract it in a directory different than your eclipse workspace. Go to File->New->Java Project. ProjectName: LunarLander Select Create project from exiting source and indicate the LunarLander directory where you extracted the source code.

29. 5. Install LL - Verification You should have the LunarLander project in your Package Explorer. The errors that appear will be solved after installing the OpenGL libraries.

30. 6. Install OpenGL Libraries Find out the location of the JDK for Eclipse. Go to: Window->Preferences. Select Java->Installed JREs (In Mac: Eclipse->Preferences) Take note of the location of the JDK. We will refer to this location as

31. 6. Install OpenGL Libraries For Windows Users: Donwload the following zip file: http://download.java.net/media/jogl/builds/archive/jsr-231-1.1.0/jogl-1.1.0- windows-i586.zip http://download.java.net/media/jogl/builds/archive/jsr-231-1.1.0/jogl-1.1.0- windows-i586.zip Unzip it Copy jogl.dll and jogl_awt.dll to /jre/bin In Eclipse, add external jar for jogl.jar and gluegen-rt.jar. See Note. For MAC Users: Download the following zip file: http://download.java.net/media/jogl/builds/archive/jsr-231-1.1.0/jogl-1.1.0- macosx-universal.zip http://download.java.net/media/jogl/builds/archive/jsr-231-1.1.0/jogl-1.1.0- macosx-universal.zip Unzip it In Eclipse, add external jar for jogl.jar and gluegen-rt.jar. See Note. Copy *.jnilib (4 files) to the LunarLander folder and refresh your project in Eclipse Note: To add external jar: Select LunarLander Project. Go to Project- >Properties, Java Build Path->Libraries. Click “Add External JARs…”. Now your LunarLander project should be free of errors.

32. 7. Run ArchStudio Go to the Plug-in Development Perspective In the Package Explorer, select the project: edu.uci.isr.archstudio4 (the first one) Press the Run button

33. 8. In the new Eclipse instance The previous step will open a new eclipse instance to run the ArchStudio Plug-in The following steps should be done in this new instance

34. 8.1 Install Myx.fw Source Code Go to the Java Perspective in Eclipse Go to File->Import. Select Other- >Checkout Projects from SVN. Create new Repository with the following URL: http://tps.ics.uci.edu/svn/projects/

35. 8.1 Install Myx.fw Select myxfw->trunk->edu.uci.isr.myx.fw and Finish.

36. 8.1 Install Myx.fw - Verification Check that you have the project “edu.uci.isr.myx.fw” in your Package Explorer.

37. 8.2 Install Lunar Lander Go to File->New->Java Project. ProjectName: LunarLander Select Create project from exiting source and indicate the LunarLander directory where you extracted the source code you downloaded for step 5. Refer to Step 5 to verify the installation

38. 9. Run LL Application Go to the ArchStudio Perspective In the Navigator view, select LunarLander->arch.xml Right click on arch.xml and select Open with AIM Launcher

39. 9. Run LL Application In the Outline View, select “Lunar Lander” In the AIM Launcher View, click on Instantiate