I like shiny new things. Apparently I’m attracted to flashing lights aswell, which explains the working in IT.
FWIW, in my mind, I was justifying the use of .Net4.5 and access to the new parallelism functionality that is available.
Because I like new toys, and because I didn’t really have a hope of getting budget approval for an Infor upgrade of Smart Office, I figured I’d do some research, use my DR environment and test doing an upgrade by myself.
During the research I came across two major stumbling blocks.
1). Our M3 UI Adapter wasn’t supported under 10.1
2). Smart Office doesn’t get upgraded, it gets replaced <sigh>
So, pouring over the documentation in my usual manner I looked to see if I could run multiple grids against a single BE and couldn’t find an answer – this may well have been because there wasn’t a section that said “Running Multiple Grids against a Single BE” but that’s a conversation for another day.
I caved and flicked a quick message to the resident Infor techy and asked “Can you have multiple grids against the same BE” which resulted in a resounding (ok, somewhat paraphrased) “not sure”.
This meant I was going to have to take a risk and potentially hose one of my environments and then get someone in to fix the issue. Not really something that appeals to me but I was planning on using my DR environment to test against. The beauty of this is, AS400 aside, the supporting services are all virtualised and get refreshed each night. Plus they have snapshots that I can quickly and easily revert back to.
As it turned out, doing the upgrade on my DR environment turned out to be a real drama that was going to absorb far too much time so I took a calculated risk and decided to try against our TEST environment. Our TEST environment has only been used a few times over the last 12 months and most people test in DEVE – don’t ask.
To make me more nervous, we have our production AS400, it runs our DEVE, PROD and TEST environments (we are a small company, so even with the AS400 we run, it’s more than capable of hosting the lot and more). Likewise, our Smart Office server has three environments, DEVE, PROD, TEST.
Upgrading one environment shouldn’t affect any of the others, but it really just didn’t feel good.
My plan of attack became:
1). Upgrade the M3 UI Adapter (10.0.1.0 to 10.2.1.0)
2). Ensure that Smart Office 10.0.5.2.x still works without issue
3). Export the Smart Office settings using the MangoAdminTool
4). Uninstall Smart Office 10.0.5.2
5). Install Smart Office 10.1.1.0.x
6). Import Smart Office settings and Test
7). Congratulate myself heartily for my death defying feat
It’s worth nothing that I did upgrade all the components under the grid that didn’t require a new version before I took on this challenge.
So, I went through and casually documented the upgrade of the TEST environment and after a few missteps got it working and upgraded the DEVE environment (which is what we’ll actually run through shortly).
First I’ll mention some of the things I discovered on my first upgrade:
- M3 UI Adapter sucks a heap of the settings from the mne.properties file (mne\WEB-INF\properties) in to the H2 database. It appears to assume that the mne data (languages, view definitions etc) are under the mne directory (LifeCycle\<server>\grid\<environment>\applications\M3_UI_Adapter\webapps\mne). Unfortunately for us, this wasn’t the case.
This created a few headaches for me trying to get things running correctly. Copying the contents of mne_data_<environment> under the WEB-INF dir after the install seemed to work. On my second attempt I did this before upgrading the UI Adapter which worked like a charm.
- Exporting the Smart Office settings (including the profile). If you’ve been good and exercised due diligence by reading the http://smartofficeblog.com/ blog you’ll know that you need to upgrade to 10.0.5.2.x to export the settings before you can import them with the MangoAdminTool in 10.1.1.0.x
The trap however (if you’re working on the No.8 Fencing Wire method as I am) is that when you use the MangoAdminTool to export the settings it will export them in to the Smart Office environment directory on the Smart Office server. This is an issue if you happen to UNINSTALL Smart Office after you have exported (of-course you can’t export the settings after the uninstall ;-)) – the exported file of-course gets deleted. Funnily enough during my first upgrade, I had actually copied my file to my local machine so I could have a wee nosey at what the file contained. But then I deleted it <sigh>
The moral is, copy the settings file to your local machine – the MangoAdminTool has the facility to do this.
- After installing the MangoServer and starting it, it appeared that the Grid didn’t recognise the registration (possibly because I had uninstalled an existing Smart Office first). I needed to shutdown the Grid for that environment and restart it for Smart Office to correctly register. Incidentally, the registrations look like they are stored in the following file https://<grid registry server>:<grid environment port>/grid/info.xml
- Take snapshots of your existing Smart Office profile – you’ll feel better for it 🙂
And finally, I wouldn’t recommend doing this unless you REALLY REALLY know what you are doing. Seriously! If you choose to follow these steps they are at your own risk.
I’ll admit, I didn’t know enough about what I was doing but I have a fairly good understanding of how the M3 components work, a solid troubleshooting methodology, snaphots, a DR environment to compare against and had the luxury of an environment that I could hose.
I think the first install took around 1.5 hours, second a fraction of that. The really good thing was that I gained some more insight in to how the components fit together.
So here goes…
Upgrading the M3 UI Adapter
Copy the mne data in to the ‘default’ location (Automations, Customizations, DocumentLinks, Env_<environment id>, Help, Languages, MvxSys, UserSettings, ViewDefinitions)
Eg \\wlso02\c$\mne_data_Deve to \\wlso02\c$\LifeCycle\WLSO02\grid\IFL_DEVE\applications\M3_UI_Adapter\webapps\mne\WEB-INF
We do this as the new M3 UI Adapter doesn’t honour the path in the mne.properties file
- In LifeCycle Manager we upgrade the M3 UI Adapter
- We can click on the Progress tab at the bottom of LifeCycle Manager. An upgrade successful message will appear if the upgrade worked. Click on OK
- Start the M3 UI Adapter
We can see that we are at the new version
- Verify that the existing Smart Office (10.0.5.2) is running correctly
Upgrading Smart Office
In the LifeCycle Manager I use the Hosts tab unless otherwise noted.
- Export all of the settings using the 10.0.5.2 MangoAdminTool. You need 10.0.5.2 to retrieve these settings!
- Set up your configuration – the environment name and the URI to connect to Smart Office
- I will export everything.
Note: be aware that as we are going to uninstall our existing Smart Office, that the directory the data is exported to on the Smart Office server gets deleted! You MUST download the file before you uninstall.
- Download to local machine
- Stop Smart Office Instance
- Uninstall existing Smart Office
- Click on OK for the uninstalled message. You should see something like this now.
- Install new Smart Office (under the Applications tab)
- Select Environment
Default System Profile Name – I just used DEVE as that was what my old one was
Suffix – I’ve seen a number of consultants with a bagillion Smart Office instances installed, so I wanted to make the Suffix descriptive for them so it looks like so when installed
Which server should it be installed on?
Summary page, click on Finish
- Note it now says “MangoServer” – hopefully no more naming confusion 🙂
Now we do the standard “Export Server Information” – this will be used to sign Smart Office
Select an appropriate directory
Click on Finish
Now we need to Sign our Smart Office install – you need the cert that you have previously signed Smart Office with.
If all went well, then the install gets signed and is ready to be imported in to the Install Point.
Import our signed install
Locate where the install file was output to in step 16
And we should see that all is good in the world!
Shutdown all the components for the environment – including the Grid itself. The grid/info.xml won’t get updated with the new services until that point
- Because we uninstalled we need to set our rights back up
- Edit User and Role Mappings as appropriate
- And now we use the Mango Admin Tool to Import the old settings
- Upload the settings we downloaded
- Click Yes
And then I was able to install Smart Office on my machine.