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

2. 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

3. 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)

4. Eclipse Concepts Resources Perspectives Views

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

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

7. 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/

8. 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/

9. 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

10. 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

11. 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/

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

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

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

15. 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.

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

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

18. 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.

19. 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.

20. 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

21. 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.

22. 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.

23. 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

24. 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.

25. 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

26. 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

27. 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/

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

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

30. 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

31. 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

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