Share this page

# Troubleshooting

This section contains troubleshooting suggestions for issues relating to the installation.

For an up-to-date list of installation troubleshooters, see knowledge base article KM02703217.

### "OpenText Software Delivery Management displays an error indicating that the OpenText Software Delivery Management server is not responding. I cannot work in OpenText Software Delivery Management." (Linux)

If OpenText Software Delivery Management is under a very heavy load, it might try to use too many Linux resources. In this case, Linux kills the server process. Do the following to increase the number of allowed open files to 65536:

1. Open the /etc/security/limits.conf file.

2. Add the following line:

       octane hard nofile 65536

3. Restart the OpenText Software Delivery Management server.

### "I rebooted the OpenText Software Delivery Management server machine. The octane service did not start up automatically."

When you reboot the machine, you need to manually restart the OpenText Software Delivery Management server:

- Linux: `systemctl restart octane`
- Windows: `service octane restart`

The service runs in the background.

### "I cannot log into OpenText Software Delivery Management because ports are closed."

By default, the OpenText Software Delivery Management server uses port 8080 or port 8443 (secure). The port must be opened in the firewall for incoming traffic.

Linux:

Windows: Check your Windows Firewall settings to ensure the ports are open.

### "I am unexpectedly logged out."

Typically, a user is logged out of OpenText Software Delivery Management only after session timeout. If, however, you are unexpectedly logged out while actively working in OpenText Software Delivery Management, you may need to clear cookies before you can log in again.

To prevent an unexpected logout:

- When working with a local DNS, make sure that you access OpenText Software Delivery Management only with a fully-qualified machine name, together with the machine's domain.

  Example: `http://myserver-123545.domain.com:8080/`

### "JVM does not load."

If JVM fails to load after the octane service is started, check that Java is properly installed and that `JAVA_HOME` is configured correctly.

The wrapper.log file shows the following error message:

- Linux: /opt/octane/log/wrapper.log
- Windows: C:\Program Files\octane\log\wrapper.log

    ERROR  | wrapper  | JVM exited while loading the application.
    INFO   | jvm 1    | Unrecognized VM option 'UseCompressedClassPointers'
    INFO   | jvm 1    | Error: Could not create the Java Virtual Machine.
    INFO   | jvm 1    | Error: A fatal exception has occurred. Program will exit.

To identify the important parameters of the system that may affect the installation, run the following commands (Linux).

To get... | Command
--- | ---
Java information | `java -XshowSettings:properties -version`
All installed Java applications | `find / -name java`
All installed Java versions | `find / -name java -exec {} a \;`
The JAVA_HOME property | `echo $JAVA_HOME`
The PATH property | `echo $PATH`

### "Application server address shows port 8080 even when changed."

By default, the installation uses port 8080 for HTTP or port 8443 for HTTPS (SSL). If you change the port to a non-default value after the initial installation phase, the site Servers tab shows:

- The original application server address still displays as port 8080.

- The server state is inaccessible even though the server is accessible.

### "Failure to create SA schema due to nonexistent TableSpace or TempTableSpace."

If errors occur during site schema creation, and the site.log file contains a message indicating that a certain tablespace or a temporary tablespace does not exist, check that the specified TableSpace or TempTableSpace is correct.

### "When initializing, the OpenText Software Delivery Management installation failed with a site schema problem."

If you receive a site schema error, such as "Cannot upgrade SA. SA schema version must be lower than the current server version," do the following:

1. Open a backup copy of the site schema.

2. Fix the problem.

3. Restart the server:

   - Linux: Run `systemctl restart octane` again.
   - Windows: Run `initserver.bat` again.

### "The wrapper.log has Java-related warnings (Linux)"

After installing or upgrading, the following warning appears in the /opt/octane/log/wrapper.log file.

    INFO   | jvm 1    | 2017/06/27 17:20:56.318 | Caused by: java.net.UnknownHostException: <…some host name…> unknown error

To eliminate this warning:

1. Add the OpenText Software Delivery Management server to the /etc/hosts file.

   Example: For non-dynamic IPs, you can add the server in this format:

   `<ip_of_machine> <name_of_machine> localhost`

   Such as: 192.168.0.185 machine-72 localhost

2. Restart the OpenText Software Delivery Management server. For details, see Start the server manually.

### "My FILL_EXISTING installation failed, indicating that I have extra tables, view, indexes, and so on."

Check if your DBA made manual additions to the database schema, such as adding tables, indexes, and so on. If the installation encounters objects that it does not expect in the database schema, the installation can fail.

To avoid this, create exception files. For details, see Using exception files for manual database changes.

If you still have problems:

- Check that the parameters in the octane.conf file and the exception files have been entered correctly.

- Check the wrapper.log for errors.

  - Linux: /opt/octane/log/wrapper.log
  - Windows: C:\Program Files\octane\log\wrapper.log

### OpenText Software Delivery Management cannot fetch Jetty files (Linux)

The conscript library allows you to enable HTTP/2 in Jetty. Sometimes, however, using the conscript library causes issues. To resolve these issues, disable the conscript library and switch back to native Java SSL. For instructions, see knowledge base article KM03310408.

### Exception thrown when creating a space (Linux)

Under heavy loads, OpenText Software Delivery Management can use more threads than allocated for the octane service by Linux. In this case the admin needs to check the settings for the maximum number of threads for OpenText Software Delivery Management, and compare it with the current number of used threads.

The maximum number is stored in the file /sys/fs/cgroup/pids/system.slice/octane.service/pids.max.

The current number of threads is stored in the file /sys/fs/cgroup/pids/system.slice/octane.service/pids.current.

If the current number is approaching the maximum, increase the number of maximum threads using the command:

`systemctl set-property octane.service TasksMax=<new maximum number>`

Restart the octane service after this change.

Note: For some Linux variants these locations and commands may be different. The system administrator should handle this process.

(missing snippet link)

### See also

- Management

https://admhelp.microfocus.com Software Delivery Management 8942
Tips to improve your search results... OpenText™ Software Delivery Management Help Center OpenText™ Software Delivery Management Help 26.3 All View Local Help Center View Online Help Center Version: