Difference between revisions of "Downloading & Installing"

From OpenRocket wiki
Jump to navigation Jump to search
 
(38 intermediate revisions by 2 users not shown)
Line 9: Line 9:
 
== Overview ==
 
== Overview ==
  
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 ''don't'' need to install, update or downgrade Java on your machine to run them.'''
+
<font size="5"; color="red">''Now available for download. . .''  </font> <font size=5>OpenRocket '''''2022.02''''' has been released.</font>
  
For security reasons, with the release of the <font color="red">''NEW''</font color> '''22.02 Beta 2''', ''download files for all available releases of OpenRocket '''may be obtained from the official OpenRocket website'' at:'''
+
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.'''
  
<table style="width:900px">
+
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:'''
  <tr>
+
 
    <td></td>
+
:[https://openrocket.info/ <span style="color:blue"><b>https://openrocket.info/</b>]
    <td>[https://openrocket.info <span style="color:blue"><b>OpenRocket.info</b>]</td>
 
  </tr>
 
</table>
 
  
 +
== OpenRocket 2022 Pre-Installation Procedures ==
  
<table class="wikitable" style="width:900px">
+
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.  
  <tr>
 
    <th>Downloadable File Type</th>
 
    <th>OpenRocket 22.02.beta.01<br/>
 
<span style="color:red">(2022 BETA RELEASE -- ACTIVE)</th>
 
  </tr>
 
  <tr>
 
    <td>Windows packaged installer</td>
 
    <td>[https://github.com/openrocket/openrocket/releases/download/release-22.02.beta.01/OpenRocket-22.02.beta.01-Windows.exe <b>OpenRocket-22.02.beta.01-Windows.exe</b>]</td>
 
  </tr>
 
  <tr>
 
    <td>macOS packaged installer</td>
 
    <td>[https://github.com/openrocket/openrocket/releases/download/release-22.02.beta.01/OpenRocket-22.02.beta.01-macOS.dmg <b>OpenRocket-22.02.beta.01-macOS.dmg</b>]</td>
 
  </tr>
 
  <tr>
 
    <td>Linux packaged installer</td>
 
    <td>[https://github.com/openrocket/openrocket/releases/download/release-22.02.beta.01/OpenRocket-22.02.beta.01-Linux.sh <b>OpenRocket-22.02.beta.01-Linux.sh</b>]</td>
 
  </tr>
 
</table>
 
  
== Installation Help ==
+
=== Close All Instances of OpenRocket ===
  
[[Windows OS]]
+
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.
  
[[macOS]]
+
''Before installing an update'', you '''MUST''' close all open instances of OpenRocket.
  
[[Linux OS]]
+
=== Uninstall Prior OpenRocket Releases ===
  
[[Other Installations|.jar and Other Installations]]
+
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.
  
== 2022 Beta After-Installation Checks ==
+
== OpenRocket 2022 After-Installation Checks ==
  
=== Verify the Version Installed ===
+
=== Verify the Installed Release Number ===
  
<p>A few users have complained about new installations of OpenRocket not running correctly, only to find out that the wrong version was installed. After your installation is complete, and before doing anything else, verify that you actually installed OpenRocket.22.02.beta.01 taking the following steps:
+
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">
 
<table class="left">
Line 63: Line 43:
 
   </tr>
 
   </tr>
 
     <th>1</th>
 
     <th>1</th>
     <td><p>If the version number shown in <i><b>both</b></i> images below is not <b>OpenRocket.22.02.beta.01</b>, <i>then you have installed the wrong version of OpenRocket</i>. Uninstall that version, download the new version, and try again.</p></td>
+
     <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>Splash Screen</td>
 
     <td>Splash Screen</td>
     <td>'''[[File:OR.Version_Verify.01.Splash_Screen.02.png|left|frameless|384 px|center]]'''</td>
+
     <td>'''[[File:2022.03.Splash_Screen.png|left|frameless|640 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
 
     <td>Help &rarr; About</td>
 
     <td>Help &rarr; About</td>
     <td>'''[[File:OR.Version_Verify.02.Help-About_Screen.02.png|left|frameless|384 px|center]]'''</td>
+
     <td>'''[[File:2022.02.Help_Screen.png|left|frameless|384 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
     <th>2</th>
 
     <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 version of OpenRocket</i>. Uninstall that version, download the new version, and try again.</p></td>
+
     <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>  
 
   <tr>
 
   <tr>
 
     <td>Component Icons</td>
 
     <td>Component Icons</td>
     <td>'''[[File:OR.Version_Verify.03.Component_Icons.02.png|left|frameless|720 px|center]]'''</td>
+
     <td>'''[[File:03.03.01.Components.png|left|frameless|720 px|center]]'''</td>
 +
  </tr>
 +
  <tr>
 +
    <td>File Menu Icons</td>
 +
    <td>'''[[File:03.04.02.File_Menu.png|left|frameless|512 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
</table>
 
</table>
Line 96: Line 80:
 
   <tr>
 
   <tr>
 
     <td>Too small</td>
 
     <td>Too small</td>
     <td>'''[[File:OR.Download-Install.Check_Settings.Rendering.01.png|left|frameless|512 px|center]]'''</td>
+
     <td>'''[[File:2022.02.Off_Screen.png|left|frameless|512 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
 
     <td>Correct size</td>
 
     <td>Correct size</td>
     <td>'''[[File:OR.Download-Install.Check_Settings.Rendering.02.png|left|frameless|512 px|center]]'''</td>
+
     <td>'''[[File:2022.01.Off_Screen.png|left|frameless|512 px|center]]'''</td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
Line 108: Line 92:
 
   <tr>
 
   <tr>
 
     <td>Solution</td>
 
     <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 <i>Use Off-screen Rendering</i> setting.  <b>If it's off, then you turn it on</b>. <b>If it's on, then you turn it off</b>. After changing this setting, you <i><b>must</b> exit and restart OpenRocket for the change to take effect</i>.</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>
 
   <tr>
 
   <tr>

Latest revision as of 02: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