Quick Start Install Documentation!

Full documentation can be found here: Netskope Cloud Exchange

Prerequisites

• Linux System capable of supporting docker.io release of docker, and docker-compose
• Miniumum Requirements Below:
  • 2 vCPU
  • 4 GB of Memory
  • 20 GB of storage
• Please see full documentation for scale numbers.

Install Procedure

1. Clone repository to volume with requisite 20 GB of storage
   a. mkdir netskope
   b. cd netsokpe
   c. git clone https://github.com/netskopeoss/ta_cloud_exchange
   
2. Set directory permissions
   a. cd ta_cloud_exchange
   b.sudo chown -R 1001:1001 data/mongo-data
   c. chmod 775 data/custom_plugins
   
3. (Recommended / Optional): enable ssl / https
   a. edit docker-compose.yml file to change the following:

   ui:
     ports:
       - 80:3000
   

   to

   ui: 
     ports:
       - 443:3000
   

   b. create self signed certificate - or use personal certificates
   openssl req -x509 -newkey rsa:4096 -keyout data/ssl_certs/cte_cert_key.key -out data/ssl_certs/cte_cert.crt -sha256 -days 365 -nodes -subj '/CN=localhost'
4. Launch Cloud Exchange 3
   a. sudo docker-compose --compatibility up -d
   
5. Open Browser to http(s)://<host ip address>
   

Troubleshooting

If bad gateway is received when you try to login:

• Check if step 2 was done correctly: ls -lash data

4.0K drwxrwxr-x 6 ubuntu ubuntu 4.0K Sep  9 08:53
4.0K drwxrwxr-x 3 ubuntu ubuntu 4.0K Nov  1 18:47 
4.0K drwxrwxr-x 3 ubuntu ubuntu 4.0K Sep 29 12:31 custom_plugins
4.0K drwxrwxr-x 3 1001 1001 4.0K Sep 29 12:37 mongo-data
4.0K drwxrwxr-x 2 ubuntu ubuntu 4.0K Sep  9 08:53 rabbitmq
4.0K drwxrwxr-x 2 ubuntu ubuntu 4.0K Sep 10 14:49 ssl_certs

Note the mask on line with custom_plugins - mask should be 775
Note ownership of mongo-data - should represent 1001:1001