win-en
Differences
This shows you the differences between two versions of the page.
Previous revision | |||
— | win-en [2022/03/25 18:19] (current) – [General] smitt48 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Installing Rocrail on Windows ====== | ||
+ | \\ | ||
+ | [[https:// | ||
+ | \\ | ||
+ | |||
+ | |||
+ | ===== Introduction ===== | ||
+ | Rocrail is provided for Windows as a ZIP file with - among others - the following advantages: | ||
+ | |||
+ | * No installation((The terms installation, | ||
+ | * Unpacking to (almost) any place on the computer. | ||
+ | * No active((Windows itself enters recently used documents etc. into the registry. This may still cause entries in the registry that refer to Rocrail)) Modification of the Windows registry - safe trial and error and trackless deletion possible. | ||
+ | * All files in one place. | ||
+ | * Installation on a suitable USB stick or portable drive. This allows convenient editing at the workplace and system operation at a remote location (e.g. basement, club home) without having to copy or synchronize files. | ||
+ | * Easy copying of the entire installation to a USB stick or other portable drive to take with you, e.g. to friends or a Rocrail meeting for presentation, | ||
+ | * Moving an installation to a new computer, to another drive etc. is easy and can be done with a few clicks. | ||
+ | |||
+ | \\ | ||
+ | ===== Supported Windows versions ===== | ||
+ | Rocrail runs on Windows versions starting with Windows XP. | ||
+ | * Windows XP, Vista are no longer supported in the forum! Installation may be possible, however, it is not recommended to use these versions. | ||
+ | * Windows 7, 8, 8.1 are limited supported((No test systems are available for these versions. For problems that exist exclusively under these versions and that cannot be reproduced under Windows 10, it is very likely that no solutions can be offered)). | ||
+ | * **Windows 10**. | ||
+ | * **Windows 11**. | ||
+ | The following chapters refer to the current Windows 10 and 11. | ||
+ | |||
+ | \\ | ||
+ | ===== General ===== | ||
+ | The following two points must be observed: | ||
+ | - Special characters, such as umlauts, should generally be avoided. This is valid for Windows user names, folder names of the Rocrail installation and superordinate folders, as well as file names of e.g. locomotive pictures etc. \\ If the Windows user name contains umlauts, the correct installation may fail! \\ \\ By __removing__ the checkmark for UTF-8 in the **[[: | ||
+ | - If third party anti-virus, anti-malware or firewall programs are used, it is entirely the user's responsibility to configure them in such a way that they do not hinder the proper installation and functioning of Rocrail and its components! \\ In case of doubt, such programmes are to be deactivated. \\ \\ As of Windows 10, such additional programmes are generally considered unnecessary in a private environment. | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ===== 1. Installation ===== | ||
+ | This chapter describes how to download and install Rocrail for the first time. | ||
+ | |||
+ | If switching from an existing old installation created with setup.exe to the ZIP installer, there is a separate guide available, see **[[: | ||
+ | |||
+ | \\ | ||
+ | ==== 1.1 Download ==== | ||
+ | The daily updated ZIP file can be downloaded from the **[[https:// | ||
+ | |||
+ | Depending on the browser used, a left click will either save the file in a central download directory or open a dialogue box to specify the desired location. Alternatively, | ||
+ | |||
+ | \\ | ||
+ | ==== 1.2 Installing ==== | ||
+ | === 1.2.1 Preparing the unpacking === | ||
+ | Locate the downloaded ZIP file in the file system at the previously noted location - here it was saved on the desktop. | ||
+ | |< >| | ||
+ | | {{: | ||
+ | | ZIP file | | ||
+ | |||
+ | Open the context menu of the file (right click on the file) and select the item **Extract All...**. | ||
+ | |||
+ | > **Note:** The following steps are described using the unpacker included in Windows. If third-party software for unpacking has been installed, it is the user's responsibility to perform equivalent operations with that software. | ||
+ | |||
+ | |< >| | ||
+ | | {{: | ||
+ | | Context Menu | | ||
+ | |||
+ | The following dialogue opens: | ||
+ | | {{: | ||
+ | | Dialogue //Extract Compressed (Zipped) Folders// | | ||
+ | This dialogue shows the current location of the file in the field below '' | ||
+ | |||
+ | === 1.2.2 Creating the Rocrail folder === | ||
+ | Check the box next to '' | ||
+ | Instead of the displayed folder the folder where Rocrail should be installed has to be selected. First click on the button **Browse...**. | ||
+ | |||
+ | \\ | ||
+ | ^ Important: ^ | ||
+ | | The folder can be created (almost) anywhere on the PC. However, __it must not be created in protected areas of Windows!__ This includes the Program Files folder and the system folders of Windows. | | ||
+ | ^ It is recommended to create the folder '' | ||
+ | \\ | ||
+ | |||
+ | After clicking on **Browse...** Windows opens the dialogue //Select a destination//: | ||
+ | | {{: | ||
+ | | Select a destination | | ||
+ | As shown in the figure, the **Documents** folder should now be opened. Then a new folder is created by clicking on the button **New Folder**. It should be named '' | ||
+ | |||
+ | Windows will then return to the //Extract Compressed (Zipped) Folders// dialogue, which should now look like shown in the following section. | ||
+ | |||
+ | === 1.2.3 Unpacking === | ||
+ | | {{: | ||
+ | | Dialogue //Extract Compressed (Zipped) Folders// with destination folder \\ '' | ||
+ | |||
+ | Click on **Extract**. \\ | ||
+ | The files are now extracted. This process may take a while, depending on the operating system settings, Windows Defender and computer performance. In the meantime, Windows will show the progress: | ||
+ | |< >| | ||
+ | | {{: | ||
+ | | Progress graphic in the view //More details// | | ||
+ | |||
+ | When the extraction is complete, Windows displays the contents of the newly created folder as the result: | ||
+ | | {{: | ||
+ | | Typical result after extraction. \\ The exact folder content may change from time to time as Rocrail evolves. | | ||
+ | |||
+ | This completes the installation as such. Finally, a shortcut has to be created on the desktop. | ||
+ | |||
+ | \\ | ||
+ | ==== 1.3 Creating a desktop shortcut==== | ||
+ | If the extraction of the files was done with the above settings, the folder Rocrail was opened automatically((If not: start the Windows-Explorer (e.g. with the key combination < | ||
+ | |||
+ | | {{: | ||
+ | | File desktoplink.cmd in Rocrail folder | | ||
+ | A double click on the file '' | ||
+ | |||
+ | |< >| | ||
+ | | {{: | ||
+ | | Rocview desktop icon | | ||
+ | |||
+ | \\ | ||
+ | ^ It is mandatory to start Rocrail using this shortcut! ^ | ||
+ | \\ | ||
+ | |||
+ | > **Note:** If the desktop shortcut cannot be created on the system with this procedure, the shortcut created in the '' | ||
+ | |||
+ | > **Tip:** The shortcut can be pinned to the taskbar or to " | ||
+ | |||
+ | \\ | ||
+ | ===== 2. Windows Defender ===== | ||
+ | When creating the shortcut, the first start of Rocview and the first start of the Rocrail server, warnings of the Windows Defender can be displayed. This also applies after updates. The warnings should be handled as follows: | ||
+ | |< >| | ||
+ | | {{win: | ||
+ | | Click on " | ||
+ | |||
+ | |||
+ | \\ | ||
+ | ===== 3. Updating the Rocrail installation ===== | ||
+ | | Important: To update a very old (older than approx. May 2020) installation that was created with a setup file (rocrail-xxx-win32.exe or rocrail-xxx-win64.exe), | ||
+ | Rocrail is constantly evolving and should always be kept up to date. For regular, for example monthly updates, complete updates are recommended, | ||
+ | |||
+ | In some cases it is useful to follow the current development with more frequent updates, for example once or twice a week or even daily. Such updates can be limited to essential parts of the program, see section [[# | ||
+ | |||
+ | > **Note:** Quit Rocrail completely before each update! | ||
+ | |||
+ | \\ | ||
+ | ==== 3.1. Complete update ==== | ||
+ | * Download a current ZIP file ([[# | ||
+ | * Prepare unpacking ([[# | ||
+ | * Remove the checkmark at '' | ||
+ | * Click on the **Browse** button. | ||
+ | |||
+ | Dialogue // Select a destination// | ||
+ | | {{: | ||
+ | | Dialogue // Select a destination// | ||
+ | In this dialogue the folder where Rocrail was installed has to be selected. Normally this is the folder '' | ||
+ | The folder is selected as shown in the figure and the **Select Folder** button is clicked. | ||
+ | |||
+ | * Continue with the [[# | ||
+ | |||
+ | After all files have been extracted, Windows will ask how to handle existing files: | ||
+ | |< >| | ||
+ | | {{: | ||
+ | | Dialogue // Replace or skip files// | | ||
+ | In this dialogue, click on **Replace the files in the destination**. \\ | ||
+ | The update is now complete. | ||
+ | |||
+ | \\ | ||
+ | ==== 3.2 Quick Update ==== | ||
+ | * Download a current ZIP file ([[# | ||
+ | * Open the downloaded ZIP file by double-clicking it. | ||
+ | |||
+ | Prepare the '' | ||
+ | | {{: | ||
+ | | Extracting the '' | ||
+ | |||
+ | > **Attention: | ||
+ | |||
+ | The dialogue //Extract Compressed (Zipped) Folders// opens. | ||
+ | |||
+ | * The check mark at '' | ||
+ | * Click on the **Browse** button. | ||
+ | |||
+ | Find the folder '' | ||
+ | |||
+ | | {{: | ||
+ | | Selecting folder '' | ||
+ | |||
+ | Windows jumps back to the dialogue //Extract Compressed (Zipped) Folders//, in which '' | ||
+ | |||
+ | * Click on the **Extract** button. | ||
+ | * Confirm overwriting existing files as described in the [[# | ||
+ | |||
+ | \\ | ||
+ | ===== 4. Moving an Installation ===== | ||
+ | Rocrail ZIP installations can be moved easily by moving the folder where Rocrail has been unzipped to the desired location. In the example on this page Rocrail was unpacked into the folder '' | ||
+ | |||
+ | > **Tip:** It is just as easy to copy a Rocrail ZIP installation e.g. to a mobile data medium (hard disk, USB stick, etc.) for backup or for use at another location. | ||
+ | |||
+ | > **Notes:** It is essential that all files and data belonging to Rocrail are stored in the Rocrail folder. This applies for example to workspaces, loco pictures, self created SVG theme folders etc. \\ Subsequently inserted absolute paths((During the first installation all paths are relative, e.g. the path for the image directory. This is indicated as '' | ||
+ | |||
+ | |||
+ | ==== 4.1 Moving to another location on the same computer ==== | ||
+ | - Move the folder '' | ||
+ | - After moving, run the file '' | ||
+ | |||
+ | > **Note:** An existing shortcut on the desktop is updated by executing '' | ||
+ | |||
+ | |||
+ | ==== 4.2 Moving to another computer ==== | ||
+ | Moving the ZIP installation to another computer is done in the same way as described above. | ||
+ | |||
+ | > **Note:** However, a 64bit installation only runs on a 64bit machine! Rocrail 32bit can be used on both a 32bit and a 64bit machine. | ||
+ | |||
+ | When connecting hardware, e.g. command stations, it must be ensured that the connection settings (e.g. COM ports, IP addresses, etc.) are adapted to the new conditions. Adjustments may also be necessary within the command station or hardware in general, if for example the IP address of the Rocrail server has to be entered there. |