Difference between revisions of "Downloading & Installing"

From OpenRocket wiki
Jump to navigation Jump to search
 
(86 intermediate revisions by 5 users not shown)
Line 2: Line 2:
 
<div style="float: left;">[[Introduction|&larr; Introduction]]</div>
 
<div style="float: left;">[[Introduction|&larr; Introduction]]</div>
 
<div style="float: right;">[[Getting Started|Getting Started &rarr;]]</div>
 
<div style="float: right;">[[Getting Started|Getting Started &rarr;]]</div>
[[Main Page|&uarr; Back to Contents]]
+
[[Main Page|&uarr; Back to Main Page]]
 
</div>
 
</div>
  
{{UserGuideHelp}}
+
__TOC__
 +
 
 +
== Overview ==
 +
 
 +
<font size="5"; color="red">''Now available for download. . .''  </font> <font size=5>OpenRocket '''''2022.02''''' has been released.</font>
 +
 
 +
OpenRocket ''2022.02'' is now available for Windows, macOS and Linux. <u>The easiest way to get OpenRocket up and running is to download and install one of the packaged installers</u>. The Packaged Installers come with everything needed, including the <b>''correct''</b> version of Java; '''you ''will not'' need to install, update or downgrade Java on your device to run them.'''
 +
 
 +
For security reasons, ''download files for <font color="red">'''all available versions and releases'''</font color> of OpenRocket '''are now on, and should only be downloaded from the official OpenRocket website'' here:'''
 +
 
 +
:[https://openrocket.info/ <span style="color:blue"><b>https://openrocket.info/</b>]
 +
 
 +
== OpenRocket 2022 Pre-Installation Procedures ==
 +
 
 +
A few users have reported difficulties with installing new versions of OpenRocket, and some of these relate to pre-installation procedures. Before beginning the installation of OpenRocket, the following actions should be undertaken.
 +
 
 +
=== Close All Instances of OpenRocket ===
 +
 
 +
By default, all 2022 releases of OpenRocket install to the same location on your device; these releases even share preference and use files with version 15.03. Because of this, if OpenRocket is open when you attempt to install an updated release, the installation may not update all of the files needed for OpenRocket to function correctly.
  
 +
''Before installing an update'', you '''MUST''' close all open instances of OpenRocket.
  
__TOC__
+
=== Uninstall Prior OpenRocket Releases ===
 +
 
 +
As described above, by default, all 2022 releases of OpenRocket install to the same location on your device. Although not expressly required, it is suggested that all previously installed 2022 OpenRocket releases be uninstalled before installing the updated release. This is not required, but is suggested to ensure the proper function of OpenRocket.
  
== Overview ==
+
== OpenRocket 2022 After-Installation Checks ==
  
OpenRocket is available for Windows, macOS and Linux. <u>The easiest way to get OpenRocket up and running is to download and install one of the packaged installers</u>. The Packaged Installers for OpenRocket come with everything needed. You <em>don't</em> need to install, update or downgrade Java on your machine to run them.
+
=== Verify the Installed Release Number ===
  
=== <u>Download Files</u> ===
+
A few users have reported that new installations of OpenRocket are not functioning correctly, only to find out that the wrong beta release was installed. After your installation is complete, and before doing anything else, verify that you actually installed the current release of OpenRocket by undertaking the following steps:
  
<table class="left" style="width:720px">
+
<table class="left">
 
   <tr>
 
   <tr>
     <th>File Type</th>
+
     <th>Step</th>
     <th>OpenRocket 22.00.beta.01</th>
+
     <th>What You Should See</th>
     <th>OpenRocket 15.03</th>
+
  </tr>
 +
     <th>1</th>
 +
    <td><p>If the release number shown in <i><b>both</b></i> images below is not <b>OpenRocket <font color="red">Version 2022.02</font color></b>, <i>then you have installed the wrong release of the OpenRocket</i>. Uninstall that release, download the new release, and try again.</p></td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td></td>
+
     <td>Splash Screen</td>
     <td><center><p style="color:red">(INACTIVE UNTIL RELEASE DATE)</p></center></td>
+
     <td>'''[[File:2022.03.Splash_Screen.png|left|frameless|640 px|center]]'''</td>
    <td></td>
 
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td>&bull; Windows packaged installer</td>
+
     <td>Help &rarr; About</td>
     <td>[https://github.com/openrocket/openrocket/releases/download/release-22.00.beta.01/OpenRocket-22.00.beta.01-installer.exe OpenRocket-22.00.beta.01-installer.exe]</td>
+
     <td>'''[[File:2022.02.Help_Screen.png|left|frameless|384 px|center]]'''</td>
     <td>[https://github.com/openrocket/openrocket/releases/download/release-15.03/OpenRocket-15.03-installer.exe OpenRocket-15.03-installer.exe]</td>
+
  </tr>
 +
    <th>2</th>
 +
    <td><p>If the circled <i><b>icons</b></i> shown in the image below <b>are different that yours</b>, <i>then you have installed the wrong beta release of OpenRocket</i>. Uninstall that release, download the new beta release, and try again.</p></td>
 +
  </tr>
 +
  <tr>
 +
    <td>Component Icons</td>
 +
     <td>'''[[File:03.03.01.Components.png|left|frameless|720 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td>&bull; macOS packaged installer</td>
+
     <td>File Menu Icons</td>
     <td>[https://github.com/openrocket/openrocket/releases/download/release-22.00.beta.01/OpenRocket-22.00.beta.01.dmg OpenRocket-22.00.beta.01.dmg]</td>
+
     <td>'''[[File:03.04.02.File_Menu.png|left|frameless|512 px|center]]'''</td>
    <td>[https://github.com/openrocket/openrocket/releases/download/release-15.03/OpenRocket-15.03.dmg OpenRocket-15.03.dmg]</td>
 
 
   </tr>
 
   </tr>
 +
</table>
 +
 +
=== Check Settings ===
 +
 +
<p>If everything looks good there, let's check settings.
 +
 +
<table class="left">
 
   <tr>
 
   <tr>
     <td>&bull; Linux packaged installer</td>
+
     <th>Setting</th>
     <td>[https://github.com/openrocket/openrocket/releases/download/release-22.00.beta.01/OpenRocket-22.00.beta.01.AppImage OpenRocket-22.00.beta.01.AppImage]</td>
+
     <th>What You Should Do</th>
     <td>[https://github.com/openrocket/openrocket/releases/download/release-15.03/OpenRocket-15.03.AppImage OpenRocket-15.03.AppImage]</td>
+
  </tr>
 +
    <th>Off-screen Rendering</th>
 +
     <td><p>Some users have reported that the rocket shown in the design window is not full-size. This can occur if the off-screen rendering setting is not correct for your device. Using the <i>Three-stage rocket</i> example packaged with OpenRocket, this is what the problem looks like:</p></td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td>&bull; .jar</td>
+
     <td>Too small</td>
     <td>[https://github.com/openrocket/openrocket/releases/download/release-22.00.beta.01/OpenRocket-22.00.beta.01.jar OpenRocket-22.00.beta.01.jar]</td>
+
     <td>'''[[File:2022.02.Off_Screen.png|left|frameless|512 px|center]]'''</td>
    <td>[https://github.com/openrocket/openrocket/releases/download/release-15.03/OpenRocket-15.03.jar OpenRocket-15.03.jar]</td>
 
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
     <td>&bull; Source code (.zip)</td>
+
     <td>Correct size</td>
     <td>[https://github.com/openrocket/openrocket/archive/refs/tags/release-22.00.beta.01.zip OpenRocket-22.00.beta.01.zip]</td>
+
     <td>'''[[File:2022.01.Off_Screen.png|left|frameless|512 px|center]]'''</td>
     <td>[https://github.com/openrocket/openrocket/archive/refs/tags/release-15.03.zip OpenRocket-15.03.zip]</td>
+
  </tr>
  </tr>
+
  <tr>
 +
    <td></td>
 +
    <td><br></td>
 +
  </tr>
 +
  <tr>
 +
    <td>Solution</td>
 +
    <td>In most instances, the solution is changing a setting in your preferences. You can find that setting here: Edit &rarr; Preferences &rarr; Graphics. And, you toggle the ''Use Off-screen Rendering'' setting. '''If it's off, then you turn it on'''. '''If it's on, then you turn it off'''. After changing this setting, you ''<b>must</b> exit and restart OpenRocket for the change to take effect''.</td>
 +
  </tr>
 +
  <tr>
 +
    <td></td>
 +
     <td>'''[[File:OR.Download-Install.Check_Settings.Rendering.03.Box_Check.04.png|left|frameless|720 px|center]]'''</td>
 +
  </tr>
 
   <tr>
 
   <tr>
     <td>&bull; Source code (.tar.gz)</td>
+
     <td></td>
    <td>[https://github.com/openrocket/openrocket/archive/refs/tags/release-22.00.beta.01.tar.gz OpenRocket-22.00.beta.01.tar.gz]</td>
+
     <td>Experience has shown that those who use Apple Silicon Macs should uncheck this box, and those who use Windows should check this box. But, your OS platform may differ. If this does not correct the issue, contact development.</td>
     <td>[https://github.com/openrocket/openrocket/archive/refs/tags/release-15.03.tar.gz OpenRocket-15.03.tar.gz]</td>
+
  </tr>
  </tr>
 
 
</table>
 
</table>
  
== Installation Help ==
+
<br>
  
[[Windows OS]]
+
----
  
[[macOS]]
+
<div style="text-align: center;">
 
+
<div style="float: left;">&larr; [[FAQ|Go to Frequently Asked Questions]]</div>
[[Linux OS]]
+
<div style="float: right;">[[Tips|Go to Tips and Tricks &rarr;]]</div>
 
+
[[Component Details|&uarr; Go to Component Details]]
[[Other Installations]]
+
</div>
 
 
=== <u>macOS</u> ===
 
 
 
Download the DiskImage file for the version of OpenRocket that you want, open it, and you'll see a big icon for OpenRocket, and a shortcut to your Application folder. Drag OpenRocket to the Application Folder, let it finish copying, and you're done.
 
 
 
<p>[https://github.com/openrocket/openrocket/releases/download/release-22.00.beta.01/OpenRocket-22.00.beta.01.dmg OpenRocket 22.00.beta.01 Application DiskImage for macOS <font color="red">(INACTIVE UNTIL RELEASE DATE)</font color>]</p>
 
<p>[https://github.com/openrocket/openrocket/releases/download/release-15.03/OpenRocket-15.03.dmg OpenRocket 15.03 Application DiskImage for macOS]</p>
 
 
 
=== <u>Linux</u> ===
 
 
 
Before beginning, you will need to have the FUSE filesystem installed; most distributions have it installed by default. Download the AppImage file for the version of OpenRocket that you want, and run it by double-clicking, or from the command line.
 
 
 
<p>[https://github.com/openrocket/openrocket/releases/download/release-22.00.beta.01/OpenRocket-22.00.beta.01.AppImage OpenRocket 22.00.beta.01 AppImage for Linux <font color="red">(INACTIVE UNTIL RELEASE DATE)</font color>]
 
<p>[https://github.com/openrocket/openrocket/releases/download/release-15.03/OpenRocket-15.03.AppImage OpenRocket 15.03 AppImage for Linux]</p>
 

Latest revision as of 03:19, 9 February 2023

↑ Back to Main Page

Overview[edit]

Now available for download. . . OpenRocket 2022.02 has been released.

OpenRocket 2022.02 is now available for Windows, macOS and Linux. The easiest way to get OpenRocket up and running is to download and install one of the packaged installers. The Packaged Installers come with everything needed, including the correct version of Java; you will not need to install, update or downgrade Java on your device to run them.

For security reasons, download files for all available versions and releases of OpenRocket are now on, and should only be downloaded from the official OpenRocket website here:

https://openrocket.info/

OpenRocket 2022 Pre-Installation Procedures[edit]

A few users have reported difficulties with installing new versions of OpenRocket, and some of these relate to pre-installation procedures. Before beginning the installation of OpenRocket, the following actions should be undertaken.

Close All Instances of OpenRocket[edit]

By default, all 2022 releases of OpenRocket install to the same location on your device; these releases even share preference and use files with version 15.03. Because of this, if OpenRocket is open when you attempt to install an updated release, the installation may not update all of the files needed for OpenRocket to function correctly.

Before installing an update, you MUST close all open instances of OpenRocket.

Uninstall Prior OpenRocket Releases[edit]

As described above, by default, all 2022 releases of OpenRocket install to the same location on your device. Although not expressly required, it is suggested that all previously installed 2022 OpenRocket releases be uninstalled before installing the updated release. This is not required, but is suggested to ensure the proper function of OpenRocket.

OpenRocket 2022 After-Installation Checks[edit]

Verify the Installed Release Number[edit]

A few users have reported that new installations of OpenRocket are not functioning correctly, only to find out that the wrong beta release was installed. After your installation is complete, and before doing anything else, verify that you actually installed the current release of OpenRocket by undertaking the following steps:

Step What You Should See
1

If the release number shown in both images below is not OpenRocket Version 2022.02, then you have installed the wrong release of the OpenRocket. Uninstall that release, download the new release, and try again.

Splash Screen
2022.03.Splash Screen.png
Help → About
2022.02.Help Screen.png
2

If the circled icons shown in the image below are different that yours, then you have installed the wrong beta release of OpenRocket. Uninstall that release, download the new beta release, and try again.

Component Icons
03.03.01.Components.png
File Menu Icons
03.04.02.File Menu.png

Check Settings[edit]

If everything looks good there, let's check settings.

Setting What You Should Do
Off-screen Rendering

Some users have reported that the rocket shown in the design window is not full-size. This can occur if the off-screen rendering setting is not correct for your device. Using the Three-stage rocket example packaged with OpenRocket, this is what the problem looks like:

Too small
2022.02.Off Screen.png
Correct size
2022.01.Off Screen.png

Solution In most instances, the solution is changing a setting in your preferences. You can find that setting here: Edit → Preferences → Graphics. And, you toggle the Use Off-screen Rendering setting. If it's off, then you turn it on. If it's on, then you turn it off. After changing this setting, you must exit and restart OpenRocket for the change to take effect.
OR.Download-Install.Check Settings.Rendering.03.Box Check.04.png
Experience has shown that those who use Apple Silicon Macs should uncheck this box, and those who use Windows should check this box. But, your OS platform may differ. If this does not correct the issue, contact development.



↑ Go to Component Details