Upgrading OpenRose in a Standalone Installation to v0.1.2-243

 


OpenRose is a FREE and Open Source Requirements Management Application / Tool. 

Download it from:

https://www.github.com/OpenRose

Upgrading OpenRose in a Standalone Installation 

Hello, welcome to OpenRose, a free and open-source requirements management application. Today, I’m going to talk about upgrading OpenRose on a standalone Windows installation.


The previous version, or the first version that was made available, was release v0.1.0.0. Now, we have the new version available, which is v0.1.2-243. This version includes some exciting feature enhancements, and I’m thrilled about the new capability that allows me to copy an entire project, item type, or item type with its hierarchical data included. Before we can use these capabilities, we need to upgrade to the latest version. In this video, I’m going to show you the simple steps to complete this upgrade.


Understanding the Installation


Let me start by opening the architectural diagram. This diagram shows that OpenRose has three components:  
  1. The Web UI, which allows users to connect through the browser.  
  2. The API interface, which communicates between the Web UI and the SQL Server database.  
  3. The SQL Server database itself.  

All three components are installed on a standalone computer. For this upgrade, we’re going to focus on the Web UI and API versions.

Now, let’s take a look at my current installation. My application is located on the C drive. The application is not running at the moment, but I can see the installation files. The zip files I downloaded in the past from the release page are no longer needed, so I’ll delete them.

In the current setup, I have:
  • API Version: v0.1.0.0  
  • Web UI Version: v0.1.0.0  

I’ve also downloaded the latest version of OpenRose into a temporary location on my C drive. The zip files are uncompressed into two subfolders: one for the API and one for the Web UI.


Migrating Configuration Files


One key step in the upgrade process is copying over the `appsettings.json` file from the previous version. This file is crucial for the following reasons:  
  • In the Web UI version, it defines the location of the API.  
  • In the API version, it defines the location of the SQL Server.  

This ensures smooth communication between the three components. To do this:
  1. Navigate to the API folder in the previous version and copy the "appsettings.json" file. Paste it into the latest API folder, replacing the existing file if prompted.
  2. Repeat the process for the Web UI folder, ensuring the new version has the correct "appsettings.json" file.


Finalizing the Upgrade


After migrating the configuration files, I’ll delete the old API and Web UI folders, as they are no longer needed. Then, I’ll copy the new API and Web UI folders into the application installation directory.

To start the upgraded application:
  1. Open the new API folder and run `OpenRose.API.exe`. This will launch the API service. Because it’s a local standalone installation, there’s no need to allow internet access. The API will also automatically upgrade the database schema if required.
  2. Open the new Web UI folder and run `OpenRose.WebUI.exe`. This will start the Web UI service, again without requiring internet access.

Verification


Now that both the API and Web UI are running, I can open the browser and connect to OpenRose via localhost. From the settings, I can verify that I’m on the latest version. Note: There’s a minor bug that causes the version display to exclude the build details. It would be nice to include this information in a future release.

All existing projects and data are accessible. I can explore the tree view to confirm that the upgrade didn’t affect any of the previous data.


Conclusion


These are the simple steps to upgrade your standalone installation of OpenRose. Thank you for your time, and I hope you enjoy the exciting new features in this version!




Comments

Post a Comment

Popular posts from this blog

Introduction to OpenRose - Requirements Management

Image
Watch it on YouTube at : https://www.youtube.com/watch?v=P0x3ZaHg8sA OpenRose - Requirements Management Application VIDEO TRANSCRIPT Hello, and thanks for joining in for the launch of OpenRose, an open-source requirements management application. The main purpose is to help users and teams "do it right" and ultimately reduce waste. OpenRose is released on GitHub at [github.com/OpenRose](https://github.com/OpenRose). Users can look at the source code and documentation at the same location. Let me do a quick demo of the application. In this environment, I'm using Windows 11 on a desktop computer, not a server. I have installed IIS and deployed a web deployment package over IIS. When you connect to OpenRose, on the homepage, you will see a welcome message like this: "Welcome to OpenRose." One would start by creating a new project. For this demo, I've created two separate projects. The first project is a small example of how I converted a document published b...
Read more

What is Requirement?

Image
What is Requirement? OpenRose - Requirements Management An Open Source and FREE Requirements Management Application / Tool Direct Link to YouTube Video : https://www.youtube.com/watch?v=3qQzKbfvRPA Video Transcript :   Hi, welcome to OpenRose, an open-source and free requirements management application. Please visit https://github.com/openrose for more information. Let's go to the project dashboard, and this time, let's open a deep hierarchical level project. This is just a demo project, so when I open that project in the TreeView and start expanding the project, I can see some sample item types along with a Parking Lot, which is the system item type. Inside item type one, I have a top-level item, then item one and item two, which are broken down into further items. You can see I've given the names which indicate a kind of logical hierarchical structure in the name. Here, you can see L1, L2, L3, L4—that's the level. The project is considered as level one, and item ...
Read more

Details View - OpenRose - Requirements Management

Image
    Details View OpenRose - Requirements Management An Open Source and FREE Requirements Management Application / Tool Direct Link to YouTube Video : https://www.youtube.com/watch?v=FC67o7lUy3I Video Transcript : Hello. OpenRose is a requirements management application, which is freely available and published on GitHub. Simply go to github.com/openrose to find more. Today, we will discuss the Details View. When you go into the Projects section where you can see your list of projects, there are two main views: the Tree View and the Details View. When I click on Details View, I enter the project one level at a time, or I exit the project one level at a time. Inside the project, we know that there are item types. In this particular view, we can see that I have a parking lot, which is a system item type, and four other item types that I have created. This is a public document published by Barkley's Bank, which I have tried converting into some sort of specification or requirem...
Read more