Best practices cookbook when doing a new DevTest installation and verifying just out of the box, with Derby and ACL.
Condensed listing of the important points to be concerned with when doing a new DevTest installation. Should always follow the installation procedures in our online documentation.
All supported DevTest Releases and Platforms.
- Read online documentation Release Notes
- Make sure you have a valid license. The file-based license is valid for one year from the date of issue and will be renewed automatically as long as your support contract is up to date. The license file is sent to an email address associated with the license for your company, so if you are not sure who should be getting it, please call Broadcom Support at 1-800-225-5224.
- Make sure you have downloaded the right version of the software.
- Read online documentation Installing section. Verify all System Requirements to make sure you have the recommended memory and space requirements.
- Decide whether this is going to be an upgrade in place (installing in the same folder as previous release) or a completely new install. If you are going to use the same database from a previous version with the new version (as long as it is not before DevTest 9.0) , backup the database first, so if you have any problems you have a backup to go to. DO NOT copy the data in the database from a previous version to your new tables. If you need to keep the previous data let DevTest upgrade the schema to use with the new version.
- Before doing an install, especially on UNIX or Linux, make sure you have enough space on the target machine. The installer will unpack the files to the /tmp folder and if not big enough could get the following error: java.io.IOException: No space left on device.
- Install the software. Follow the install wizard. The license file is only associated with the Enterprise Dashboard and will be prompted for only when installing a new Enterprise Dashboard. You only need 1 license file, it can be used on multiple machines unless you a a new customer with DevTest or a renewal, then you will need a separate license file for each new Enterprise Dashboard since it is tied to MAC address.
- Once the software is installed, DO NOT copy previous version local.properties, site.properties, dradis.properties, logging.properties or lisa.properties files to your new install.
- If you need to change a property to a different value than what is delivered in lisa.properties, update the local.properties or site.properties files. These are delivered as templates, so copy _local.properties to local.properties and _site.properties to site.properties, etc. The lisa.properties file should never be modified. You can then add the previous properties in your earlier version to the properties file in the new version. Some of th
- Properties files are evaluated in the following order:
- site.properties take precedence over lisa.properties
- local.properties takes precedence over site.properties and lisa.properties
- Command line and vmoptions files takes precedence over all properties defined in any of the properties files.
Note: dradis.properties is only used when configuring the Enterprise Dashboard to use an external database and/or setting keystore information for using with the Enterprise Dashboard.
- Once the software is installed, DO NOT copy any earlier or later versions of a deliverable jar file to any of the folders.
- If you are installing your components on different machines, make the appropriate updates to point to the correct Enterprise Dashboard in the site.properties file for where the Registry is running and the correct Registry in the local.properties file for where each Coordinator, Simulator and VSE is running. The Broker must run on the same machine as the Registry. You may also make the appropriate property updates in the .vmoptions files instead of the .properties files.
- If you are using Derby, make sure the user that will start Enterprise Dashboard and Registry services, has the proper permissions on the $LISA_HOME/database folder.
- Always follow this order when starting the DevTest components:
- Identity Access Manager (mandatory starting with DevTest 10.4.0, IAM is used to maintain all users)
- Virtual Service Catalog
- Enterprise Dashboard
- These need be started after the Portal:
- Coordinator, then Simulator
- Verify all your DevTest components are up and running by:
- Supported versions:
- Bring up Identity Access Manager URL https://<hostname or IP>:51111 (only with 10.3.0 and later)
- Bring up Virtual Service Catalog URL https://<hostname or IP>:51110 (only with 10.3.0 and later)
- Bring up Enterprise Dashboard URL http://<hostname or IP>:1506
- Bring up Portal URL http://<hostname or IP>:1507/devtest
Always make sure you have enough space on the target machine you are installing to.
Always best to verify out of the box before adding in External Database and Security configurations.
Please open a new case with Broadcom Support if cannot verify with these documentation and these instructions.
When doing an installation that is distributed, put hostname and IP addresses into the hosts file so your computer does not have to ask a DNS server to translate the domain name into an IP number. This speeds up access to the host site you want to see because your computer no longer has to query other systems on the Internet for the address translation.**