Administer the site (on-premises)
Here are instructions for managing the overall site, such as ALM Octane database servers, mail servers, and logs. This context is also for adding spaces and reviewing the history of modifications to spaces. On-premises site admins can manage the site from the Site area in Settings.
Site administration includes tasks such as managing ALM Octane database servers, mail servers, and logs.
The site context is also for adding spaces and reviewing the history of modifications to spaces.
On-premises site admins can manage the site from the Site area in Settings.
You can perform the following server management actions in Settings .
Click Site and then click the Servers tab.
|Refresh the status of the servers to test connectivity.||Click the relevant server, and then click .|
|Change log details.||
In the Application Logs area, click the log file name, change the Level and Max Size, and click Save.
|Change the database admin password.||In the Database Servers area, click the server name, change the Admin password, and click Save.|
|Change the mail server host name and port.||In the Mail Servers are, click the server name, change the Host name and Port, and click Save.|
Site admins can delete, activate, and deactivate users from the Site area in Settings. They can also assign other users the site admin role.
Space admins and workspace admins can also activate and deactivate users For details, see Activate or deactivate a user.
In Settings , click Site.
In the Users tab grid view, select the user who should also be a site admin.
Click to display the Roles column.
Select Site Admin in the Roles column for that user.
Note: Before deleting in ALM Octane, SaaS operators should delete the user from the system before deleting the user in ALM Octane.
In Settings , click Site.
In the Users grid, select a user.
In the toolbar, click and answer Yes to confirm.
On-premises: If your site is configured to erase all traces of the deleted user, the following appears.
Limitation: The ability to erase all traces of deleted users is not supported for SaaS.
We strongly recommend that you manage an external file that maps deleted ALM Octane users to reference codes.
Enter a reference code for the user from this external file.
Internally, references to the user are replaced by this reference code in ALM Octane.
If you do not enter a reference code, the user is not deleted.
For details on how to configure the site to erase deleted users' details, see the FORGET_USER_ON_DELETE configuration parameter under LOGIN_PAGE_NOTICE . Note that setting the value for this parameter only affects how users are deleted from this point forward. Setting this parameter to true does not erase the details of already-deleted users.
Tip: You can also delete multiple users using the REST API.
Site admins can view, add, and upgrade spaces (including monitoring background jobs) from the Site area in Settings.
For details about how the space admin manages spaces, see Manage spaces.
In Settings , select Site. See a list of spaces at the site, and select one to see its details.
Icons indicate if the space is shared or isolated .
While looking at the details, you can also see the history of changes made to the space. For details, see View an item's history.
In Settings , select Site.
To create a shared space, click .
To create an isolated space, click .
Name the space.
If the database at your site is managed by database administrators, and ALM Octane is not authorized to create its own schemas, check Use existing schema. Enter the name of the existing space schema to use, and its password.
Tip: You can create exception files to list any warnings to ignore when ALM Octane creates spaces using an existing schema. This is useful if the DBA manually added objects, such as tables, indexes, and so on, to the database schema. For details, see Using exception files for manual database changes.
Create workspaces and associate them with the space. For details, see Manage workspaces.
Add or remove space admins.
- In Settings , click Site, and then click the Spaces tab.
- In the Administrators column, click in the cell of the space you want to edit.
- From the list, select or remove admins for this space.
After upgrading from a previous ALM Octane version, check if any spaces must be upgraded. Upgrade these spaces using the instructions below.
In Settings , click Site, and then click the Spaces tab.
Select spaces and click Upgrade.
Upgrade is available only if a space needs to be upgraded.
Click Refresh to see the updated status for the spaces.
Review the statuses of the spaces.
The space retained its state from before the upgrade.
No action necessary.
The space is waiting to be sent for upgrade but the upgrade has not yet started. When the upgrade is actually in progress, the current step being processed is displayed. See the status Step # of #.
The number of spaces that can be upgraded concurrently is limited.
No action necessary.
Step # of #
As the upgrade progresses, the current step and operation are displayed.
No action necessary.
A recoverable error occurred.
Review the error and the logs. Display the Recovery guidelines field, and follow the instructions. Restart the upgrade.
An unrecoverable error occurred.
Restore schemas from the previous version. For details, see the ALM Octane Installation Guide.
The workspace name is a unique identifier within a space. ALM Octane adds a numeric suffix (_1, _2, and so on) to any upgraded workspaces with the same name. If necessary, ALM Octane truncates the last characters from workspace names longer than 255 characters before adding the suffix.
After upgrading, review the names of the workspaces. You can rename them if you want.
Background jobs include processes that run after upgrading a space, among other activities. A space is only fully upgraded after all background jobs have completed. Check periodically to see when an upgraded space is ready.
In Settings , click Site and then click the Spaces tab.
Select the shared space and click Background Jobs.
Note: Until all of the background jobs have completed, some data may be unavailable in trend graphs.
Site admins and space admins can set configuration parameters, such as parameters for setting the language, determining from where the Help Center opens, activating basic authentication, and so on:
In Settings (technical preview)
For details, see Set configuration parameters (technical preview).
Using the REST API
For details, see Setting configuration parameters with the REST API.
You can see information about each session that logged into ALM Octane. This includes:
The user ID that logged in
The type of access for the session (UI, API user, or API key)
The IP address used for the session
The duration of the session
To view sessions, click Site and then click the Servers tab.