- Overview
- Product Documentation
- CML Release Notes
- CML 2.2 Installation Guide
- CML 2.2 User Guide
- CML User's Guide
- Overview of CML 2.x
- Using CML and the HTML5 UI
- Dashboard
- Workbench
- Adding Nodes to a Lab
- Starting, Stopping, and Wiping Nodes
- Deleting Nodes
- Creating Links
- Rules for Creating Links and Interface Overprovisioning
- Adding Interfaces and Overprovisioning
- Overprovisioning Interfaces with Link Creation
- Starting Simulations
- Connecting to a Node's Console
- Changing Global Console Settings
- Download the Console History
- Setting CPU limit on node
- Launch sequencing and CPU limiting
- Stopping Simulations
- External Connectivity for Simulations
- Link Packet Capture
- Lab Sharing
- Breakout Tool
- Custom VM Images
- Creating a New Node Definition
- CML 2.2 Admin Guide
- Resources
Copy the Refplat ISO to Disk¶
This process is required for CML bare metal deployments but optional for CML VM deployments.
When CML is deployed as a VM, it is common to mount the refplat ISO file as a CD/DVD device. If your CML server has sufficient disk space, you may choose to copy the contents of the refplat ISO file to the CML server’s disk.
Unlike with a CML VM deployment, it is normally neither simple nor practical to mount the refplat ISO file remotely as a DVD drive on a bare metal server. The reliability and slow copy speeds associated with a mounted ISO image will cause problems under production use of a CML bare metal instance. Using an actual, physical DVD disc for the reference platform images not supported because it also provides unacceptably slow performance. The supported approach for CML bare metal deployments is to copy the reference platform images from the refplat ISO to the CML server’s local disk before users start running any labs.
Note that the copy process requires that all labs on your CML server are stopped and wiped. Therefore, it is best to copy the reference platform images to disk as soon as you finish the initial installation steps. Once the copy process completes, it will “eject” or unmount the refplat ISO and then restart the services on the CML server. Ensure that no one is trying to use the CML server while the script is running.
Your CML server should be running and should have the refplat ISO mounted as a CD/DVD drive.
Log into the System Administration Cockpit by following the Logging into the System Administration Cockpit instructions.
In the System Administration Cockpit, click Terminal in the navigation bar on the left side of the page and enter this command:
sudo sed -i 's/ahvz/ahvzX/' /usr/share/cockpit/virl2/copy-refplat-iso-to-disk.sh
This step is necessary to work around a known issue in CML 2.2.1.
In the System Administration Cockpit, click CML2 in the navigation bar on the left side of the page and expand the Copy Refplat ISO item in the Maintenance section.
Click the Copy Refplat ISO button.
Depending on the network and disk speeds, it can take several minutes to a couple of hours to copy the entire contents of the refplat ISO to your CML server’s disk.
It is safe to restart the copy process if it fails or is stopped. It will avoid overwriting files and will intelligently resume copying a partially-copied qcow2 file.
The copy process will fail if there are any labs running on the CML server, if the refplat ISO is not mounted as a CD/DVD drive, or if there is insufficient space on the CML server for the contents of the refplat ISO image.
The copy process can also fail if the remote CD/DVD drive connection is unreliable. If the copy process fails when using the refplat ISO as a mounted CD/DVD drive, you may instead copy the refplat ISO file to the CML server.
Unmount or disable the CD/DVD drive that was using the refplat ISO file.
Enable the
sshdservice for the CML server via the Services page in the System Administration Cockpit.Use
scpto copy the refplat ISO file to the following location on the CML server: /opt/refplat_images.iso.Restart the controller services via the CML2 page in the System Administration Cockpit.
Finally, re-run the Copy Refplat ISO again. This time, the process will use the /opt/refplat_images.iso file that’s already on the CML server as the source of the VM images.
Once the Copy Refplat ISO proceess succedes, you may delete the /opt/refplat_images.iso file.
The node definitions and image definitions from the refplat ISO have been copied to your CML server. Your CML server no longer needs to have the refplat ISO iamge mounted as a CD/DVD drive. Your CML server is now ready to run simulations.