FAQ


Overview

The lab machines have had their operating system upgraded and we are no longer using Windows 7. We are dual booting CentOs (Linux) & Windows 10.

Note, when switching from Windows to Linux you need to shut down the computer and not press restart. If you don’t do a full power cycle the Linux mount will not recognize the network.

Please be careful that if windows needs and update and you hit restart and update then you need to immediately loginto the windows partition again to install the update and not run Linux.

  • When you turn on the computers you are given a menu with 4 options. You select either the first item for Linux or the fourth item for windows.
  • Regardless of which system you select you login with your CCT Credentials. ## Linux * Once you login once on the machine it will remember your user name. If your name is not listed then press Not listed?:
  • Enter your username and password:

Windows

  • Once you login once on the machine it will remember your user name. If your name isn’t listed then press pGina and enter your username (no @cct.lsu.edu) and password with your CCT credentials:

Linux Software

  • Firefox
  • Houdini 16.0671
  • Mari 3.2v1 (you must run by command line. Press the windows button on the keyboard. Type in terminal and press enter. Type in cd /opt/Mari3.2v1 and press enter. Type in ./mari and select a project directory and begin)
  • Maya 2017 (we will update to 2018 when available)
  • Nuke 11.0v1
  • Substance Designer 2017.1.2
  • Substance Painter 2017.2.0 (you must run by command line. Press the windows button on the keyboard. Type in terminal and press enter. Type in cd /opt/Allegorithmic/Substance_Painter and press enter. Type in ./Substance Painter and select a project directory and begin)
  • Unity 5.6.1 (If you get to the licensing screen enter the serial number for Unity Pro. Do not run the Personal Version as this is a violation of their TOS)

Windows 10 Software

  • Adobe After Effects CC 2017
  • Adobe Illustrator CC 2017
  • Adobe Photoshop CC 2017
  • Adobe Premiere Pro CC 2017
  • GameMaker 2.0.7.171 (you have to access it to Program Files X86)
  • Git bash
  • Google Chrome
  • Maya 2017 (2018 will be installed next semester when the Linux version is available)
  • RenderMan for Maya
  • Steam, Vivem & Oculus only installed on B computers (A computers have no HDMI port)
  • Sublime Text 3
  • Substance Designer 2017.1.2
  • Substance Painter 2017.1.2
  • ToonBoom Harmony Premium 14.0
  • Unreal 4.17.0 (run Epic Game Launcher)
  • Unity 5.6.3 (If you get to the licensing screen enter the serial number for Unity Pro. Do not run the Personal Version as this is a violation of their TOS)
  • Unity 2017 (If you get to the licensing screen enter the serial number for Unity Pro. Do not run the Personal Version as this is a violation of their TOS)
  • Visual Studio 2017
  • Zbrush 4R7

Email Etiquette

  1. Only discuss public matters. There is no such thing as privacy in an email.
  2. Don’t ‘email angry’. Email is not an effective forum for venting and is much better at summarizing. If an issue has arisen that causes anger, either meet in person or talk on the phone.
  3. Respond in a timely fashion. If you are not able to respond right away, please respond with a receipt and a timeframe of when you will respond. Not responding witin 24 - 48 hours is not acceptable.
  4. Refrain from sending one-liners. You can put No Reply Necessary at the top of an email if you don’t expect a response.
  5. Avoid using shortcuts, emoticons, jargon or slang.
  6. Keep it professional. Imagine your grandmother is being CC’d on the email.
  7. Be clear in your subject line.
  8. Don’t email more than one address per receipient. If you don’t know which they prefer, then ask.
  9. Keep it short and get to the point.
  10. Remember, the email you write is a reflection of you.

Lab Etiquette

  1. Make sure faculty television is turned off if you are the last person to leave the lab.
  2. Make sure the door is locked if you are the last person to leave the lab. The door is locked by the switch on the latch assembly on the side of the door.
  3. Please try and eat in the cafeteria area just outside the second floor staircase. If you absolutely have to eat in the lab because class is starting please dispose of your food garbage in the cafeteria area. We don’t want the lab to smell like food or attract critters.
  4. Log off of your computer and make sure that it goes into sleep mode. Please do not disable the sleep functions of the computer.

Accesing Tree From Off Campus

You can access the campus network drive tree from home using Cisco VPN. Please be aware that the tree servers at school are not backed up and if the discs get corrupted the data will be lost. Please be sure to have another backup for all important data for you projects.

Tree From Linux

  • Run your file browser and select Connect to Server on the left hand menu:
  • Enter smb://tree.cct.lsu.edu/dmae_students and press Connect.

Apple Mac

  • Go to Finder | GO | Connect To Server.
  • Add to Server Address: smb://tree.cct.lsu.edu/dmae_students. If it asks you to login please use your CCT credentials.
  • You are now connected to the campus network. Please be aware that all your internet traffic will be going through the school servers. You will have access to the tree drives and all the network access you enjoy on campus.

    PC Win 7

  • First connect to Cisco VPN using PC Remote Access
  • Right click on Computer in File Explorer and select Map network drive.
  • Pick a drive letter that is not used and in folder type \\tree.cct.lsu.edu\dmae_students
  • Press Finish and then you can make an alias of the drive on your desktop or pin it to your tool bar.
  • You are now connected to the campus network. Please be aware that all your internet traffic will be going through the school servers. You will have access to the tree drives and all the network access you enjoy on campus.

    PC Win 10

  • First connect to Cisco VPN using PC Remote Access
  • Open File Explorer and press This PC on the left-hand menu and Computer in the top menu. This will bring up the button Map network drive. Press this button:
  • Enter \\tree.cct.lsu.edu\dmae_students, select an open drive (I have selected Z) and press **Finish.
  • You should now have the drive mounted:

Installing GameMaker Off Campus

  1. Download GameMaker Studio II from tree://dmae_students/software/GameMaker/
  2. Install either the PC or Mac version.
  3. Email maubanel@cct.lsu.edu if you do not have a login and password to enter when running the software.

Installing Harmony ToonBoom Off Campus

  1. If you have not installed the VPN, please go to PC Remote Access or Mac Remote Access to install and run the VPN.
  2. Download ToonBoom premium from their website.
  3. When the free version expires select the license server option and enter for server-info: desn-licsrv.lsu.edu at port: 27001

Installing Maya Off Campus

  1. If you have not installed the VPN, please go to PC Remote Access or Mac Remote Access to install and run the VPN.
  2. Connect to Cisco VPN with your CCT login credentials.
  3. Connect to the tree drive (look at Access to Tree link above).
  4. Download Maya from the Maya2017 folder for your system, both the PC and Mac version are included.
  5. Unzip (if necessary) and install Maya. It will ask you whether you have a license key or license server, select the Single License Server option.
  6. If you need to enter the license server click on this license server link

Accessing Nuke, Modo or Mari Off Campus

If you have not installed the VPN, please go to PC Remote Access or Mac Remote Access to install and run the VPN.

  1. Connect to Cisco VPN with your CCT login credentials.
  2. If you have Nuke installed and running skip to step 5 otherwise proceed to step 3.
  3. Download the latest version of Nuke, Modo or Mari installed in your computer. You can find it on the server at school //tree/dmae_students/software/nuke. Please use these copies so we are all on the same version.
  4. Install the software.
  5. Run the software. You should have a free trial version for a couple of months.
  6. Once your trial version runs out contact connect to the license server link You can also run your personal laptop version of Nuke on campus and follow the above instructions without logging into the VPN.

Batch rendering in Maya 17

If you need to batch render with Render Man you can use the license server. If you have not installed the VPN, please go to PC Remote Access or Mac Remote Access to install and run the VPN.

  1. Connect to Cisco VPN with your CCT login credentials if you are out of the campus. Otherwise go directly to step 2.
  2. Point the software to use the license server link

Accessing Houdini Off Campus

  1. Connect to Cisco VPN with your CCT login credentials if you are out of the campus. Otherwise go directly to step 2.
  2. Download Houdini from Side FX.
  3. Run it and change the license server link.

Accessing Substance Off Campus

  • Download the Substance software you need from tree/dmae_students/software/substance from our Tree server at LSU.
  • Download the key that comes with the key file (for example license-Substance Designer.key for the software).
  • When running the software for the first time, You will get an error in the Activation Wizard. It will say Your current license file is invalid. Select Activate using a license file
  • Select the associated key file
  • Click on the next button, install the key and you should see a license message like:
  • Now each time you run the software it should load with the associated key (you only should need to do this once).

Accessing Unity or Unreal Off Campus

Accessing ZBrush Off Campus

  1. Connect to Cisco VPN with your CCT login credentials if you are out of the campus. Otherwise go directly to step 2.
  2. Download ZBrush installer from tree://dmae_students/software/zbrush. It is available only for Mac & PC.
  3. Copy license file (.lic) and place it in the /Licenses folder
  4. Copy the .dll (pc) or .lib (mac) file into the /ZData/Zplugs/RLM and /Zdata/Zplugs64/RLM
  5. Run zBrush
  • Request an account by emailing Marc Aubanel at maubanel@cct.lsu.edu.

    Logging in to Plurlasight

    1. Log in to Plurasight and click on Sign In.
    2. Sign in with your Pluralsight username and password.

Gnomon

  1. You can access Gnomon through: LSU DMAE GNOMON.
  2. Please remember to log out when you are finished, we only have a single seat for now.

Registering with CCT GIT

CCT has a private GIT repository. I suggest you get comfortable using command line with GIT. The advantages far outweigh the disadvantages and it is worth learning. For text editing be careful to use an editor that DOES NOT add meta data to the file. The program recommends Sublime Text (free to use) but there are many other popular choices. You do not need to use the Cisco VPN to access GIT off campus and can access it from anywhere with an internet connection with a valid SSH key.

  • Go to CCT GIT
  • Register yourself by creating a new account. Add your Name Username email and password. Please use your real name and not an alias or nickname.
  • All traffic is governed using an SSH key. You need to generate an SSH key that then gets stored in a hidden folder on your harddrive. I suggest using the same key on all computers to fascilitate administration on your part.
  • On a Mac, go to Finder, choose Utilities from the Go menu. Find the Terminal application in the Utilities window. Double-click the Terminal application. Enter the following command: ssh-keygen -t rsa. Press the ENTER key to accept the default location and name. Type in a passphrase, then enter a second time to confirm.
  • On a PC, go to Git Bash (go to git and install git bash) and enter ssh-keygen -t rsa. Press the ENTER key to accept the default location and name. Type in a passphrase, then enter a second time to confirm.
  • Copy and paste the entire contents of the id_rsa.pub key (using a standard text editor, preferably sublime text) into https://git.cct.lsu.edu/profile/keys the Key box. It should look something like this:
  • Press Add Key, and you should be set to go.
  • You can access the CCT git repository at git.cct.lsu.edu.All the projects that you are a part of will be listed on the Front Page.

PC Password

  1. If you are tired of entering your SSH password everytime in Git Bash you pull or push the repository, you can set it up so it remembers the password until you log off or reboot.
  2. Open Git Bash and go to the directory with the repository you want to use.
  3. Type
    eval `ssh-agent -s`
  4. then press enter (be careful of the special characters after eval).
  5. Then type
    ssh-add
  6. and enter your ssh password.
  7. Now you should be good for a set amount of time without having to re-enter the password every time.

Line Endings

Since Unix/Mac OSX and Windows have different line endings, it is good to make sure that the database doesn’t update every time a different os is used. Git defaults to this being an unresolved conflict. For more detailed information go to github help.

  1. You need to change the core.autocrlf = true on PC and core.autocrlf = input on unix/mac.
  2. On Windows you need to enter: git config --global core.autocrlf true
  3. On Unix/Mac: git config --global core.autocrlf input

Cloning

  1. Create a GIT repository on your computer by cloning an existing project. If you are starting from scratch follow the directions when creating a New Project on the website.
  2. Otherwise you need to clone a git repository by cutting and paste project site from the website and replace above git@git.cct link with the one of the desired project. Please note that this will create a new directory with the one used for the project.
    • git clone git@git.cct.lsu.edu:maubanel/sample.lsu.edu.git
  3. If you want to use your own you can create the project inside an empty existing directory using:
    • git clone git@git.cct.lsu.edu:maubanel/sample.lsu.edu.git .

Normal Workflow

  • git pull origin <remote> <branch>     (shortcut for git fetch <remote> and git merge current branch)
  • git add -A
  • git commit -m     (Detailed message of small atomic change)
  • git push <remote> <branch>
  • git remote show <remote>     shows what branches your pull and push without remote and branch will default to

Branches

Available Branches

  • git branch     (for local)
  • git branch -r     (for server)
  • git branch --all     (for local and server)

Create Branch

  • git branch <branch name>
  • git branch -m <branch name>        (Creates a branch and checks out new branch)

Rename Branch

  • git branch -m <new branch name>         (if on the same branch)
  • git branch -m <old branch name> <new branch name>         (if on a different branch)

Delete Branch Locally

  • git branch -d <branch name>         (only deletes branch if there is no work)
  • git branch -D <branch name>         (Deletes branch and throws away all the work)

Delete Branch On Server

  • git push origin :<branch name>

Get Remote Branches

To change to a branch that is not locally on your computer you need to fetch the latest data for all branches on the remote repository. This will copy all the latest commits and branches from the server that you don’t have locally.

  • git fetch <remote>     (< remote > defaults to origin)

Change Branches

  • git checkout <branch name>

Merge

  • git merge <branch name> --no-ff     (No fast-forward, preserves complete history)
  • git branch --merged     (checks to see if branch is merged)
  • git branch --nomerged     (checks to see if branch is not merged)
  • git branch -v     branch with commit message and hash reference
  • git branch --merged or git-branch --no-merged     show which branches are merged or not merged to working branch

Merge Conflicts

  • git checkout --theirs <filename>     (Take the server version (deletes local) of the file in the conflict if you cannot resolve with say a binary file for example)
  • git checkout --ours <filename>     (Take the local version (replaces server) of the file in the conflict if you cannot resolve with say a binary file for example)

Deleted by User and Changed on Server, and you still want the file deleted

  • git rm <filename>

Deleted by Server and changed by User and you don’t want the file deleted

  • git add <filename>

Mergetool

If you have a Mergetool like kdiff3 set up

  • git mergetool     (to launch mergetool to resolve any conflicts)

Changes

Diff

Find out what in your working directory, or staging area has changed.

  • git diff <filename>     (if no filename all changes will be shown)
  • <filename>git diff --patience <filename>     (–patience provides more readable diff but takes longer to render)
  • git diff --histogram <filename>     (–histogram is compromise)
  • git diff --staged     (checks the differences in the staged area)

Ammend Commit

  • git commit --amend (ammends new staged files and creates new commit message)
  • git commit --amend --no-edit    (amends staged files and uses same message as existing commit)
  • This only works on a local commit. If you pushed to a server and you want to amend both the local and server follow the above steps and then:
  • Rewind to commit before conflicting
  • git reset --soft HEAD~1
  • Pull the remote version
  • git pull
  • Add the new commit on top
  • git add .
  • git commit -m "message"
  • git push

Delete Local Changes

Sometimes not all work is worth saving. You often try something out to decide that you do not want to pursue this task anymore. For a single file or two you can just checkout from the previous commit. This is not saved or tracked so use sparingly. You will lose this work though and it won’t be tracked. So say you want to revert to your last commit on file1.txt you would type:

  • git checkout file1.txt To remove multiple files without checking them out. This removes all of your changes without saving history (be careful this is not saved):
  • git reset --hard If you want to undo the last commit but keep the items in the staging area (uncommitting the changes). Your changes are still there but they are not commited. This way you can make the changes you need then commit your work.
  • git reset --soft HEAD~1 If you want to clean up stray files that you don’t want to add you can use. The -n switch will show you what it will do and the -f switch will do what it says in the -n switch.
  • git clean -n
  • git clean -f

Move Changes to New Branch

If you are working on the wrong branch there is an easy way to stash your changes and have them pop back on a new branch. You can only stash what you have staged with a git add:

  • git stash
  • git checkout <branch>
  • git stash pop
  • git stash list     lists all stashed work

Squash merges

If you want to combine multiple merges into one (sometimes when there are conflicts it creates extraneous commits):

  • git rebase -i HEAD~6         (or any previous number)

Cherry Pick from Other Branches

If you want to pick out individual commits from a branch

  • git cherry-pick <git hash>

Working with Remotes

Getting Data from Remote

Reminder that < remote > defaults to origin.

  • git fetch <remote>
  • git remote show <remote>

Pull Single File From Remote Master Branch

  • git checkout <remote>/<branch> -- path/to/file

Show Changes

  • git show head shows the last commit and all changes
  • git show HEAD~1 shows the second to last commit and all changes

.gitingore

If there are files on the server that are in your .gitignore file, you will need to remove them from the server with:

  • git rm -r --cached .
  • git add .
  • git commit -m 'Fixed untracked files in .gitignore'

Tags

Tag commits with a stable version number or name

  • git tag <version/name of tag> ligth weight tag
  • git tag -a “VERSION#/NAMEOFTAG” -m “ENTER MESSAGE” annotated tag Push tag to remote repository
  • git push --tags

VI Editor

Sometimes when git merges, it ends up sending you to the VI editor to record a message. If so the commands are:

  • i         (to go into insert mode to edit text)
  • esc         (to leave insert mode, so you can save and exit)
  • :x         (to save and exit)
  • :q!        (to exit and ignore changes)

Mac Terminal Shortcuts

  • command k        (to clear window as ‘clear’ doesn’t work as it comes back with next git command)

Logging

To find out where the project is at and whom has done what:

  • git log --all --format='%aN' | sort -u         (to list all contributors)
  • git log --oneline         (to show a list of all pushes with just the comments)
  • git lg --author=<name>         (to show a log of all commits from a single author)
  • git lg --author=“<name>” --since“1 week”         (time limited log of commits from a single author)
  • git shortlog -sne        (shows total number of commits from entire Terminal)