Commit 7c1e4b9c authored by Mark Beierl's avatar Mark Beierl
Browse files

Removing deprecated instructions.

parent b7146946
Loading
Loading
Loading
Loading
+13 −68
Original line number Diff line number Diff line
@@ -32,92 +32,37 @@ Daily builds of branches ELEVEN, TEN, NINE and master can be installed by using

These builds include the latest community contributions and may contain bugs. Therefore they are only recommended for developers and contributors involved in community testing.

#### Release ELEVEN daily
#### LTS Releases

##### Release TWELVE daily

```bash
wget http://osm-download.etsi.org/ftp/osm-11.0-eleven/install_osm.sh
wget http://osm-download.etsi.org/ftp/osm-12.0-twelve/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh -R ReleaseELEVEN-daily -t releaseeleven-daily -r testing -y
./install_osm.sh -R ReleaseTWELVE-daily -t releasetwelve-daily -r testing -y
```

#### Release TEN daily
##### Release TEN daily

```bash
wget http://osm-download.etsi.org/ftp/osm-10.0-ten/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh -R ReleaseTEN-daily -t releaseten-daily -r testing -y
```
#### Short Term Releases

#### Release NINE daily
##### `master` branch daily

```bash
wget https://osm-download.etsi.org/ftp/osm-9.0-seven/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh -R ReleaseNINE-daily -t releasenine-daily -r testing -y
```

#### `master` branch daily

```bash
wget http://osm-download.etsi.org/ftp/osm-11.0-eleven/install_osm.sh
wget https://osm.etsi.org/gitlab/osm/devops/-/raw/master/installers/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh -R testing-daily -t testing-daily -r testing -y
```

## Performing the tests

### Testing from OSM client sandbox (recommended)

For regular testing, it is highly recommended using a local OSM's tester sandbox as client to validate a given OSM build. Among other advantages, this sandbox provides all the relevant dependencies to make consistent testing, including Robot tests.

In order to create the sandbox locally, you can simply type:

```bash
git clone "https://osm.etsi.org/gerrit/osm/sandboxes"
cd osm-tests
# Use the templates in the `localconfig` folder to create the appropriate
# `localconfig/envconfig.rc` and, optionally, `localconfig/envprovisioning.sh`
# with the details of the DUT (i.e. the credentials of your local VIM environment
# and the IP address of your OSM build under test).
vagrant up
```

In case you needed to use the latest version of the OSM client (e.g. for testing non-stable builds), you can set the `OSM_CLIENT_VERSION` environment variable before creating the sandbox:
##### Release THIRTEEN daily

```bash
OSM_CLIENT_VERSION=master vagrant up
```

At the end of the build, here is the sandbox that Vagrant creates for you and the relation with the OSM build and your local VIM:

![Diagram of the functionality of the Sandbox](assets/image-20200406234414818.png)

Further details to customize it for your local setup (i.e. editing your `localconfig/envconfig.rc` and `localconfig/envprovisioning.sh`) can be found in the [README.md](https://osm.etsi.org/gitweb/?p=osm/sandboxes.git;a=blob_plain;f=osm-tests/README.md;h=39ed9366aee3347b8f48a8ace42431df4a776b41;hb=HEAD) file included in the same folder.

### Testing from inside an OSM build

For casual testing you can choose to log into the OSM build and launching some tests locally. Although this is discouraged for consistent community validations or automated testing, it is feasible for an informal validation.

## (OLD) ANNEX: How to clean a prior OSM installation (not recommended for community testing)

**This procedure is highly discouraged for community testing.** Unless you are really sure about what you are doing, please use a clean Ubuntu VM instead.

```bash
# Removes previous data
docker stack rm osm
docker volume prune
# The above command removes the network too
docker network create --driver=overlay --attachable --opt com.docker.network.driver.mtu=<MTU size supported by Interface> netosm
docker stack deploy -c <location of docker-compose.yaml; default location is /etc/osm/docker/docker-compose.yaml> osm
# Optionally, you could have used the installer to uninstall OSM:
./install_osm.sh --uninstall
# Remove old dependencies
sudo apt-get remove -y osm-devops
sudo apt-get remove -y osm-imdocs
sudo apt-get remove -y python3-osmclient
sudo apt-get remove -y python3-osm-im
# Clean the previous repos that might exist
sudo sed -i "/osm-download.etsi.org/d" /etc/apt/sources.list
# Download the installer and install (no need of specifying a tag)
rm install_osm.sh
wget http://osm-download.etsi.org/ftp/osm-13.0-thirteen/install_osm.sh
chmod +x install_osm.sh
./install_osm.sh -R ReleaseTHIRTEEN-daily -t releasethirteen-daily -r testing -y
```