Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#FFBDAD

Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-installation---upgrade-guides/upgrade-zephyr-enterprise/troubleshoot.html

1. If Zephyr fails to launch on the browserand you get the following error: -
HTTP Status 501 Not Implemented
Type Status report
Message Method [tok] is not implemented by the Servlet for this URI


Solution:

While upgrading to Zephyr Enterprise 7.18.0 version, if you are using any monitoring tool integrated with Zephyr, you need to remove the settings.

You must follow the steps below:

For Linux

  1. In the ZE, navigate to Setenvsetenv.sh in the {ZephyrDir}/tomcat/bin folder.

  2. Open the Setenvsetenv.sh file in any editor and add confirm if the below line to is present in the file.
    Delete lines other than these lines present in the file.

    Code Block
    export JAVA_HOME=/usr/java/jdk1.8.0_151export151
    export CATALINA_PID=/home/zephyr/zephyr/bin/zephyr.pidexportpid
    export JAVA_OPTS="-server -Xms2048m -Xmx4096m -XX:MaxMetaspaceSize=512m Dorg.terracotta.quartz.skipUpdateCheck=true -Djava.awt.headless=true"

For Windows

  1. Open the command prompt.

  2. Navigate to the location where Zephyr is installed {ZephyrDir}/\tomcat/\bin

  3. Type the command-
    tomcat9w.exe //ES//Zephyrserver

  4. The Zephyr Server Properties open.

  5. Navigate to Java option in the Zephyr Server Properties.


  6. In the Java Options, add the below line:
    confirm if the below lines are present in the file.
    Delete lines other than these lines present in the file.:

    Code Block
    -XX:MaxMetaspaceSize=512m

    
    -Dorg.terracotta.quartz.skipUpdateCheck=true

    
    -Dcatalina.home=C:\Program Files\Zephyr\tomcat

    
    -Dcatalina.base=C:\Program Files\Zephyr\tomcat

    
    -Djava.endorsed.dirs=C:\Program Files\Zephyr\tomcat\endorsed

    
    -Djava.io.tmpdir=C:\Program Files\Zephyr\tomcat\temp

    
    -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager

    
    -Djava.util.logging.config.file=C:\Program Files\Zephyr\tomcat\conf\logging.properties
  7. Click Ok and then Apply.

2. For Linux:
When changing the ownership from Root to Non-root, if Zephyr fails to launch on the browserand you get the following error in the catalina.log file:

Code Block
29-Aug-2023 11:42:58.073 INFO [main] org.apache.coyote.AbstractProtocol.init Initializing ProtocolHandler ["http-nio-80"]
29-Aug-2023 11:42:58.099 SEVERE [main] org.apache.catalina.util.LifecycleBase.handleSubClassException Failed to initialize component [Connector[HTTP/1.1-80]]
        org.apache.catalina.LifecycleException: Protocol handler initialization failed
                at org.apache.catalina.connector.Connector.initInternal(Connector.java:1011)
                at org.apache.catalina.util.LifecycleBase.init(LifecycleBase.java:136)
                at org.apache.catalina.core.StandardService.initInternal(StandardService.java:549)
                at org.apache.catalina.util.LifecycleBase.init(LifecycleBase.java:136)
                at org.apache.catalina.core.StandardServer.initInternal(StandardServer.java:1041)
                at org.apache.catalina.util.LifecycleBase.init(LifecycleBase.java:136)
                at org.apache.catalina.startup.Catalina.load(Catalina.java:724)
                at org.apache.catalina.startup.Catalina.load(Catalina.java:746)
                at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
                at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
                at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
                at java.lang.reflect.Method.invoke(Method.java:498)
                at org.apache.catalina.startup.Bootstrap.load(Bootstrap.java:307)
                at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:477)
        Caused by: java.net.SocketException: Permission denied
                at sun.nio.ch.Net.bind0(Native Method)
                at sun.nio.ch.Net.bind(Net.java:461)
                at sun.nio.ch.Net.bind(Net.java:453)
                at sun.nio.ch.ServerSocketChannelImpl.bind(ServerSocketChannelImpl.java:222)
                at org.apache.tomcat.util.net.NioEndpoint.initServerSocket(NioEndpoint.java:276)
                at org.apache.tomcat.util.net.NioEndpoint.bind(NioEndpoint.java:231)
                at org.apache.tomcat.util.net.AbstractEndpoint.bindWithCleanup(AbstractEndpoint.java:1317)
                at org.apache.tomcat.util.net.AbstractEndpoint.init(AbstractEndpoint.java:1330)
                at org.apache.coyote.AbstractProtocol.init(AbstractProtocol.java:652)
                at org.apache.coyote.http11.AbstractHttp11Protocol.init(AbstractHttp11Protocol.java:75)
                at org.apache.catalina.connector.Connector.initInternal(Connector.java:1009)
                ... 13 more

Solution:
You need check the port in server.xml file.

You must change the port in the server.xml file from 80 to 1024 and above.

3. If upgrade to Zephyr Enterprise v7.19.0 is taking longer than expected?
OR
If during upgrade to Zephyr Enterprise v7.19.0, you encounter an error?

Solution:

If you experience an extended upgrade duration or encounter the patch_0176 failed due to The total number of locks exceeds the lock table size error, follow these steps:

  1. Extended Upgrade Time: Be prepared for longer upgrade times, especially with extensive historical data due to the introduction of patch_0176.

  2. Downtime Planning: Anticipate potential downtime and plan accordingly to minimize disruptions during the upgrade.

  3. Error Resolution: In case of the "lock table size" error, review the MySQL settings and consider adjusting the innodb_buffer_pool_size configuration as needed.

If you require further assistance or encounter additional issues, we encourage you to contact our support team for resolution.