Last modified by Scott Gagan on 2021/09/10 22:40
Show last authors
1 This document contains information that is important to note when upgrading to iSymphony 3.1 release candidate 1. Please be sure to completely read the information before upgrading.
2
3 == Known Issues ==
4
5 Be sure to read the known issues section of the [[changelog>>doc:iSymphony 3\.5 Documentation.iSymphony Releases.Release Candidate Releases.iSymphony 3\.1 RC Release Notes.iSymphony 3\.1 RC 1 Changelog.WebHome]].
6
7 == Loss of Settings ==
8
9 Although we try to make every change backwards-compatible, in some cases the effort involved in that is simply impractical. When upgrading from iSymphony 3.0 to iSymphony 3.1 release candidate 1, take note of the following:
10
11 * The permission overhaul has changed the architecture of the permissions system significantly. Unfortunately, because of the complexity of the system and the number of potential edge cases that may be missed, we are not able to copy existing permission definitions over from the architecture used in version 3.0. As a result, **all permissions defined in version 3.0 will be cleared upon upgrade, and when the upgrade is complete, no permissions will be defined**. This means that you will need to redefine your permissions after upgrading. With the improvements to the batch editing, this should be significantly quicker and easier to do with version 3.1 than version 3.0. Note that this also includes access rules for extension directories, so on upgrade, all extension directories will be public by default.
12 * The existing queue widgets have been removed, and since significantly fewer total widgets are typically necessary with the new widget, we have elected to allow users to reconfigure their dashboards as they see fit. Therefore, all existing queue widgets will be removed from dashboards, and the new widget must be added back and configured as necessary.
13
14 == Other Notes ==
15
16 * Please note that as previously announced, iSymphony 3.1 drops support for Java 6. If you are running Java 6, you will need to upgrade to Oracle Java 7 or above. See the [[doc:iSymphony 3\.5 Documentation.iSymphony Installation and Update Guide.Supported Platforms.WebHome]] page for more details.
17
18 == Upgrade Steps ==
19
20 Follow these steps to upgrade iSymphony 3.x to iSymphony 3.1 RC 1:
21
22 1. Back up the entire /opt/isymphony3 directory before proceeding further. This is extremely important.
23 1. Download the beta package that corresponds to your original installation method (see [[doc:iSymphony 3\.5 Documentation.iSymphony Installation and Update Guide.Upgrading iSymphony.Determine the Installation Method.WebHome]] for more details). The installation packages can be found in our [[doc:iSymphony Knowledge Base.Downloads Archive.WebHome]], under the **Version 3 Development Builds** header.
24 1. (((
25 Follow the RPM or Tarball upgrade instructions to install your server. See [[doc:iSymphony 3\.5 Documentation.iSymphony Installation and Update Guide.Upgrading iSymphony.WebHome]] for more details.
26
27 {{info}}
28 The Automated upgrade method cannot be used for beta upgrades.
29 {{/info}}
30 )))
31
32 === Additional Upgrade Steps for Remote Agents ===
33
34 We have made significant improvements to our communication system in 3.1 RC 1. As a result, the method of specifying the broker for remote agents has changed. If you are using iSymphony with a remote agent, you //**must**// follow these additional steps to properly reconfigure the remote agent. Please note that these changes only need to be done on the remote agent, not on the main iSymphony server.
35
36 1. Ensure the iSymphony remote agent is not running, by shutting down the iSymphony server on the remote agent machine. See [[doc:iSymphony 3\.5 Documentation.iSymphony Administrator's Guide.Starting And Stopping The iSymphony Server.WebHome]] for more details.
37 1. (((
38 Edit the file /opt/isymphony3/server/jvm.args. Add a new line to the end with the following content:
39
40 {{code title="/opt/isymphony3/server/jvm.args"}}
41 -Dcom.xmlnamespace.panel.framework.jms.broker_url=tcp://<hostname>:<portname>
42 {{/code}}
43
44 Note the following:
45
46 1. Change the <hostname> placeholder to the hostname or IP address of your primary iSymphony server.
47 1. Change the <portname> placeholder to the port number that your primary iSymphony server is configured to set up its broker on. By default, this port is **51000**.
48 )))
49 1. Save and close the file, and start the iSymphony remote agent.
50
51

Search

Navigation

iSymphony