Last updatedOct 1, 2019

Rate this page:

How to upgrade AO to 0.18.x in JIRA 5

Prior to JIRA 5 RC3, in order to test the new version of AO you'll need to install it yourself. This is described in the procedure below, and is intended for testing only, not for use in production.

Manually installing new AO version into older JIRA

Manually installing version 0.18.1 or above of ActiveObjects also requires manually upgrading the Activity Streams plugin. Since they each contain multiple components that must be upgraded together, they can't be upgraded through UPM.

AO and Streams jar files overview

ActiveObjects consists of two plugins and one library located in the WEB-INF/lib directory. Activity Streams consists of 8 plugins. In the lists below, $AO_VERSION is the current ActiveObjects plugin version (0.18.1) and $STREAMS_VERSION is the current Activity Streams version (5.1.m3).

Plugins to be installed into home/plugins/installed-plugins/: (note that these will override previous versions that are in home/plugins/.bundled-plugins):

  • activeobjects-plugin-$AO_VERSION.jar
  • activeobjects-jira-spi-$AO_VERSION.jar
  • streams-aggregator-plugin-$STREAMS_VERSION.jar
  • streams-api-$STREAMS_VERSION.jar
  • streams-core-plugin-$STREAMS_VERSION.jar
  • streams-inline-actions-plugin-$STREAMS_VERSION.jar
  • streams-jira-inline-actions-plugin-$STREAMS_VERSION.jar
  • streams-jira-plugin-$STREAMS_VERSION.jar
  • streams-spi-$STREAMS_VERSION.jar
  • streams-thirdparty-plugin-$STREAMS_VERSION.jar

Library to be installed into WEB-INF/lib/: (note that the previous version in WEB-INF/lib/ must be deleted)

  • activeobjects-spi-$AO_VERSION.jar

Upgrading AO

All of the files need to be upgraded together before JIRA is restarted.

  1. Shut down JIRA
  2. Copy jar files in the first list above to home/plugins/installed-plugins/
  3. Delete jar file webapp/WEB-INF/lib/activeobjects-spi-*.jar
  4. Copy activeobjects-spi-$AO_VERSION.jar to webapp/WEB-INF/lib/
  5. Restart JIRA

If using AMPS

If you are launching JIRA along with your plugin via the Atlassian SDK, you can use the following configuration in your pom.xml to copy the appropriate jars into JIRA when it is launched. (Make sure to replace $AO_VERSION and $STREAMS_VERSION with the current version numbers.)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
<dependencies>
    <dependency>
        <groupId>com.atlassian.activeobjects</groupId>
        <artifactId>activeobjects-plugin</artifactId>
        <version>${ao.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.activeobjects</groupId>
        <artifactId>activeobjects-jira-spi</artifactId>
        <version>${ao.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.activeobjects</groupId>
        <artifactId>activeobjects-spi</artifactId>
        <version>${ao.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-aggregator-plugin</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-api</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-core-plugin</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-inline-actions-plugin</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-jira-inline-actions-plugin</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-jira-plugin</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-spi</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>com.atlassian.streams</groupId>
        <artifactId>streams-thirdparty-plugin</artifactId>
        <version>${streams.version}</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>com.atlassian.maven.plugins</groupId>
            <artifactId>maven-jira-plugin</artifactId>
            <configuration>
                <libArtifacts>
                    <libArtifact>
                        <groupId>com.atlassian.activeobjects</groupId>
                        <artifactId>activeobjects-spi</artifactId>
                        <version>${ao.version}</version>
                    </libArtifact>
                </libArtifacts>
                <pluginArtifacts>
                    <pluginArtifact>
                        <groupId>com.atlassian.activeobjects</groupId>
                        <artifactId>activeobjects-plugin</artifactId>
                        <version>${ao.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.activeobjects</groupId>
                        <artifactId>activeobjects-jira-spi</artifactId>
                        <version>${ao.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-aggregator-plugin</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-api</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-core-plugin</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-inline-actions-plugin</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-jira-inline-actions-plugin</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-jira-plugin</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-spi</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                    <pluginArtifact>
                        <groupId>com.atlassian.streams</groupId>
                        <artifactId>streams-thirdparty-plugin</artifactId>
                        <version>${streams.version}</version>
                    </pluginArtifact>
                </pluginArtifacts>
            </configuration>
        </plugin>
    </plugins>
</build>

<properties>
    <ao.version>$AO_VERSION</ao.version>
    <streams.version>$STREAMS_VERSION</streams.version>
</properties>

Rate this page: