Installation: Difference between revisions

From Project Apollo - NASSP
Jump to navigation Jump to search
imported>Tschachim
m (→‎How do I start?: MFD link)
(Replace NASSP 8 installation guide with a link to the Orbiter Forum guide for the time being.)
 
(30 intermediate revisions by 11 users not shown)
Line 1: Line 1:
{{Infobox | caption=Latest Downloads | text={{Latest_Downloads}} }}
{{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 C++ 6 or Visual Studio 2005 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 test the current version of 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 [https://www.orbiter-forum.com/forums/project-apollo-nassp.40/ forums]. So if you read the latest news you hopefully get all the necessary information you need to use 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.


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 necessary informations 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.
= NASSP 8.0 Beta =


== How do I start? ==
The guide shown on this wiki is outdated. For the time being, please refer to THIS guide on the Orbiter Forums, which is the most up-to-date guide on installing the newest version of NASSP: https://www.orbiter-forum.com/threads/nassp-8-installation-guide.36801/


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 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.  
= NASSP 7.0 (Deprecated) =


* 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".
This version of NASSP is several years old, having released in 2017. It is no longer actively maintained, but should remain perfectly usable if you desire a "stable" version of NASSP that will not change, at the cost of missing out on more recent improvements to simulation accuracy, etc. If you wish to upgrade from NASSP 7.0 to 8.0, it is highly recommended to perform a complete reinstall from scratch, following the instructions provided in the earlier "NASSP 8.0" section.


* Right-click the new folder in your Windows Explorer and choose '''CVS Checkout...''' from the context menu.
This section tries to provide step-by-step instructions to set up the Orbiter environment for Project Apollo. You need to do the following steps only once. If you want to update your installation read the "How do I update?" section 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...
== Install Orbiter ==


* 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 2006-P1 Edition''' (http://www.orbitersim.com)
If you have installed the latest Orbiter 2010 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'''  
** orbiter060929_base.zip
* Orbiter100830.zip/msi as explained here: http://www.orbiter-forum.com/download.php<br><br>Optional:
** orbiter060929_sdk.zip<BR><BR>Optional:<BR>
* Earth091124_11_14.zip
**Earth060504_L10.zip
* Moon090730_L11.zip
**Moon060504_L8.zip<BR>You can install every other Planetary extension package, too.<BR><BR><div style="margin-left: -1.5em;">'''OrbiterSound 3.0''' (http://orbiter.dansteph.com)</div>
** OrbiterSound30.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 the probably 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 "Use Folders" option box is ticked/checked.<BR><BR>If you have a compiler/IDE you can build them for yourself, of course:
'''OrbiterSound 4.0'''
** You will find the Project Apollo workspace file for Microsoft Visual C++ 6.0 in the "ProjectApollo" source folder ("C:\ProjectApollo\Orbitersdk\samples\ProjectApollo\ProjectApollo.dsw"). All available projects are included in this workspace.
* http://orbiter.dansteph.com/forum/index.php?page=download
** You will find the Project Apollo solution file for Microsoft Visual Studio 2005 in the "ProjectApollo" source folder ("C:\ProjectApollo\Orbitersdk\samples\ProjectApollo\ProjectApollo2005.sln"). All available projects are included in this solution.<BR><BR>


* Download and unzip the latest '''Meshland Pack''' using the link at the top of this page in your beta testing folder. Make sure that the "Use Folders" option box is ticked/checked. CVS will ignore the new files. Start Orbiter, go to the "Modules" tab and activate the "MeshLand" module.<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]


* Start Orbiter, go to the "Parameters" tab and make sure that at least '''Complex flight model''' and '''Limited fuel''' are enabled. If you're using a Virtual AGC scenario, also enable '''Nonspherical gravity sources'''.<BR>
== Installation Prerequisites ==


* Go to the "Modules" tab and activate the '''[[ProjectApolloMFD]]''' and '''MeshLand''' modules.<BR>
Install the '''[https://www.microsoft.com/en-us/download/details.aspx?id=48145 Microsoft VS C++ 2015 Redistributable (x86) Package]''' if it's not installed already.


* Optionally you can change some options with the '''[[Launchpad_Configuration_Options|Launchpad Configurator]]''' on the "Extra" tab.<BR>


* That 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.
== Install Project Apollo - NASSP ==
 
Follow the '''Modules Pack''' link at the top of this page download and unzip the first .zip file 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.
 
Optionally, you can download and unzip the '''Source Code.zip''' the same way if you wish to have the source code that corresponds to the binary release.
 
== 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://d3d9client.codeplex.com/ client] 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 ('''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''', '''Gravity-gradient torque''' and '''Nonspherical gravity sources''' are enabled.
 
* Go to the "Modules" tab and activate the '''[[ProjectApolloMFD]]''' module.
 
* Optionally you can change some options with the '''[[Launchpad Configuration Options]]''' on the "Extra" tab.
 
* 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? ==
== 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 in [[Installation#Install_Project_Apollo_-_NASSP|Install Project Apollo - NASSP]].
 
* 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).
== How can I track the development source and/or participate in development? ==


* If there's a newer version download and unzip the latest '''Meshland Pack''', too.
Please see the [http://www.ibiblio.org/mscorbit/mscforum/index.php?board=34.0 development area of the forums], specifically the [http://www.ibiblio.org/mscorbit/mscforum/index.php?topic=2864.0 git instructions thread].


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


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

Latest revision as of 19:37, 26 August 2024

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 test the current version of 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 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.

NASSP 8.0 Beta

The guide shown on this wiki is outdated. For the time being, please refer to THIS guide on the Orbiter Forums, which is the most up-to-date guide on installing the newest version of NASSP: https://www.orbiter-forum.com/threads/nassp-8-installation-guide.36801/


NASSP 7.0 (Deprecated)

This version of NASSP is several years old, having released in 2017. It is no longer actively maintained, but should remain perfectly usable if you desire a "stable" version of NASSP that will not change, at the cost of missing out on more recent improvements to simulation accuracy, etc. If you wish to upgrade from NASSP 7.0 to 8.0, it is highly recommended to perform a complete reinstall from scratch, following the instructions provided in the earlier "NASSP 8.0" section.

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

Install Orbiter

If you have installed the latest Orbiter 2010 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

OrbiterSound 4.0

Optional: High resolution surface tiles for the Kennedy Space Center

Installation Prerequisites

Install the Microsoft VS C++ 2015 Redistributable (x86) Package if it's not installed already.


Install Project Apollo - NASSP

Follow the Modules Pack link at the top of this page download and unzip the first .zip file 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.

Optionally, you can download and unzip the Source Code.zip the same way if you wish to have the source code that corresponds to the binary release.

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 client 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 (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, Gravity-gradient torque and Nonspherical gravity sources are enabled.
  • 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 in Install Project Apollo - NASSP.

How can I track the development source and/or participate in development?

Please see the development area of the forums, specifically the git instructions thread.

See Also