Mend for Bitbucket Data Center - Prerequisites
General Requirements
Note: Setting up global configuration is highly recommended for centralized mass deployments.
The following requirements must be accommodated before installing the Mend server software.
Access to a working Mend Application and a user with Admin privileges (either Organization or Product Admin).
A Bitbucket version between 5.15.X and 9.X is installed.
Admin privileges on the Bitbucket instance
Bitbucket online editor needs to be enabled to allow the creation of the configuration file (either the .whitesource or the .mend file, depending on which agent version you are using).
Setting: feature.file.editor=true
The deployment includes two environments:
Build environment where the image is built.
Deployment environment where the image is deployed.
The build environment can be the same one as the deployment environment on which the relevant Mend Docker images will be deployed.
For both build and target environments arm64 is not supported.
Build Environment
This build environment can be the same one as the deployment environment on which the Mend Docker image is deployed. It requires the following:
Hardware Requirements
CPU: Dual-Core, 2Ghz or higher (Intel or AMD)
RAM: 16GB
Storage: 100GB minimum; depending on maximum repository size and complexity
Environment Requirements
An internet connection for the entire duration of the build procedure.
When using a Container Orchestration Platform (i.e Kubernetes, ECS, Rancher etc.), please make sure you have logs collection in place: ELK, Splunk or similar. If you are not using an Orchestration platform for the containers, the logs will be collected in designated folders.
A user with admin privileges: If the operating system is Windows, then you must have administrative privileges. If the operating system is Linux, then you must have root privileges.
Docker server version 18 and above. You can verify the Docker version by entering the following:
docker –versionSoftware and files delivered by mend:
Mend Docker distribution artifacts that are delivered as a tar.gz or zip file (For example, agent-4-bitbucket-19.2.1.tar.gz or agent-4-bitbucket-19.2.1.zip).
For users of Bitbucket Data Center Version 9.X:
Download the latest version with this link (supports Bitbucket Data Center V9.X).
For users of earlier Bitbucket Data Center Versions:
Target Environment
The image is installed on the target environment. This environment requires the following:
Hardware Requirements
CPU: Dual Core, 2Ghz or higher (Intel or AMD)
RAM: 16GB
Storage: 100GB minimum; depending on maximum repository size and complexity
Environment Requirements
A user with admin privileges: If the operating system is Windows, then you must have administrative privileges. If the operating system is Linux, then you must have root privileges.
Docker server version 18 and above. You can verify the Docker version by entering the following:
docker –versionPort 5678 must be open at all times. This port will be used to receive webhooks from the Bitbucket add-on.
Access to the Mend Application is required at times for the operation of the Mend for Bitbucket Data Center.
The access to the app can be checked by issuing an HTTP GET request using a web browser or a utility (e.g., cURL, wget):
https://<your-base-url>/healthCheck
(e.g., https://saas.whitesourcesoftware.com/healthCheck)
It is recommended to verify that the returned status is 200 (OK).
This is only a validation URL. Access must be open for all paths and endpoints under the app’s subdomain.
If a proxy server is available, then the following proxy settings need to be obtained:
URL
Port number
Username and password (for authenticated access)
A valid SSL certificate and KeyStore containing the certificate.