Installation: Difference between revisions

From Project Apollo - NASSP
Jump to navigation Jump to search
imported>Tschachim
m (no radiation pressure necessary)
imported>Tschachim
(complete rewrite)
Line 1: Line 1:
{{Infobox | caption=Latest Downloads | text={{Latest_Downloads Extended}} }}
{{Infobox | caption=Latest Downloads | text={{Latest_Downloads Extended}} }}


Project Apollo - NASSP is an ongoing project, many developers are working on lots of new features and enhancements. If you are interested in this development but aren't a developer, have no suitable compiler/IDE like Microsoft Visual Studio 2005/2008/2010 and just want to preview and test the new features you can now beta test Project Apollo.
Project Apollo - NASSP is an ongoing project, many developers are working on lots of new features and enhancements. If you are interested in this development you can now beta test Project Apollo.


== What's going on at the moment? ==
Since Project Apollo is an open source project and all developers are working for free in their spare time we don't have project plans, schedules, or things like this. We coordinate the development by using our [http://www.ibiblio.org/mscorbit/mscforum/ forums]. So if you read the latest news you hopefully get all the necessary information you need to use and test Project Apollo. Of course every developer is happy to get feedback regarding his work to fix bugs and make improvements, so please do not hesitate to post in the forum if you discover something noteworthy in the beta versions.
 
This section tries to provide step-by-step instructions to set up the "beta testing enviroment" for Project Apollo. You need to do the following steps only once. If you want to update your beta version read the "How do I update?" section below.
 
== Install Orbiter ==
 
If you have installed the latest Orbiter version already, you can use this installation for Project Apollo, of course. Otherwise you need to install Orbiter. This includes the following steps at the moment:<BR><BR>'''Orbiter 2010-P1 Edition''' (http://orbit.medphys.ucl.ac.uk)
* Orbiter100830.zip/msi as explained here: http://www.orbiter-forum.com/download.php<BR><BR>Optional:<BR><BR>
*Earth091124_11_14.zip
*Moon090730_L11.zip<BR><BR>You can install every other high resolution texture package, too.<BR>These package are available for download here: http://orbitersimulator.com/orbiter-2012-downloads<BR><BR><div style="margin-left: -1.5em;">'''OrbiterSound 3.5''' (http://orbiter.dansteph.com)</div>
* OrbiterSound35.exe<BR><BR>
Optional: '''High resolution surface tiles for the Kennedy Space Center'''
* [http://sourceforge.net/projects/nassp/files/Orbiter/KSC_HiRes_Tiles.zip/download KSC_HiRes_Tiles.zip]
 
 
== Installation Prerequisites ==
 
Install the '''[http://www.microsoft.com/en-us/download/details.aspx?id=8328 Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)]''' if it's not installed already.


Since Project Apollo is an open source project and all developers are working for free in their spare time we have no project plans, schedules, or things like this. We coordinate the development by using our [http://www.ibiblio.org/mscorbit/mscforum/ forums]. So if you read the latest news you hopefully get all the necessary information you need to use and test Project Apollo. Of course every developer is happy to get feedback regarding his work to fix bugs and make improvements, so please do not hesitate to post in the forum if you discovered something noteworthy in the beta versions.


== How do I start? ==
== Install the latest Project Apollo Beta ==


This section tries to provide step-by-step instructions to set up the "beta testing enviroment" for Project Apollo. You need to do the following steps only once. If you want to update your beta version read the "How do I update?" section below.
Download the '''Modules Pack''' using the link at the top of this page. Unzip the Modules Pack to your Orbiter installation folder. Make sure that the directory structure of the archive is retained, usually there's a "Use Folders" option box or similar, which should be ticked/checked.
 
Download and unzip the '''CVS snapshot''' the same way.
 
 
== Optional, but recommended: Install the DirectX 9 client ==
 
The built-in (aka "inline") Orbiter graphics client is based on DirectX 7. Especially with Windows 7 computers and/or recent graphics adapter this client isn't working very well or in some cases isn't working at all. Fortunately there's an DirectX 9 client by [http://www.orbiter-forum.com/member.php?u=408 jarmonik] meanwhile, which is working great with Project Apollo. So it is strongly suggested to give it a try. You can get it from [http://www.orbiter-forum.com/showthread.php?t=18431&highlight=d3d9client this thread] in the Orbiter main forum or by following these instructions:
 
*  Install a recent Microsoft DirectX Runtime, for example by using the [http://www.microsoft.com/en-us/download/details.aspx?id=35 Microsoft DirectX End-User Runtime Web Installer].
 
* Download and unzip the [http://sourceforge.net/projects/nassp/files/Orbiter/D3D9ClientRC44.zip/download D3D9ClientRC44.zip] file to your Orbiter installation folder the same way as the Project Apollo files above.


'''Note:''' If you can't use CVS or have a strong reason not to use it, we now offer an alternative. This is not the preferred method, but it is available: [[CVS-less install]]
* Start '''Orbiter_ng.exe''' (NOT Orbiter.exe) from your Orbiter installation folder.


* Download and install the free CVS client [http://www.tortoisecvs.org TortoiseCVS]. You need this to get the current config files, meshes, textures etc. from the CVS server.  
* Go to the "Modules" tab and activate the "D3D9Client" module.


* Make a new, empty folder on your local harddisc, you can choose the location and the name of the new folder as you like, in the following it is assumed that the folder is "C:\ProjectApollo".
* The "Video" tab appears, configure the video settings as you like, they are quite similar to the usual Orbiter video settings. Do not change any settings you don't know/understand.


* Right-click the new folder in your Windows Explorer and choose '''CVS Checkout...''' from the context menu.
* Launch a build-in scenario in order to check if the client is running fine before you continue with the instructions below.
* Enter the following settings in the "Checkout Module" window:
** Protocol: Password server (:pserver:)
** Server: nassp.cvs.sourceforge.net
** Repository folder: /cvsroot/nassp
** User name: anonymous
** Module: projectApollo<BR><BR>After that your CVSROOT should look like this:<BR>''':pserver:anonymous@nassp.cvs.sourceforge.net:/cvsroot/nassp'''<BR><BR>


* Press "OK". TortoiseCVS downloads now the current version of the Project Apollo files to your computer. This will take some time...


* After the checkout install Orbiter in your folder, that means in the example above the path of Orbiter is "C:\ProjectApollo\orbiter.exe". This includes the following files at the moment:<BR><BR>'''Orbiter 2010-P1 Edition''' (http://orbit.medphys.ucl.ac.uk)
== Configure Project Apollo ==
** orbiter100830.zip<BR><BR>Optional:<BR>
**Earth091124_11_14.zip
**Moon090730_L11.zip<BR>You can install every other Planetary extension package, too.<BR><BR><div style="margin-left: -1.5em;">'''OrbiterSound 3.5''' (http://orbiter.dansteph.com)</div>
** OrbiterSound35.exe<BR><BR><div style="margin-left: -1.5em;">Orbiter and OrbiterSound should not overwrite any of the CVS files.</div><BR>


* Now you have everything you need except probably the most important files, the modules. Please download and unzip the '''Modules Pack''' using the link at the top of this page. Make sure that the directory structure of the archive is retained, usually there's a "Use Folders" option box or similar, which should be ticked/checked.<BR><BR>If you have a compiler/IDE you can build them for yourself, of course: You will find the Project Apollo solution file for Microsoft Visual Studio 2005/2008/2010 in the "ProjectApollo" source folder ("C:\ProjectApollo\Orbitersdk\samples\ProjectApollo\ProjectApollo2005/2008/2010.sln"). All available projects are included in this solution.<BR><BR>
* Start Orbiter (that means '''Orbiter_ng.exe''' in case you're using the DirectX 9 client), go to the "Parameters" tab and make sure that at least '''Complex flight model''', '''Limited fuel''' and '''Gravity-gradient torque''' are enabled. If you're using a Virtual AGC scenario, also enable '''Nonspherical gravity sources'''.


* Start Orbiter, go to the "Parameters" tab and make sure that at least '''Complex flight model''', '''Limited fuel''' and '''Gravity-gradient torque''' are enabled. If you're using a Virtual AGC scenario, also enable '''Nonspherical gravity sources'''.<BR>
* Go to the "Modules" tab and activate the '''[[ProjectApolloMFD]]''' module.


* Go to the "Modules" tab and activate the '''[[ProjectApolloMFD]]''' module.<BR>
* Optionally you can change some options with the '''[[Launchpad Configuration Options]]''' on the "Extra" tab.


* Optionally you can change some options with the '''[[Launchpad Configuration Options]]''' on the "Extra" tab.<BR>
* That's all, now you can try if Project Apollo is working properly. You'll find the proper scenarios in the '''"Project Apollo - NASSP" scenario folder'''. Please note that the scenarions in the "Broken Scenarios" subfolder are, well, broken.


* That's all, now you can try if Orbiter and Project Apollo is working. You'll find the proper scenarios in the '''"Project Apollo - NASSP" scenario folder''' and subfolders.


== How do I update? ==
== How do I update? ==


To get the latest version of Project Apollo you don't have to do the initial checkout again but you have to a CVS update.
To update your Project Apollo installation you can repeat the steps above. Alternatively you can update the CVS snapshot by using a CVS client like  [http://www.tortoisecvs.org TortoiseCVS] by following these steps:


* Choose the '''CVS Update''' menu item from the Tortoise context menu for each folder below "C:\ProjectApollo", i.e. "Config", "Doc", "Html" etc. CVS will download the changed files and merge the changes into your local copies.
* Choose the '''CVS Update''' menu item from the Tortoise context menu for each folder below "C:\ProjectApollo", i.e. "Config", "Doc", "Html" etc. CVS will download the changed files and merge the changes into your local copies.


* Download and unzip the latest '''Modules Pack''' (using the link at the top of this page).
* Download and unzip the latest '''Modules Pack''' (using the link at the top of this page).


==See Also==
==See Also==


* [[:Category:Scenario configuration|Configuration]]
* [[:Category:Scenario configuration|Configuration]]

Revision as of 18:14, 16 July 2012

Latest Downloads
Latest NASSP 8.0 beta

https://github.com/orbiternassp/NASSP/releases

The link opens the GitHub download page.
NASSP 7.0.1 modules (legacy, last updated May 13th, 2021)

Project-Apollo-NASSP-V7.0.1.zip

Project Apollo - NASSP is an ongoing project, many developers are working on lots of new features and enhancements. If you are interested in this development you can now beta test Project Apollo.

Since Project Apollo is an open source project and all developers are working for free in their spare time we don't have project plans, schedules, or things like this. We coordinate the development by using our forums. So if you read the latest news you hopefully get all the necessary information you need to use and test Project Apollo. Of course every developer is happy to get feedback regarding his work to fix bugs and make improvements, so please do not hesitate to post in the forum if you discover something noteworthy in the beta versions.

This section tries to provide step-by-step instructions to set up the "beta testing enviroment" for Project Apollo. You need to do the following steps only once. If you want to update your beta version read the "How do I update?" section below.

Install Orbiter

If you have installed the latest Orbiter version already, you can use this installation for Project Apollo, of course. Otherwise you need to install Orbiter. This includes the following steps at the moment:

Orbiter 2010-P1 Edition (http://orbit.medphys.ucl.ac.uk)

Optional: High resolution surface tiles for the Kennedy Space Center


Installation Prerequisites

Install the Microsoft Visual C++ 2010 SP1 Redistributable Package (x86) if it's not installed already.


Install the latest Project Apollo Beta

Download the Modules Pack using the link at the top of this page. Unzip the Modules Pack to your Orbiter installation folder. Make sure that the directory structure of the archive is retained, usually there's a "Use Folders" option box or similar, which should be ticked/checked.

Download and unzip the CVS snapshot the same way.


Optional, but recommended: Install the DirectX 9 client

The built-in (aka "inline") Orbiter graphics client is based on DirectX 7. Especially with Windows 7 computers and/or recent graphics adapter this client isn't working very well or in some cases isn't working at all. Fortunately there's an DirectX 9 client by jarmonik meanwhile, which is working great with Project Apollo. So it is strongly suggested to give it a try. You can get it from this thread in the Orbiter main forum or by following these instructions:

  • Download and unzip the D3D9ClientRC44.zip file to your Orbiter installation folder the same way as the Project Apollo files above.
  • Start Orbiter_ng.exe (NOT Orbiter.exe) from your Orbiter installation folder.
  • Go to the "Modules" tab and activate the "D3D9Client" module.
  • The "Video" tab appears, configure the video settings as you like, they are quite similar to the usual Orbiter video settings. Do not change any settings you don't know/understand.
  • Launch a build-in scenario in order to check if the client is running fine before you continue with the instructions below.


Configure Project Apollo

  • Start Orbiter (that means Orbiter_ng.exe in case you're using the DirectX 9 client), go to the "Parameters" tab and make sure that at least Complex flight model, Limited fuel and Gravity-gradient torque are enabled. If you're using a Virtual AGC scenario, also enable Nonspherical gravity sources.
  • That's all, now you can try if Project Apollo is working properly. You'll find the proper scenarios in the "Project Apollo - NASSP" scenario folder. Please note that the scenarions in the "Broken Scenarios" subfolder are, well, broken.


How do I update?

To update your Project Apollo installation you can repeat the steps above. Alternatively you can update the CVS snapshot by using a CVS client like TortoiseCVS by following these steps:

  • Choose the CVS Update menu item from the Tortoise context menu for each folder below "C:\ProjectApollo", i.e. "Config", "Doc", "Html" etc. CVS will download the changed files and merge the changes into your local copies.
  • Download and unzip the latest Modules Pack (using the link at the top of this page).


See Also